Installation

This project relies on Python geospatial libraries such as rasterio and geopandas. All required dependencies are installed automatically via pip.

Linux Installation

Using a Python Virtual Environment:

1. Clone the repository:

git clone https://github.com/Harmonize-Brazil/mosaic_utils.git

2. Enter the project folder:

cd mosaic_utils

3. Create a virtual environment:

python -m venv venv

4. Activate the environment:

source venv/bin/activate

5. Upgrade pip:

pip install --upgrade pip

6. Install dependencies and package:

pip install -e .

Obs.: This installs the package in development mode, allowing you to modify the code without having to rebuild the package.

Windows Installation

Using PowerShell:

1. Create a virtual environment:

python -m venv mosaic_env

2. Activate the environment:

mosaic_env\Scripts\activate

3. Upgrade pip:

pip install --upgrade pip

4. Install the package:

pip install git+https://github.com/Harmonize-Brazil/mosaic_utils.git

5. Test installation:

crop-mosaic --help

Troubleshooting

If you encounter issues:

• Ensure Python version is 3.10 or higher

• Use a clean virtual environment

• Upgrade pip before installation

pip install --upgrade pip