SHClassify

Background

shclassify is a python library and CLI to run the SLS HRIS Land Cover Classification model.

The general approach is as follows:

1. load a set of observations
2. create a data frame to hold predictions (using the same index as the observations)
3. subset the observations to those belonging to the class at the highest level of the heirarchy which has not been predicted yet
4. calculate the class membership logits using using the model belonging to this class
5. transform the logits to probabilities
6. select the class (using the multinomial or binary heuristic)
7. update the data frame of predictions
8. repeat 2-6 until no observations have a predicted class for which there is another model to apply

Python

shclassify is only compatible with python3!

Installation

unzip shclassify.zip
# git clone
cd shclassify
virtualenv -p /path/to/python3 venv
. venv/bin/activate
pip install -e shclassify

It is reccommended to install into a virtual environment!

Usage

The CLI is the recommended usage

> shclassify --help                                                          [git][shclassify/.][masterU]
Usage: shclassify [OPTIONS] OBSERVATIONS_FILE

  Predict landcover class for 'OBSERVATIONS_FILE' using SLS HRIS model

Options:
  -d, --delim [,|\t|;]     field delimeter
  -i, --index-col INTEGER  index of column with observation IDs - 0 is first
                           column
  -c, --chunksize INTEGER  lines to read and predict at a time
  -v, --verbose
  -o, --outfile PATH       path to use for output (prediction) data
  --help                   Show this message and exit.

Troubleshooting

If you are having issues with the CLI, try running with verbose mode -v. Issues often arise from errors in, or mismatches between, data and model files.

Development

Installation for development requires some additional packages

pip isntall -e shclassify[develop]

To modify, create a feature branch, make the desired modification. Run the tests to check for regressions, and add tests to ensure new code works as expected and to protect the new code from regressions.

py.test ./tests

See http://pytest.org/latest/ for more details about testing.

Docs

Beyond the CLI, documentation can be found at docs/build/index.html. Advanced users may also refer to the source code.