load_india
data.load_india()Load the India district (n=520) nighttime lights case study.
Downloads (or reads from the local cache) the source files of quarcs-lab/project2025s-py, pinned to a commit, and reshapes them into the three geometrics inputs.
Returns
| Name | Type | Description |
|---|---|---|
| gdf | geopandas.GeoDataFrame | 520 district geometries with columns ["statedist", "geometry"], CRS EPSG:4326. |
| df | pandas.DataFrame | Long panel of 3120 rows (520 districts x 6 years: 1996, 1999, 2000, 2004, 2005, 2010). Year-varying nighttime luminosity (ntl_rural, ntl_urban, ntl_total), the paper-replication columns (ntl_pc_1996, log_ntl_pc_1996, growth_ntl_pc_9610; carried verbatim from the source), two population columns, and the 16 conditional controls (repeated per year). Sorted by statedist then year. |
| df_dict | pandas.DataFrame | Data dictionary with one row per df column, in df column order, with columns var_name, var_def, label, type, role, can_be_na. |
Raises
| Name | Type | Description |
|---|---|---|
| GeometricsDataError | If a source file cannot be downloaded or fails hash verification. |
See Also
load_india_raw : The same source files without any reshaping. load_india_states : State-level (n=32) companion dataset.
Examples
>>> from geometrics.data import load_india
>>> gdf, df, df_dict = load_india()
>>> df.shape
(3120, 28)