Metadata-Version: 2.4
Name: areagiskit
Version: 0.14.1
Summary: One-click geospatial studies of any area: Flood, LULC, Landslide, Crop, Urban and Health (236 analyses), with validation and Word/PDF/HTML reports.
Author: Pradeepika Kaushik
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/Praddy-GByte/areagiskit
Project-URL: Source, https://github.com/Praddy-GByte/areagiskit
Project-URL: Issues, https://github.com/Praddy-GByte/areagiskit/issues
Project-URL: Releases, https://github.com/Praddy-GByte/areagiskit/releases
Project-URL: DOI, https://doi.org/10.5281/zenodo.24326878
Keywords: GIS,remote sensing,Sentinel-1,Sentinel-2,flood mapping,land use land cover,landslide susceptibility,agriculture,urban heat island,spatial epidemiology,QGIS,ArcGIS Pro
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
License-File: DATA_LICENSES.md
Requires-Dist: numpy>=1.21
Requires-Dist: matplotlib>=3.5
Provides-Extra: fast
Requires-Dist: scipy>=1.7; extra == "fast"
Dynamic: license-file

# AreaGIS Kit

One area. Six studies. 236 analyses.

AreaGIS Kit runs a complete geospatial study of any area in one run: **Flood, LULC, Landslide, Crop, Urban heat and
Health**. It fetches the open data it needs for the area (no account, no manual download), runs the standard analyses
for the field, compares its results with independent data where it can, grades its confidence (High / Medium / Low)
and writes a report in Word, PDF and HTML that also states what the results cannot tell you.

This package is the engine and command line. The same studies are available as a QGIS plugin and an ArcGIS Pro
toolbox: see https://github.com/Praddy-GByte/areagiskit/releases

**Status: beta.** Please report problems at https://github.com/Praddy-GByte/areagiskit/issues

## Install

AreaGIS Kit needs GDAL's Python bindings, which pip cannot always install on its own. The easiest way:

```
conda create -n areagis -c conda-forge python=3.12 gdal numpy matplotlib scipy
conda activate areagis
pip install areagiskit
```

If GDAL is already on your system (for example the Python that ships with QGIS, or `apt install python3-gdal`),
`pip install areagiskit` is enough.

## Use

```
areagiskit list
areagiskit floodstudy --bbox 67.6 26.6 67.9 26.85 --name "Dadu, Sindh" event_date=2022-09-03 --out out/
areagiskit landslide  --bbox 76.08 11.43 76.22 11.56 --name "Wayanad" event_date=2024-07-30 --out out/
areagiskit healthstudy areas=wards.gpkg id_field=ward_id cases_field=cases population_field=pop --out out/
```

Every run writes `report.html`, `report.docx` and `report.pdf`, plus GeoTIFF and CSV results, in the output folder.

From Python:

```python
from areagiskit.core.aoi import AOI
from areagiskit.kits import get

kit = get("floodstudy")()
result = kit.run(AOI(bbox=[67.6, 26.6, 67.9, 26.85], name="Dadu"), {"event_date": "2022-09-03"}, "out/")
print(result["summary"], result["verdict"]["level"])
```

## Cite

Kaushik, P. (2026). AreaGIS Kit: one-click geospatial studies for QGIS and ArcGIS Pro [Software]. Zenodo.
https://doi.org/10.5281/zenodo.24326878

## Licence

Code: GPL-3.0-or-later with additional terms in NOTICE (keep the author credit, mark changed versions, and do not use
the name "AreaGIS Kit" or its logo for a changed version). Data keeps its own licence; some sources are for
non-commercial use only (see DATA_LICENSES.md).

Author: Pradeepika Kaushik
