Warning

Documentation website under active development. This is not a stable release.

User Guide#

plans is open-source, cross-platform tool that is built on top of Python and some common dependencies, like NumPy, SciPy, Matplotlib, Pandas and Rasterio.

This means that plans can be run in any operational system, locally or remotely, as long as Python is installed.

Users are encouraged to run plans under interactive Python environments, like Jupyter or Colab notebooks. These platforms are very intuitive for beginners and remove the burden of setting Python environments.

See also

For those who want to contribute to plans, see Development

Installation#

On a Python environment, install plans via terminal:

python -m pip install git+https://github.com/iporepos/plans.git@main

On Jupyter or Colab, run this command on a cell:

%pip install git+https://github.com/iporepos/plans.git@main

This installation procedure is also enough for installing all dependencies needed for running plans.

Workflow#

The workflow of plans is based on the concept of project. That means that all input data required must be organized in a standard file system. Once all is set, users can run simulations without specifying entries all the time.

Typically, to run plans users may go through the following steps (with some iteration):

Setting up a project

  1. Gather input data. Collect observed and scenario data for an Area Of Interest (AOI).

  2. Pre-process input data. Files must fits into plans standards.

  3. Organize input data. plans expects data of the AOI to be organized in a Project (a standard file system).

Processing data

  1. Use plans for data assessments.

  2. Use plans for parameter estimation.

  3. Use plans for scenario simulation.

Post-processing

  1. Use extra tools for more visualization and analysis of output data.

Setup#

Projects#

A project in plans is a standard file system that is considered the root for all operations in a given processing session. Folders and files names or patterns are pre-defined so plans automatically finds their existence for processing.

Once data is gathered, users are required to populate the folders of a project with standard files. For instance, rain data tables of a scenario must live in the climate folder. Topographical maps must go in the topo folder, etc.

Working with projects

Check out the Projects page for more details on how to setup projects.

Input data#

Required input data are basically two types of files: tables and raster maps. Tables are formatted in .csv and raster files are formatted in .tif.

Working with input data

Check out the Files page for more details on how to setup input data.

Tutorials#

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla mollis tincidunt erat eget iaculis. Mauris gravida ex quam, in porttitor lacus lobortis vitae. In a lacinia nisl. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Morbi et tempor sem. Nullam quam dolor, venenatis eget magna ut, accumsan mollis erat.

Hands-on tutorials

Check out the Examples page for hands-on examples.