Metadata-Version: 2.4
Name: stac-processor-gdmsar
Version: 0.0.2
Summary: A stac-repository complient processor for GDM-SAR products
Author-email: Pierre Fontbonne <pierre.fontbonne@uca.fr>, Alexandre Burel <alexandre.burel@cnrs.fr>
Maintainer-email: Alexandre Burel <alexandre.burel@cnrs.fr>
License: OPEN LICENCE 2.0/LICENCE OUVERTE 2.0
        
        
        "Reuse" of the "Information" covered by this licence
        
        The "Grantor" grants the "Reuser" the free, non-exclusive right to "Reuse" the
        "Information" subject of this licence, for commercial or non-commercial
        purposes, worldwide and for an unlimited period, in accordance with the
        conditions stated below.
        
        The "Reuser" is free to reuse the "Information":
        
        - To reproduce it, copy it.
        - To adapt, modify, retrieve and transform it in order to create "derived
          information", products and services.
        - To share, disseminate, redistribute, publish and transmit it.
        - To exploit it for commercial purposes, e.g., by combining it with other
          information, or by including it in his/her own product or application.
        
        Subject to:
        
        - An acknowledgement of the authorship of the "Information": its source (at
          least, the name of the "Grantor") and the date of the most recent update of
          the reused "Information".
        
        Specifically, the "Reuser" may satisfy this condition by pointing, via a
        hypertext link, to the source of the "Information" and so supplying an actual
        acknowledgement of its authorship.
        
        For example:
        
        "Ministry of xxx—Original data downloaded from
        'http://www.data.gouv.fr/fr/datasets/xxx/', updated on 14 February 2017".
        
        This acknowledgement of authorship does not confer any official status on the
        "Reuse" of the "Information", and must not suggest any sort of recognition or
        endorsement on the part of the "Grantor", or any other public entity, of the
        "Reuser" or of their "Reuse".
        
        
        Personal data
        
        The "Information" made available may contain "Personal data" that may be
        subject to "Reuse". If this is the case, the "Grantor" informs the "Reuser"
        about its existence. The "Information" may be freely reused, within the rights
        granted by this licence, subject to compliance with the legal framework
        relating to personal data protection.
        
        
        Intellectual property rights
        
        It is guaranteed to The "Reuser" that potential "Intellectual property rights"
        held by third parties or by the "Grantor" on "Information" do not interfere
        with the rights granted by this licence.
        
        When the "Grantor" holds transferable "Intellectual property rights" on the
        "Information", he/she assigns these to the "Reuser" on a non-exclusive basis,
        free of charge, worldwide, for the entire duration of the "Intellectual
        property rights", and the "Reuser" is free to use the "Information" for any
        purpose that complies with the rights and conditions defined in this licence.
        
        
        Liability
        
        The "Information" is made available as it is produced or received by the
        "Grantor", without any other express or tacit guarantee than those set out in
        this licence. The "Grantor" does not guarantee the absence of errors or
        inaccuracies in the "Information", nor a continuous supply of the
        "Information". He/she cannot be held responsible for any loss, prejudice or
        damage of any kind caused to third parties as a result of the "Reuse".
        
        The "Reuser" is solely responsible for the "Reuse" of the "Information". This
        "Reuse" must not mislead third parties as to the contents of the "Information",
        its source or its date of update.
        
        
        Applicable legislation
        
        This licence is governed by French law.
        
        Compatibility of this licence
        
        This licence has been designed to be compatible with any free licence that at
        least requires an acknowledgement of authorship, and specifically with the
        previous version of this licence as well as with the following licences: United
        Kingdom's "Open Government Licence" (OGL), Creative Commons' "Creative Commons
        Attribution" (CC-BY) and Open Knowledge Foundation's "Open Data Commons
        Attribution" (ODC-BY).
        
        
        Definitions
        
        Within the meaning of this licence, are to be considered as:
        
        - The "Grantor": any person granting the right to "Reuse" "Information" under
          the rights and conditions set out in this licence.
        - The "Information":
          - any public information contained in documents disclosed or published by any
            administration referred to in the first paragraph of Article L. 300-2 of
            the "Code des relations entre le public et l'administration (CRPA)",
          - any information made available by any person under the terms and conditions
            of this licence.
        - The "Reuse": the use of the "Information" for other purposes than those for
          which it was produced or received.
        - The "Reuser": any person reusing the "Information" in accordance with the
          conditions of this licence.
        - "Personal data": any information relating to an identified or identifiable
          natural person who may be identified directly or indirectly. Its "Reuse" is
          conditional on the respect of the existing legal framework.
        - "Derived information": any new data or information created directly from the
          "Information" or from a combination of the "Information" and other data or
          information not subject to this licence.
        - "Intellectual property rights": all rights identified as such under the "Code
          de la propriété intellectuelle" (including copyright, rights related to
          copyright, sui generis rights of database producers, etc.).
        
        
        About this licence
        
        This licence is intended to be used by administrations for the reuse of their
        public information. It can also be used by any individual wishing to supply
        "Information" under the conditions defined in this licence.
        
        France has a comprehensive legal framework aiming at the spontaneous
        dissemination by the administrations of their public information in order to
        ensure the widest possible reuse of this information.
        
        The right to "Reuse" the administrations' "Information" is governed by the
        "Code des relations entre le public et l'administration (CRPA)".
        
        This licence facilitates the unrestricted and free of charge reuse of public
        information and is one of the licences which can be used by the administration
        pursuant to the decree issued under article L. 323-2 of the CRPA.
        
        Under the Prime Minister's authority, the Etalab mission is mandated to open up
        the maximum amount of data held by State administrations and public
        institutions. Etalab has drawn up the Open Licence to facilitate the
        unrestricted and free of charge reuse of public information, as defined by
        article L. 321-1 of the CRPA.
        
        This licence is version 2.0 of the Open Licence.
        
        Etalab reserves the right to propose new versions of the Open Licence.
        Nevertheless, "Reusers" may continue to reuse information obtained under this
        licence should they so wish.
