R/dati.R

In master-info/masteRomi: Dati, Poligoni e altro per analisi di Zone OMI

#' @importFrom data.table data.table
NULL

## TIPOLOGIE ---------------------
# 
#' tipologie
#'
#' Elenco delle varie tipologie di Immobili.
#' 
#' @format Una data.table con le colonne seguenti:
#' \describe{
#'   \item{`codice`}{ Codice Ordinamento per visualizzazioni }
#'   \item{`sigla`}{ Sigla del dato usata da `AGE` nei file originali }
#'   \item{`descrizione`}{ Descrizione del dato per reportistica }
#'   \item{`gruppo`}{ Gruppo omogeneo di appartenenza del dato }
#'   \item{`ordineg`}{ Ordinamento dei Gruppi }
#' }
#'
'tipologie'

## UTILIZZI ----------------------
#
#' utilizzi
#'
#' Elenco degli usi prevalenti per gli Immobili.
#' 
#' @format Una data.table con le colonne seguenti:
#' \describe{
#'   \item{`codice`}{ Codice del dato usato da `AGE` nei file originali }
#'   \item{`descrizione`}{ Descrizione del dato }
#'   \item{`ordine`}{ Ordinamento per visualizzazioni }
#'   \item{`gruppo`}{ Gruppo omogeneo di appartenenza del Dato }
#'   \item{`ordineg`}{ Ordinamento dei Gruppi }
#' }
#'
'utilizzi'

## QUOTAZIONI --------------------
#
#' quotazioni
#'
#' Tabella Quotazioni OMI, periodico *semestrale*, dal semestre 2004-I al semestre 2023-I
#' 
#' @format Una data.table con le colonne seguenti:
#' \describe{
#'   \item{`periodo`}{ Semestre di riferimento }
#'   \item{`OMI`}{ Codice Zona OMI (vedi tabella `zone`) }
#'   \item{`tipologia`}{ Tipologia di Immobile (vedi codici a due cifre nella tabella `utilizzi`) }
#'   \item{`stato`}{ Stato dell'immobile }
#'   \item{`min_acq`}{ Prezzo minimo di acquisto }
#'   \item{`max_acq`}{ Prezzo massimo di acquisto }
#'   \item{`min_loc`}{ Prezzo minimo di locazione }
#'   \item{`max_loc`}{ Prezzo massimo di locazione }
#' }
#'
'quotazioni'

## TRANSAZIONI -------------------
#
#' transazioni
#'
#' Tabella Conteggi e Valori Transazioni Immobili per Zona `OMI`, periodico *annuale* da 2011 a 2022
#' 
#' @format Una data.table con le colonne seguenti:
#' \describe{
#'   \item{`anno`}{ Anno di riferimento (dal 2011 al 2022) }
#'   \item{`catasto`}{ Codice Zona OMI (vedi tabella `zone`) }
#'   \item{`tipologia`}{ Tipologia di Immobile (vedi tabella `tipologie`) }
#'   \item{`valore`}{ Valore }
#' }
#'
'transazioni'

## ZONE --------------------------
#
#' zone
#'
#' Elenco delle Zone OMI all'ultima 
#' 
#' @format Una data.table con le colonne seguenti:
#' \describe{
#'   \item{`catasto`}{ Codice Catastale del Comune }
#'   \item{`OMI`}{ Codice Unico Zona OMI, unione dei campi `catasto` e `zona` }
#'   \item{`inizio`}{ Semestre in cui la zona OMI ha iniziato  }
#'   \item{`termine`}{ Semestre in cui la zona OMI ha terminato di esistere (una query `is.na(termine)` ritorna tutte le zone correnti)  }
#'   \item{`OMIk`}{ Codice Unico Zona OMI come da *AGE* (chiamato `LINKZONA`) }
#'   \item{`OMId`}{ Descrizione Zona OMI da AGE }
#'   \item{`fascia`}{  }
#'   \item{`zona`}{  }
#'   \item{`utilizzo`}{ Codice di Utilizzo prevalente (vedi tabella `utilizzi`) }
#'   \item{`stato`}{ `O`ttimo, `N`ormale, `S`cadente. }
#'   \item{`microzona`}{  }
#' }
#'
'zone'

## LISTA ZONE OMI ------------------
#
#' omi.lst
#' 
#' Elenco delle zone OMI ordinate alfabeticamente per i Comuni Italiani di appartenenza, per uso in un controllo Shiny 
#' 
'omi.lst'

## LEGAMI SZN <> OMI -------------
#
#' szn_omi
#'
#' Associazione fra codici di Sezione di censimento (2011) e corrispondente Zona OMI (2023-I) di completa o maggiore inclusione.
#' 
#' @format Una data.table con le colonne seguenti:
#' \describe{
#'   \item{`SZN`}{ Codice *interno* Sezione di Censimento }
#'   \item{`SZNid`}{ Codice ISTAT Sezione di Censimento }
#'   \item{`OMI`}{ Codice Zona OMI }
#'   \item{`area_int`}{ Area di intersezione della Sezione con la zona OMI }
#'   \item{`copertura`}{ Copertura della superfice della Sezione da parte della zona OMI }
#'   \item{`N`}{ 
#'          Numero di ordinamento rispetto alla copertura. 
#'          Si noti che esistono casi in cui `N == 0`, quando la sezione non ha trovato alcuna inclusione in una propria zona OMI.
#'          Una query `N <= 1` ritorna tutte le sezioni con la corrispondente zona OMI di *migliore* appartenenza. )
#'   }
#' }
#'
'szn_omi'

