Installation

From PyPI

Install ocha-stratus using pip:

pip install ocha-stratus

Development Installation

For development, install from source:

  1. Clone the repository:

git clone https://github.com/OCHA-DAP/ocha-stratus.git
cd ocha-stratus

  1. Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

  1. Install development dependencies:

pip install -e ".[dev]"

Environment Configuration

This package depends on the following environment variables:

# Development Environment
DSCI_AZ_BLOB_DEV_SAS=your_dev_sas_token
DSCI_AZ_DB_DEV_PW=your_dev_db_password
DSCI_AZ_DB_DEV_HOST=your_dev_db_host
DSCI_AZ_DB_DEV_UID=your_dev_db_uid

# Production Environment
DSCI_AZ_BLOB_PROD_SAS=your_prod_sas_token
DSCI_AZ_DB_PROD_PW=your_prod_db_password
DSCI_AZ_DB_PROD_HOST=your_prod_db_host
DSCI_AZ_DB_PROD_UID=your_prod_db_uid

Dependencies

ocha-stratus requires Python 3.10 or later and depends on:

  • pandas

  • geopandas

  • xarray

  • rioxarray

  • azure-storage-blob

  • sqlalchemy

  • psycopg2-binary

  • python-dotenv

  • pyarrow

  • dask

These will be installed automatically when you install ocha-stratus.