Modulo Process e Pre-process

Il modulo Process e Pre-process si concentra sulla gestione avanzata e sull'elaborazione dei dati del censimento, integrando informazioni amministrative e combinando dati geografici e tabellari per ottenere dataset arricchiti.

`finalize_census_data(census_data_path, years, output_data_folder=None, delete_preprocessed_data=False)`

Finalizza i dati del censimento unendo i dati geografici con i dati tabellari e salva il risultato.

PARAMETER	DESCRIPTION
`census_data_path`	Cartella contenente i dati pre-processati del censimento. TYPE: `Path`
`years`	Lista degli anni del censimento da processare. TYPE: `List[int]`
`output_data_folder`	Cartella di destinazione per i dati finali. Default: None. TYPE: `(Path, opzionale)` DEFAULT: `None`
`delete_preprocessed_data`	Se True, elimina i dati pre-processati dopo il completamento. Default: False. TYPE: `(bool, opzionale)` DEFAULT: `False`

RAISES	DESCRIPTION
`FileNotFoundError`	Se il file GeoPackage principale non esiste.
`KeyError`	Se non viene trovata la colonna di unione corretta tra i dati.

`preprocess_census(processed_data_folder, years, output_data_folder=None, delete_download_folder=False, municipalities_code=[])`

Preprocessa i dati del censimento per più anni, includendo l'opzione di processare anche i confini amministrativi.

PARAMETER	DESCRIPTION
`processed_data_folder`	Cartella contenente i dati pre-processati. TYPE: `Path`
`years`	Lista degli anni del censimento da processare. TYPE: `List[int]`
`output_data_folder`	Cartella di destinazione per i dati elaborati. Default: None. TYPE: `(Path, opzionale)` DEFAULT: `None`
`delete_download_folder`	Se True, elimina la cartella di dati pre-processati dopo TYPE: `(bool, opzionale)` DEFAULT: `False`
`il`	False. TYPE: `completamento del download. Default`
`municipalities_code`	Lista di comuni da estrarre. Usare i dati presenti in `PRO_COM` TYPE: `(list, opzionale)` DEFAULT: `[]`

RETURNS	DESCRIPTION
`Path`	Percorso della cartella con i dati elaborati.

`add_administrative_info(census_data, regions_data_path, regions_target_columns, provinces_data_path, provinces_target_columns, municipalities_data_path, municipalities_target_columns)`

Aggiunge informazioni amministrative (regioni, province e comuni) ai dati del censimento.

PARAMETER	DESCRIPTION
`census_data`	Dati del censimento a cui aggiungere informazioni amministrative. TYPE: `DataFrame`
`regions_data_path`	Percorso del file con i confini regionali. TYPE: `Path`
`regions_target_columns`	Colonne target da estrarre dai dati delle regioni. TYPE: `list`
`provinces_data_path`	Percorso del file con i confini provinciali. TYPE: `Path`
`provinces_target_columns`	Colonne target da estrarre dai dati delle province. TYPE: `list`
`municipalities_data_path`	Percorso del file con i confini comunali. TYPE: `Path`
`municipalities_target_columns`	Colonne target da estrarre dai dati dei comuni. TYPE: `list`

RETURNS	DESCRIPTION
`DataFrame`	pd.DataFrame: DataFrame del censimento con informazioni aggiuntive su comuni, province e regioni.