nuryahya/ulgdp-road-asset-processing-toolset

GP Python toolbox/toolset for Road Asset Data Processing as per GIS Application Manual for revised Urban Local Government Development Program (ULGDP) Asset Management Plan of Ethiopia. # ulgdp-road-asset-processing-toolset A Python toolbox for road asset processing as per ULGDP manual of Ethiopia ## Getting Started 1 - Clone this repo. 2 - Create an environment with the requirements. ``` > make env ``` 3 - Explore - If you are more into Python, a good place to start is `jupyter lab` from the root of the project, and look in the `./notebooks` directory. If GIS is more your schtick, open the project `./arcgis/ulgdp-road-asset-processing-toolset.aprx`. ## Using Make - common commands Based on the pattern provided in the Cookiecutter Data Science template by Driven Data this template streamlines a number of commands using the `make` command pattern. - `make env` - builds the Conda environment with all the name and dependencies from `environment_dev.yml` and installs the local project package `ulgdp_road_asset_processing_toolset` using the command `python -m pip install -e ./src/src/ulgdp_road_asset_processing_toolset` so you can easily test against the package as you are developing it. - `make env_clone` - designed for environments using the default Conda instance installed with ArcGIS Pro. It is similar to `make env`, except this command clones the `arcgispro-py3` environment. Otherwise, it still installs the packages listed in `environment_dev.yml` and installs the local package using `pip` as described above. - `make docs` - builds Sphinx docs based on files in `./docsrc/source` and places them in `./docs`. This enables easy publishing in the master branch in GitHub. - `make test` - activates the environment created by the `make env` or `make env_clone` and runs all the tests in the `./testing` directory using PyTest. Alternately, if you prefer to use TOX for testing (my preference), there is a `tox.ini` file included as well. The dependencies (`tox` and `tox-conda`) for using TOX are included in the default requirements. By default, the TOX file creates an environment from the `environment.yml` file using much fewer dependencies than t …