differences for PR #342

Author: actions-user

files/environment.yml

@@ -0,0 +1,11 @@
+name: dc-image
+channels:
+  - conda-forge
+dependencies:
+  - python>=3.11
+  - jupyterlab
+  - numpy
+  - matplotlib
+  - scikit-image
+  - ipympl
+  - imageio

md5sum.txt

@@ -17,5 +17,5 @@
 "learners/edge-detection.md" "fdbcee7436e104e6587e1cb40cd37d18" "site/built/edge-detection.md" "2023-08-16"
 "learners/prereqs.md" "7ca883d3d01d18c98ce7524ed297e56c" "site/built/prereqs.md" "2023-07-26"
 "learners/reference.md" "7ae9deea84007c6ed1339955ac23f4b7" "site/built/reference.md" "2023-04-26"
-"learners/setup.md" "7edbbef5b2cb020d40d88c9cb0dcd98f" "site/built/setup.md" "2023-12-19"
+"learners/setup.md" "c27b40d65c3c692479a010690dba0c38" "site/built/setup.md" "2025-04-06"
 "profiles/learner-profiles.md" "60b93493cf1da06dfd63255d73854461" "site/built/learner-profiles.md" "2023-04-25"

setup.md

@@ -7,7 +7,7 @@ Before joining the workshop or following the lesson, please complete the data an
 
 ## Data
 
-The example images used in this lesson are available on [FigShare](https://figshare.com/).
+The example images and a description of the Python environment used in this lesson are available on [FigShare](https://figshare.com/).
 To download the data, please visit [the dataset page for this workshop][figshare-data]
 and click the "Download all" button.
 Unzip the downloaded file, and save the contents as a folder  called `data` somewhere you will easily find it again,
@@ -16,30 +16,21 @@ e.g. your Desktop or a folder you have created for using in this workshop.
 
 ## Software
 
-1. Download and install the latest [Anaconda
-   distribution](https://www.anaconda.com/download/) for your
-   operating system. Make sure to choose the Python 3 version (as
-   opposed to the one with Python 2). If you wish to use an existing
-   installation, be sure to upgrade your scikit-image to at least 0.19.
-   You can upgrade to the latest scikit-image using the shell command that follows.
+1. Download and install the latest [MiniForge distribution of Python](https://conda-forge.org/download/) for your operating system. 
+   If you already have a Python 3 setup that you are happy with, you can continue to use that (we recommend that you make sure your Python version is current).
+   The next step assumes that `conda` is available to manage your Python environment.
+2. Setup an environment to work in during the lesson.
+   In a terminal (Linux/Mac) or the MiniForge Prompt application (Windows), navigate to the location where you saved the unzipped data for the lesson and run the following command:
 
-   :::::::::::::::::::::::::::::::::::::::::  callout
-
-   ## Updating scikit-image in an existing Anaconda distribution
-
-   ```shell
-   conda upgrade -y scikit-image
+   ```bash
+   conda env create -f environment.yml
    ```
 
-   ::::::::::::::::::::::::::::::::::::::::::::::::::
-
-2. This lesson uses Matplotlib features to display images, and some
-   interactive features will be valuable. To enable the interactive
-   tools in JupyterLab, the `ipympl` package is required. The package
-   can be installed with the command
+   If prompted, allow `conda` to install the required libraries.
+3. Activate the new environment you just created:
 
-   ```shell
-   conda install -c conda-forge ipympl
+   ```bash
+   conda activate dc-image
    ```
 
    :::::::::::::::::::::::::::::::::::::::::  callout
@@ -83,9 +74,9 @@ e.g. your Desktop or a folder you have created for using in this workshop.
 
    ## Instructions for Windows
 
-   Launch the Anaconda Prompt program and type `jupyter lab`.
+   Launch the MiniForge Prompt program and type `jupyter lab`.
    (Running this command on the standard Command Prompt will return an error:
-   `'conda' is not recognized as an internal or external command, operable program or batch file.`)
+   `'jupyter' is not recognized as an internal or external command, operable program or batch file.`)
 
 
    :::::::::::::::::::::::::