Skip to content

Getting Started

Installation

Using pip

The sen4cap-client package is not yet deployed on PyPI, therefore installing it as a package using pip is not yet available.

Using conda/mamba

The sen4cap-client package is not yet deployed on conda-forge, therefore installing it using as a conda package using conda or mamba is not yet available.

Using pixi

The sen4cap-client package is not yet deployed on conda-forge, therefore installing it as a conda package using pixi is not yet available.

Using GitHub

To install and use the sen4cap-client package from its sources on GitHub you'll need to install both git and pixi first. Then:

git clone https://github.com/eo-tools/sen4cap-client.git
cd sen4cap-client
pixi install
pixi shell

The installed development environment includes also JupyterLab so the recommended way to get started is to take a look at the notebooks in the notebooks folder.

cd notebooks
jupyter-lab

Getting started

After installing the sen4cap-client package in your Python environment and activating it (conda/mamba: conda activate <your-env>, pixi: pixi shell) make sure the sen4cap-client command-line tool is accessible: Type

sen4cap-client --help

to get an overview of the available commands and options. The first step is to configure the client, which will also serve as default configuration for the client's Python API and its GUI:

sen4cap-client configure

List the available processes of the Sen4CAP processing service:

sen4cap-client list-processes

Development

Install the sen4cap-client as described in Installation / Using GitHub above.

Linting and Testing

To run all checks, execute

pixi run checks

To run all tests, execute

pixi run tests

To generate a coverage report, execute

pixi run coverage

Implementing Enhancements

The sen4cap-client code relies heavily on the Eozilla packages

  • cuiman, which provides the client implementation, and
  • gavicore which provides common OGC model classes and basic utilities.

Should sen4cap-client require non-Sen4CAP-specific enhancements it would likely be best to implement the required changes in the respective Eozilla packages. For this, check out the Eozilla sources directly next to this project's sources to achieve this folder structure:

    <projects>/
    ├── sen4cap-client/
    └── eozilla/
        ├── cuiman/
        ├── gavicore/
        └── ...

Then, during development, change sen4cap-client/pyproject.toml as follows

  1. Comment out the dependencies cuiman and gavicore in the [project.dependencies] table.

  2. Uncomment the editable PyPI dependencies for cuiman and gavicore in the [tool.pixi.pypi-dependencies] table.

Then run once more

pixi install