Skip to content

riccardobonanomi/pyris3

Repository files navigation

README

PyRIS - Python RIvers by Satellite

Extract River Features from Landsat Multispectral Data

  • Contains: pyris (module), pyris (cli script)
  • Version 3.2.1 (development)
  • README updated 2024/04/24

Who do I talk to?

Repository branch description

  • the master branch contains the up-to-date working code
  • the original branch contains the original code converted to python 3

Version tracking

  • 1.0 (2018) by Federico Monegaglia -> PyRIS deployment
  • 3.0.0 (2022) by Riccardo Bonanomi -> Converted to python 3
  • 3.1.0 (2022) by Riccardo Bonanomi -> Added GEE mask analysis capability
  • 3.1.1 (2023/03/20) by Riccardo Bonanomi -> Added ability to skip masks when segmenting Landsat or importing GEE mask
  • 3.1.2 (2023/04/19) by Riccardo Bonanomi -> Added ability to draw black masks on gee mask
  • 3.1.3 (2024/01/18) by Riccardo Bonanomi -> Fixed bug in migration evaluation
  • 3.1.4 (2024/02/05) by Riccardo Bonanomi -> Added skipping capability of non .tif files in external masks
  • 3.1.5 (2024/02/13) by Riccardo Bonanomi -> Removed clean gee options
  • 3.2.0 (2024/02/13) by Riccardo Bonanomi -> Moved from gee to raw mask options
  • 3.2.1 (2024/04/23) by Riccardo Bonanomi -> Improved manual mask cleaning functionalities
  • 3.2.2 (2024/06/09) by Riccardo Bonanomi -> Fixed Landsat 8-9 bug, fixed axis-files bug, fixed bars bug

Fast guide

This is just a brief installation and usage guide, a more comprehensive documentation can be found in the PyRISmanual.pdf file at https://github.com/riccardobonanomi/pyris3/blob/main/PyRISmanual.pdf (note that it is still under development).

Install Instructions

On Unix/Linux

  1. Install pip: sudo apt-get install python-pip

  2. Install gdal (https://mothergeo-py.readthedocs.io/en/latest/development/how-to/gdal-ubuntu-pkg.html)

  3. Install dependencies for PyRIS: sudo pip install -r requirements.txt

  4. To install PyRIS from the pyris folder run: pip install .

On Windows - refer to the manual

Run Instruction

  • Call pyris from the command line: pyris [args]
  • 'pyris --help' provides information on the required arguments