Changeset 2087 for trunk/docs/source/index.rst

Timestamp:

Dec 8, 2015 6:02:57 PM (8 years ago)

Author:

toby

Message:

change error handling if h5py not installed; add new condition variable to importers (self.UseReader?); changes to docs to reflect this and consolidate description of package requirements

File:

• trunk/docs/source/index.rst (modified) (1 diff)

trunk/docs/source/index.rst

@@ -32 +32 @@
 * NumPy (http://docs.scipy.org/doc/numpy/reference/), 
 * SciPy (http://docs.scipy.org/doc/scipy/reference/),
-* matplotlib (http://matplotlib.org/contents.html)  
-* PIL or Pillow (https://pillow.readthedocs.org) and 
+* matplotlib (http://matplotlib.org/contents.html)  and
 * PyOpenGL (http://pyopengl.sourceforge.net/documentation)
 
-These packages are not distributed as part of the Python standard
+Two packages are used by some parts of the code, but are not required:
+* PIL (http://www.pythonware.com/products/pil/) or Pillow (https://pillow.readthedocs.org). This is used to save
+  and read certain types of images.
+* h5py is the HDF5 support package. This is (not surprisingly) required
+  to import images from HDF5 files. If this library is not present,
+  the HDF5 importer(s) will not appear in the import menu and a
+  warning message appears on GSAS-II startup. 
+
+Note that the packages listed above are not distributed as part of the Python standard
 library and must be obtained separately (or in a bundled Python
-package such as the Enthought Python Distribution/Canopy or
-Continuum.io's anaconda).  The PyOpenGL package will be installed into
+package such as the Enthought Inc.'s Canopy or
+Continuum.io's anaconda; we also use the older Enthought Python
+Distribution).  
+One exception is the PyOpenGL package. This will be installed into
 Python by GSAS-II if not found, so it does not need to be included in
 the Python bundle, but the setuptools package