Troubleshooting

My script doesn’t run

Before filing a bug report, check these possible solutions:

Updating your python environment

Check the versions of python and the various package dependencies (especially Numpy) in the environment that you are using with conda list.

  • Is your python version more than 1 minor release out of date (e.g. 3.7 if the current version is 3.9)?

  • Has it been a year or more since your conda environment was created or updated?

It might be time for a fresh environment. SFRmaker mostly follows the Numpy guidelines for package support, which means that the two latest minor versions of Python (e.g. 3.9 and 3.8) and their associated Numpy versions will be supported.

Instructions for updating your conda environment

Updating SFRmaker

conda list can also be used to check if you SFRmaker is up to date.

  • if you installed SFRmaker from PyPI (e.g. pip install sfrmaker), the reported version should match the latest. Otherwise pip install --upgrade sfrmaker.

  • if you installed SFRmaker from PyPI and you need to incorporate a recently pushed bug fix, you might need to reinstall directly from GitHub (e.g. pip install --upgrade git+https://github.com/usgs/sfrmaker@develop)

  • if you cloned the SFRmaker source code and need to incorporate a recently pushed bug fix, you will need to pull (git pull) and possibly reinstall (pip install --upgrade -e . in the root folder of the source code).

  • in the latter two cases (sfrmaker installed from GitHub), the version reported by conda list should match the latest commit hash. For example version 0.8.0.post6+g91f0db4 for the commit hash starting with 91f0db4.