Modulo GeoData

Il modulo Geodata fornisce strumenti per la gestione e il preprocessing dei dati geografici, inclusi confini amministrativi e dati censuari. Le funzioni di questo modulo facilitano la lettura, il filtraggio e la conversione dei dati in formati utilizzabili per l'analisi geografica, come GeoDataFrame e GeoPackage.

preprocess_geodata(census_shp_folder, census_target_columns, census_tipo_loc_mapping, output_folder, census_layer_name, census_column_remapping=None, regions_file_path=None, regions_target_columns=None, regions_index_column=None, regions_column_remapping=None, provinces_file_path=None, provinces_target_columns=None, provinces_index_column=None, provinces_column_remapping=None, municipalities_file_path=None, municipalities_target_columns=None, municipalities_index_column=None, municipalities_column_remapping=None, municipalities_code=[])

Preprocessa e salva i dati geografici del censimento e, opzionalmente, i confini amministrativi.

PARAMETER	DESCRIPTION
`census_shp_folder`	Cartella contenente i file shapefile del censimento. TYPE: `Path`
`census_target_columns`	Colonne da selezionare dai dati del censimento. TYPE: `list`
`census_tipo_loc_mapping`	Mappatura del tipo di località per il censimento. TYPE: `dict`
`output_folder`	Cartella di output per salvare i risultati. TYPE: `Path`
`census_layer_name`	Nome del layer per il GeoPackage del censimento. TYPE: `str`
`census_column_remapping`	Mappatura per rinominare le colonne del censimento. Default: None. TYPE: `(dict, opzionale)` DEFAULT: `None`
`regions_file_path`	Percorso del file dei confini regionali. Default: None. TYPE: `(Path, opzionale)` DEFAULT: `None`
`regions_target_columns`	Colonne da selezionare dai dati regionali. Default: None. TYPE: `(list, opzionale)` DEFAULT: `None`
`regions_index_column`	Colonna da usare come indice per i dati regionali. Default: None. TYPE: `(str, opzionale)` DEFAULT: `None`
`regions_column_remapping`	Mappatura per rinominare le colonne regionali. Default: None. TYPE: `(dict, opzionale)` DEFAULT: `None`
`provinces_file_path`	Percorso del file dei confini provinciali. Default: None. TYPE: `(Path, opzionale)` DEFAULT: `None`
`provinces_target_columns`	Colonne da selezionare dai dati provinciali. Default: None. TYPE: `(list, opzionale)` DEFAULT: `None`
`provinces_index_column`	Colonna da usare come indice per i dati provinciali. Default: None. TYPE: `(str, opzionale)` DEFAULT: `None`
`provinces_column_remapping`	Mappatura per rinominare le colonne provinciali. Default: None. TYPE: `(dict, opzionale)` DEFAULT: `None`
`municipalities_file_path`	Percorso del file dei confini comunali. Default: None. TYPE: `(Path, opzionale)` DEFAULT: `None`
`municipalities_target_columns`	Colonne da selezionare dai dati comunali. Default: None. TYPE: `(list, opzionale)` DEFAULT: `None`
`municipalities_index_column`	Colonna da usare come indice per i dati comunali. Default: None. TYPE: `(str, opzionale)` DEFAULT: `None`
`municipalities_column_remapping`	Mappatura per rinominare le colonne comunali. Default: None. TYPE: `(dict, opzionale)` DEFAULT: `None`
`municipalities_code`	Lista di comuni da estrarre. Usare i dati presenti in `PRO_COM` TYPE: `(list, opzionale)` DEFAULT: `[]`

RETURNS	DESCRIPTION
`Path`	Il percorso della cartella di output con i dati elaborati. TYPE: `Path`

`read_administrative_boundaries(file_path, target_columns, index_column, column_remapping=None, output_folder=None, layer_name=None)`

Legge i confini amministrativi da un file shapefile e restituisce un DataFrame filtrato.

PARAMETER	DESCRIPTION
`file_path`	Percorso del file shapefile contenente i confini amministrativi. TYPE: `Path`
`target_columns`	Lista delle colonne da selezionare dal file. TYPE: `list`
`index_column`	Nome della colonna da utilizzare come indice per il DataFrame. TYPE: `str`
`column_remapping`	Mappa di rinominazione per le colonne. Default: None. TYPE: `(dict, opzionale)` DEFAULT: `None`
`output_folder`	Percorso della cartella di output per salvare il GeoPackage. TYPE: `(Path, opzionale)` DEFAULT: `None`
`layer_name`	Nome del layer per il GeoPackage. Obbligatorio se `with_geometry` è True. TYPE: `(str, opzionale)` DEFAULT: `None`

RETURNS	DESCRIPTION
`Union[DataFrame, Path]`	pd.DataFrame o Path: DataFrame filtrato o percorso del file GeoPackage se `with_geometry` è True.

RAISES	DESCRIPTION
`ValueError`	Se `with_geometry` è True, ma `output_folder` o `layer_name` non sono forniti.

`read_census(shp_folder, target_columns, tipo_loc_mapping, column_remapping=None, output_folder=None, layer_name=None)`

Legge i dati del censimento da una cartella contenente file shapefile e li restituisce come GeoDataFrame o salva in un GeoPackage.

PARAMETER	DESCRIPTION
`shp_folder`	Percorso della cartella contenente i file shapefile del censimento. TYPE: `Path`
`target_columns`	Lista delle colonne da selezionare dai file shapefile. TYPE: `list`
`tipo_loc_mapping`	Mappatura dei codici di località per il campo 'tipo_loc'. TYPE: `dict`
`column_remapping`	Mappatura per rinominare le colonne del DataFrame. Default: None. TYPE: `(dict, opzionale)` DEFAULT: `None`
`output_folder`	Percorso della cartella di output per salvare il GeoPackage. Default: None. TYPE: `(Path, opzionale)` DEFAULT: `None`

RETURNS	DESCRIPTION
`Union[GeoDataFrame, Path]`	Union[gpd.GeoDataFrame, Path]: Un GeoDataFrame con i dati del censimento o il percorso del GeoPackage salvato.

RAISES	DESCRIPTION
`ValueError`	Se non ci sono shapefile nella cartella specificata.