Metadata-Version: 2.4
Name: cartiflette
Version: 0.0.3
Summary: Tools to easily retrieve French borders for geographic data analytics
Author-email: Lino Galiana <lino.galiana@insee.fr>, Thomas Grandjean <thomas.grandjean@developpement-durable.gouv.fr>
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.9
Requires-Dist: appdirs>=1.4.4
Requires-Dist: charset-normalizer>=3.2.0
Requires-Dist: diskcache>=5.6.3
Requires-Dist: fastexcel>=0.11.6
Requires-Dist: fiona[s3]>=1.9.4.post1
Requires-Dist: geopandas>=1.0.1
Requires-Dist: matplotlib>=3.7.1
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: owslib>=0.28.1
Requires-Dist: pandas>=2.2.2
Requires-Dist: pebble>=5.0.3
Requires-Dist: polars>=1.8.1
Requires-Dist: py7zr>=0.20.4
Requires-Dist: pyarrow>=17.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: python-magic-bin>=0.4.14; sys_platform == 'win32'
Requires-Dist: python-magic>=0.4.14; sys_platform == 'linux'
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests-cache>=1.1.0
Requires-Dist: requests>=2.28.2
Requires-Dist: retrying>=1.3.4
Requires-Dist: s3fs>=2023.3.0
Requires-Dist: topojson>=1.5
Requires-Dist: tqdm>=4.67.1
Requires-Dist: unidecode>=1.3.6
Requires-Dist: urllib3
Requires-Dist: xlrd>=2.0.1
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)
