Modulo Download

Il modulo Download fornisce una serie di funzioni per scaricare e gestire dati censuari ed i confini amministrativi. Le funzioni principali permettono di scaricare i dati da link specifici, organizzare i file in strutture di cartelle e gestire il processo di estrazione e cancellazione automatica dei file ZIP.

download_base(data_link, data_file_path_destination, data_folder, destination_folder)

Funzione di download base per scaricare dati da un link.

La funzione si occupa di scaricare i dati dal link fornito e salvarli nel percorso specificato. Se il download ha successo, il file ZIP scaricato viene estratto e il file ZIP originale viene eliminato.

PARAMETER	DESCRIPTION
data_link	L'URL da cui scaricare i dati. TYPE: str
data_file_path_destination	Il percorso dove salvare il file scaricato. TYPE: Path
data_folder	La cartella dove estrarre i dati. TYPE: Path
destination_folder	La cartella di destinazione. TYPE: Path

RETURNS	DESCRIPTION
Path	Il percorso della cartella di destinazione. TYPE: Path

RAISES	DESCRIPTION
Exception	Se il download fallisce, restituisce il codice di stato HTTP.

download_all_census_data_1991(output_data_folder, region_list=[])

Download di tutti i dati censuari per l'anno selezionato. E' possibile effettuare il download per singola Regione ma anche per specifiche Regioni. Quando il campo region_list resta vuoto vengono scaricati i dati di tutte le Regioni.

PARAMETER	DESCRIPTION
output_data_folder	Path TYPE: Path
region_list	List TYPE: List DEFAULT: []

RETURNS	DESCRIPTION
Path	Path di destinazione.

download_all_census_data_2001(output_data_folder, region_list=[])

Download di tutti i dati censuari per l'anno selezionato. E' possibile effettuare il download per singola Regione ma anche per specifiche Regioni. Quando il campo region_list resta vuoto vengono scaricati i dati di tutte le Regioni.

PARAMETER	DESCRIPTION
output_data_folder	Path TYPE: Path
region_list	List TYPE: List DEFAULT: []

RETURNS	DESCRIPTION
Path	Path di destinazione.

download_administrative_boundaries(output_data_folder, census_year)

Scarica i confini amministrativi e li salva in una cartella di destinazione.

Questa funzione crea una cartella di destinazione per i confini amministrativi e scarica il file necessario nella cartella creata.

PARAMETER	DESCRIPTION
output_data_folder	Il percorso della cartella in cui salvare i confini amministrativi scaricati. TYPE: Path

RETURNS	DESCRIPTION
Path	Il percorso della cartella di destinazione contenente i confini amministrativi scaricati. TYPE: Path

RAISES	DESCRIPTION
Exception	Se si verifica un errore durante il download dei confini amministrativi.

download_all_census_data_2011(output_data_folder, region_list=[])

Download di tutti i dati censuari per l'anno selezionato. E' possibile effettuare il download per singola Regione ma anche per specifiche Regioni. Quando il campo region_list resta vuoto vengono scaricati i dati di tutte le Regioni.

PARAMETER	DESCRIPTION
output_data_folder	Path TYPE: Path
region_list	List TYPE: List DEFAULT: []

RETURNS	DESCRIPTION
Path	Path di destinazione.

download_data(output_data_folder, census_year)

Scarica i dati censuari e li salva in una cartella di destinazione.

Questa funzione crea una cartella di destinazione per i dati e scarica i file necessari.

PARAMETER	DESCRIPTION
output_data_folder	Il percorso della cartella in cui salvare i dati scaricati. TYPE: Path
census_year	Anno di censimento. TYPE: int

RETURNS	DESCRIPTION
Path	Il percorso della cartella di destinazione contenente i dati scaricati. TYPE: Path

RAISES	DESCRIPTION
Exception	Se si verifica un errore durante il download o il salvataggio dei dati.

download_geodata(output_data_folder, census_year, region_list=[])

Scarica i dati geocensuari per le regioni specificate.

Questa funzione crea una struttura di cartelle per i dati censuari e scarica i file ZIP contenenti i dati geocensuari per le regioni indicate. Se non vengono fornite regioni, vengono scaricati i dati per tutte le 20 regioni.

PARAMETER	DESCRIPTION
output_data_folder	La cartella di output principale per i dati. TYPE: Path
region_list	Lista di regioni da scaricare. Se vuota, scarica i dati per tutte le regioni (default: []). TYPE: List[int] DEFAULT: []

RETURNS	DESCRIPTION
Path	La cartella contenente i dati geocensuari scaricati. TYPE: Path

download_all_census_data_2021(output_data_folder, region_list=[])

Download di tutti i dati censuari per l'anno selezionato. E' possibile effettuare il download per singola Regione ma anche per specifiche Regioni. Quando il campo region_list resta vuoto vengono scaricati i dati di tutte le Regioni.

PARAMETER	DESCRIPTION
output_data_folder	Path TYPE: Path
region_list	List TYPE: List DEFAULT: []

RETURNS	DESCRIPTION
Path	Path di destinazione.

download_census(years, output_data_folder, region_list=[])

Scarica i dati censuari per gli anni specificati e salva i dati nella cartella di output.

PARAMETER	DESCRIPTION
years	Lista degli anni censuari da scaricare. Se vuota, scarica i dati per tutti gli anni disponibili. TYPE: List[int]
output_data_folder	Percorso della cartella di destinazione per i dati scaricati. TYPE: Path
region_list	Lista delle regioni per cui scaricare i dati. Se vuota, scarica i dati per tutte le regioni. TYPE: (List, opzionale) DEFAULT: []

RAISES	DESCRIPTION
ValueError	Se un anno specificato non è supportato o non esiste nella mappa delle funzioni.