Metadata-Version: 2.1
Name: cartiflette
Version: 0.0.2
Summary: Tools to easily retrieve French borders for geographic data analytics
License: OPEN LICENCE 2.0/LICENCE OUVERTE 2.0
Author: Lino Galiana
Author-email: lino.galiana@insee.fr
Requires-Python: >=3.9,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: PyYAML (>=6.0,<7.0)
Requires-Dist: appdirs (>=1.4.4,<2.0.0)
Requires-Dist: charset-normalizer (>=3.2.0,<4.0.0)
Requires-Dist: diskcache (>=5.6.3,<6.0.0)
Requires-Dist: fastexcel (>=0.11.6,<0.12.0)
Requires-Dist: fiona[s3] (>=1.9.4.post1,<2.0.0)
Requires-Dist: geopandas (>=1.0.1,<2.0.0)
Requires-Dist: matplotlib (>=3.7.1,<4.0.0)
Requires-Dist: openpyxl (>=3.1.5,<4.0.0)
Requires-Dist: owslib (>=0.28.1,<0.29.0)
Requires-Dist: pandas (>=2.2.2,<3.0.0)
Requires-Dist: pebble (>=5.0.3,<6.0.0)
Requires-Dist: polars (>=1.8.1,<2.0.0)
Requires-Dist: py7zr (>=0.20.4,<0.21.0)
Requires-Dist: pyarrow (>=17.0.0,<18.0.0)
Requires-Dist: python-dotenv (>=1.0.0,<2.0.0)
Requires-Dist: python-magic (>=0.4.14,<0.5.0) ; sys_platform == "linux"
Requires-Dist: python-magic-bin (>=0.4.14,<0.5.0) ; sys_platform == "win32"
Requires-Dist: requests (>=2.28.2,<3.0.0)
Requires-Dist: requests-cache (>=1.1.0,<2.0.0)
Requires-Dist: retrying (>=1.3.4,<2.0.0)
Requires-Dist: s3fs (>=2023.3.0,<2024.0.0)
Requires-Dist: topojson (>=1.5,<2.0)
Requires-Dist: unidecode (>=1.3.6,<2.0.0)
Requires-Dist: urllib3 (<2)
Requires-Dist: xlrd (>=2.0.1,<3.0.0)
Description-Content-Type: text/markdown

# `cartiflette` [![](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) <img height="18" width="18" src="https://cdn.simpleicons.org/python/00ccff99" /> <img height="18" width="18" src="https://cdn.simpleicons.org/r/00ccff99" /> <img height="18" width="18" src="https://cdn.simpleicons.org/javascript/00ccff99" />  <img src="cartiflette.png" align="right" height="139" />


`cartiflette` est un projet pour faciliter l’association de sources
géographiques en proposant des récupérations facilitées de coutours de
cartes officiels.

Une documentation interactive est en préfiguration sur la [plateforme observable](https://observablehq.com/@linogaliana/cartiflette-demo).

L'objectif de `cartiflette` est d'offrir des méthodes fiables, 
reproductibles et multi-langages pour récupérer des fonds de carte officiels de l'IGN
enrichis de métadonnées utiles pour la cartographie et la _data science_. 

La récupération des fonds de carte de l'IGN par le biais de `cartiflette` est 
possible par le biais de clients <img height="18" width="18" src="https://cdn.simpleicons.org/python/00ccff99" />,
<img height="18" width="18" src="https://cdn.simpleicons.org/r/00ccff99" /> et
<img height="18" width="18" src="https://cdn.simpleicons.org/javascript/00ccff99" />.
Une API est en cours de développement.

De nombres évolutions étant encore à venir, n’hésitez donc pas à repasser
fréquemment sur cette page.

<details>
  <summary>
  Installer la librairie <img height="18" width="18" src="https://cdn.simpleicons.org/python/00ccff99" />
  </summary>

``` python
pip install git+https://github.com/inseefrlab/cartogether
```

</details>


## Exemples

Plus d'exemples sont disponibles dans la documentation interactive
sur [`ObservableHQ`](https://observablehq.com/@linogaliana/cartiflette-demo?collection=@linogaliana/cartiflette).

<details>
  <summary>
    Exemple de récupération du fonds de carte des départements avec les DROM rapprochés de la France métropolitaine
  </summary>

![image](https://github.com/InseeFrLab/cartiflette/assets/33896139/18cf091f-ddab-420d-a078-4c678f21db23)

</details>

## Contexte

Le projet `cartiflette` est un projet collaboratif lancé par des agents de l'Etat dans le cadre d'un programme interministériel
nommé [Programme 10%](https://www.10pourcent.etalab.gouv.fr/).

__Vous désirez contribuer ?__ Plus d'information sont disponibles dans le fichier [CONTRIBUTING.md](CONTRIBUTING.md)

