Warning

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

API#

This page provides the complete API reference for the plans python library. Here you will find a list of all available modules, classes, and functions, organized for easy navigation. Each item is documented with its purpose, arguments, return values, and usage details to support effective integration and development.

User Guide

Check out the User Guide for more information about using plans.

Modules#

plans

Hydrology and environmental planning tools for Python.

plans.root

A set of primitive classes used in other modules.

plans.analyst

Classes for statistical analysis of environmental and hydrological data.

plans.geo

Standalone geoprocessing routines with minimal dependencies.

plans.project

Classes and routines for managing PLANS projects on disk.

plans.databases

SQLite-based database classes for storing and managing hydro-environmental time series.

plans.hydrology

Hydrological modelling subpackage with core, upscaled, and downscaled model classes.

plans.hydrology.core

Base hydrological model class and shared simulation utility functions.

plans.hydrology.design

Design storm distributions and synthetic hydrograph generation (NRCS/SCS method).

plans.hydrology.upscaled

Lumped (upscaled) rainfall-runoff model at watershed scale.

plans.hydrology.downscaled

Spatially distributed (downscaled) rainfall-runoff model.

plans.datasets

Dataset subpackage providing primitives, time series, and spatial map classes.

plans.datasets.core

Primitive classes for handling datasets.

plans.datasets.chrono

Classes for handling chronological (time series) datasets.

plans.datasets.spatial

Classes for handling spatial datasets (maps).

plans.tools

Command-line analysis tools subpackage.

plans.tools.core

Base pipeline class, argument parser, and spatial parameter helpers shared by all PLANS tools.

plans.tools.analysis_spatial_normals

analysis_spatial_normals -- standalone PLANS tool.

plans.parsers

Parsers subpackage for reading external hydrological and meteorological data sources.

plans.parsers.flare

Routines for file name formatting and parsing.

plans.parsers.inmet

Parser for INMET files (Brazilian Meteorological Office).

plans.parsers.snirh

Parser for SNIRH Hidroweb files (Brazilian national hydrological database).

plans.qutils

Utility routines for QGIS 3.x Python Scripting Tool

plans.viewer

Handle plots in matplotlib