Update installation instructions

docs/source/contributing.rst

@@ -77,11 +77,14 @@ Installing a Development Version
    ::
 
       pip install -r requirements.txt  # Installs basic requirements
+      pip install -r dev_requirements.txt  # Installs developer requirements
       pip install -r docs/docs_requirements.txt # Installs documentation requirements
-      pip install -r examples/examples_requirements.txt # Installs example requirements
       pip install -e .  # Installs SCICO from the current directory in editable mode
 
 
+   For installing dependencies related to the examples please see :ref:`example_notebooks`.
+
+
 9. The SCICO project uses the `black <https://black.readthedocs.io/en/stable/>`_,
    `isort <https://pypi.org/project/isort/>`_ and `pylint <https://pylint.pycqa.org/en/latest/>`_
    code formatting utilities. It is important to set up a `pre-commit hook <https://pre-commit.com>`_ to
@@ -399,3 +402,30 @@ and ``scico-data`` repositories must be updated and kept in sync.
    ::
 
       git submodule foreach --recursive 'git push' && git push
+
+
+Building Documentation
+----------------------
+
+A local copy of the documentation can be built from the respository root directory by doing
+
+::
+
+  python setup.py build_sphinx
+
+
+Alternatively:
+
+1. Navigate to the docs directory ``docs/``
+
+2. Install dependencies
+
+   ::
+
+      pip install -r docs_requirements.txt
+
+3. Build documentation
+
+   ::
+
+      make html

docs/source/examples.rst

@@ -6,6 +6,19 @@ Usage Examples
 .. toctree::
    :maxdepth: 1
 
+.. _example_dependencies:
+Example Dependencies
+------------------------
+
+Some examples may use additional dependecies. These dependencies are listed in `examples_requirements.txt <https://github.com/lanl/scico/blob/main/examples/examples_requirements.txt>`_.
+Pip should be used to install these extra requirements except astra which should be installed via conda:
+
+   ::
+
+      conda install -c astra-toolbox astra-toolbox
+      pip install -r examples/examples_requirements.txt # Installs other example requirements
+
+The dependencies can also be installed one by one as required.
 
 Organized by Application
 ------------------------

docs/source/install.rst

@@ -54,56 +54,18 @@ The instructions above install a CPU-only version of SCICO. To install a version
 
    ::
 
-      pip install --upgrade "jaxlib==0.1.70+cuda110" -f https://storage.googleapis.com/jax-releases/jax_releases.html
+      pip install --upgrade "jaxlib==0.1.75+cuda110" -f https://storage.googleapis.com/jax-releases/jax_releases.html
 
 
 
 Additional Dependencies
 -----------------------
 
-We use the `ASTRA Toolbox <https://www.astra-toolbox.com/>`_ for tomographic projectors. We currently require the development version of ASTRA, as suggested by the package maintainers.
-
-The development version of ASTRA can be installed using conda:
-
-::
-
-   conda install -c astra-toolbox/label/dev astra-toolbox
-
-Alternatively, it can be `built from source <https://www.astra-toolbox.com/docs/install.html#for-python>`_.
-
-We also support the `Super-Voxel Model-Based Iterative Reconstruction <https://svmbir.readthedocs.io/en/latest/>`_ package as an alternative tomographic projector. Since this package can be installed via ``pip``, it is
-included in the list of package dependencies (``requirements.txt``), and need
-not be separately installed.
+For installing dependencies related to the examples please see :ref:`example_notebooks`.
 
 
 For Developers
 --------------
 
 For installing a version of SCICO suitable for development,
 see the instructions in :ref:`scico_dev_contributing`.
-
-
-Building Documentation
-----------------------
-
-The documentation can be built from the respository root directory by doing
-
-::
-
-   python setup.py build_sphinx
-
-Alternatively:
-
-1. Navigate to the docs directory ``docs/``
-
-2. Install dependencies
-
-   ::
-
-      pip install -r docs_requirements.txt
-
-3. Build documentation
-
-   ::
-
-      make html

examples/README.rst

@@ -102,7 +102,7 @@ A number of files in this directory assist in the mangement of the usage example
 `examples_requirements.txt <examples_requirements.txt>`_
    Requirements file (as used by ``pip``) listing additional dependencies for running the usage example scripts.
 
-`notebooks_requirements.txt <examples_requirements.txt>`_
+`notebooks_requirements.txt <notebooks_requirements.txt>`_
    Requirements file (as used by ``pip``) listing additional dependencies for building the Jupyter notebooks from the usage example scripts.
 
 `makenotebooks.py <makenotebooks.py>`_

examples/examples_requirements.txt

@@ -1,4 +1,5 @@
 astra-toolbox
+cached_property
 colour_demosaicing
 xdesign
 ray[tune]