## TABELLA COMUNI ----------------
#
#' comuni
#'
#' Elenco dei Comuni 
#' 
#' @format Una data.table con le colonne seguenti:
#' \describe{
#'   \item{`CMN`}{ Codice ISTAT del Comune }
#'   \item{`catasto`}{ Codice catastale del Comune (riferimento unico lungo il tempo) }
#'   \item{`nazionale`}{ Codice amministrativo del Comune }
#'   \item{`CMNd`}{ Descrizione AGE del Comune }
#'   \item{`termine`}{ Se valido, l'ultimo semestre di esistenza del Comune }
#'   \item{`PRVs`}{ Sigla della Provincia di Appartenenza }
#' }
#'
#' Per maggiori dettagli sui Comuni, si rimanda alla tabella principale `comuni` del pacchetto `masteRgeo`.
#'
'comuni'

## LISTA COMUNI ------------------
#
#' cmn.lst
#' 
#' Lista alfabetica ordinata dei Comuni Italiani, per uso in un controllo Shiny 
#' 
'cmn.lst'

## TABELLA PROVINCE --------------
#
#' province
#'
#' Tabella Province 
#' 
#' @format Una data.table con le colonne seguenti:
#' \describe{
#'   \item{`PRV`}{ Codice ISTAT }
#'   \item{`PRVs`}{ Sigla Automobilistica }
#'   \item{`PRVd`}{ Descrizione }
#'   \item{`bb_xmin`}{ Longitudine minore del rettangolo di selezione contenente i confini di provincia }
#'   \item{`bb_ymin`}{ Latitudine minore del rettangolo di selezione contenente i confini di provincia }
#'   \item{`bb_xmax`}{ Longitudine maggiore del rettangolo di selezione contenente i confini di provincia }
#'   \item{`bb_ymax`}{ Latitudine maggiore del rettangolo di selezione contenente i confini di provincia }
#' }
#'
'province'

## LISTA PROVINCE ----------------
#
#' prv.lst
#' 
#' Lista alfabetica ordinata con nome e sigla delle Province Italiane, per uso in un controllo Shiny 
#' 
'prv.lst'

## STORICO OMIk ------------------
#
#' omik_variati
#'
#' Tabella di accoppiamento storico fra differenti *LINKZONA* (`OMIk`) afferenti alla stessa Zona `OMI`
#' 
#' @format Una data.table con le colonne seguenti:
#' \describe{
#'   \item{`catasto`}{ Codice catastale del Comune }
#'   \item{`OMI`}{ Codice Zona OMI }
#'   \item{`OMIk`}{ LINKZONA corrente }
#'   \item{`OMIko`}{ LINKZONA precedente }
#' }
#'
'omik_variati'

## ERRORI ------------------------
#
#' errori
#'
#' Lista degli errori nell'elaborazione dei poligoni vettoriali orifinali in formato `KML` delle Zone `OMI`
#' 
#' @format Una data.table con le colonne seguenti:
#' \describe{
#'   \item{`periodo`}{ Semestre di riferimento }
#'   \item{`catasto`}{ Codice catastale del Comune }
#'   \item{`OMI`}{ Codice Zona OMI }
#'   \item{`OMIk`}{ LINKZONA }
#'   \item{`errore`}{ Il tipo di errore, uno fra:
#'                    - `0` Il File non può essere letto (manca il campo `LINKZONA`)
#'                    - `1` Il poligono è vuoto
#'                    - `2` Il poligono si interseca con se stesso
#'                    - `3` Il poligono è annidato
#'                    - `4` Anello
#'                    - `5` Il poligono contiene un buco
#'                    - `6` Meno di quattro punti per formare un poligono
#'                    - `7` Uno o più poligoni senza codice LINKZONA (manca il campo `LINKZONA`)
#'                    - `8` Il poligono è nullo
#'                    - `9` Altra causa di errore non ancora identificata
#'   }
#'   \item{`sanato`}{ Indica se l'errore è stato corretto e l'elemento coinvolto è stato inserito nel risultato finale }
#' }
#'
'errori'


#' @import sf
NULL

## CONFINI OMI -------------------
#
#' OMI
#' 
#' Confini Geografici delle Zone `OMI` come da *Agenzia Entrate*, ma *semplificati* al 20%,
#' in formato digitale vettoriale `sf` convertiti in CRS `WGS84`.
#' 
#' Data ultimo aggiornamento: Primo Semestre 2023
#' 
'OMI'

## CONFINI OMI DA SEZIONI --------
#
#' OMIz
#' 
#' Confini Geografici delle Zone `OMI` in formato digitale vettoriale `sf`, 
#' ottenuti come aggregazione dei confini delle Sezioni di Censimento, incluse totalmente o parzialmente,
#' semplificate al 20%, in CRS `WGS84`.
#' 
#' Data ultimo aggiornamento: Primo Semestre 2023
#' 
'OMIz'

## CONFINI COMUNI DA OMI ---------
#
#' CMNo
#' 
#' Confini Geografici dei Comuni Italiani in formato digitale vettoriale `sf`,
#' ottenuti come aggregazione dei confini delle corrispondenti Zone `OMI` semplificate al 20%, in CRS `WGS84` 
#' 
#' Data ultimo aggiornamento: Primo Semestre 2023
#' 
'CMNo'

## MAPPA INIZIALE ----------------
#
#' mps
#'
#' Mappa iniziale localizzata su Italia per avvio applicazioni Shiny
#' 
'mps'