Project-URL: Homepage, https://gitlab.in2p3.fr/isdeform/stac-processor-gdmsar
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENCE.txt
Requires-Dist: pystac-client
Requires-Dist: pystac
Requires-Dist: requests~=2.32.3
Requires-Dist: typer~=0.15.1
Requires-Dist: jinja2~=3.1.5
Requires-Dist: pydantic
Requires-Dist: geojson_pydantic
Requires-Dist: shapely
Requires-Dist: markdown-it-py
Requires-Dist: mdit-py-plugins
Requires-Dist: mdit-plain
Requires-Dist: mdformat
Requires-Dist: python-dateutil>=2.9.0.post0
Requires-Dist: deepdiff>=8.4.2
Dynamic: license-file

# stac-processor-gdmsar

<p align="center">
  <img src="https://gdm.poleterresolide.fr/upload/services/service2_1.png" alt="GDM-SAR" style="vertical-align: middle; width: 100px; height: 100px;"/>
  <img src="https://stacspec.org/public/images-original/STAC-01.png" style="vertical-align: middle; max-width: 400px; max-height: 100px;" />
</p>

A STAC [processor](https://github.com/fntb/stac-repository/) for [GDM-SAR](https://www.isdeform.fr/services-2/) products.

## Overview

We use [`uv`](https://docs.astral.sh/uv/getting-started/installation/) to manage the venv, dependencies, PYTHONPATH, etc. You (shouldn't but) can do without it, just create a `.venv`, activate it, install the dependencies, and add the repo to your $PYTHONPATH when running any of the scripts.

Installing the dependencies from the `uv.lock` file

```bash
uv sync
```

## Usage

As a standalone CLI :

```bash
uv run stac_processor_gdmsar/app.py --help
```

### Writing Component Templates

See [here](./docs/writing-component-templates.md).

Try them out with :

```bash
uv run scripts/render-template <template-id>
```

### Using `pystac-client` to Query the API

See [the ISDeform data center public documentation](https://gitlab.in2p3.fr/fntb/isdeform-doc-public).

### License

[OPEN LICENCE 2.0](./LICENCE.txt)
