ace

Glossary

ACE : Aree di Censimento SCE : Sezione di Censimento

C++ Tools

• remap

  • input: istat kmz file
  • output: (shell) csv with format ace_id,lat,lon

• animate

  • input: ?
  • output: ?

• remap

  • input: ?
  • output: ?

Python Tools

Located in folder scripts

• acemap_generator.py Create an acemap of italian comuni without geodata.

  • input: Elenco-comuni-italiani.csv available here
  • output: acemap-empty.json which is a nested json of format acemap['regione_id']['prov']['provincia_id']['com']['comune_id'] = { 'name' : 'name' // italian denomination of _comune_ 'centroid' : [0,0] // [lon, lat] of _comune_ centroid 'sez_count' : 0 // number of SCE associated to given _comune_ }

• acemap_geoupdate.py Update geodata on an acemap of italian comuni populating fields: centroid and sez_count.

  • input: acemap.json properly formatted
  • input: region_shapefile.geojson as available here
  • output: acemap_RXX.geojson where RXX is the regione shapefile tag (e.g. R01 is for Piemonte)

• aceserver.py Local http server which provides acemap json data visualization through GET requests.

  • input: acemap.json as produced by previous tools
  • input: address
  • input: port

Access the web page at http://address:port/view?params where the string params is a concatenation (separator &) of strings of types:

• Regione code: XXX (e.g. 001)
• Provincia code: XXXYYY (e.g. 0010001)
• Comune code: XXXYYYZZZ (e.g. 0010001001)

• acemap_mobupdate.py Update geodata on an acemap of italian comuni populating fields: centroid and sez_count.

  • input: acemap.json (properly formatted)
  • input: regex to match file of the form mobility_YYYYMMDD_HHMM.tsv (properly formatted mobility data)
  • output: acemap_RXX.geojson where RXX is the regione shapefile tag (e.g. R01 is for Piemonte)

• istat-ace.py and istat-plot.py Parse ISTAT ACE data and dump ???

  • input: Per region shapefiles link
  • input: Correct version of naming metadata link
  • usage: After extraction of ISTAT data in a folder (e.g. istat_data) launch (30-40 min)

# Perform ISTAT shapefile analysis, merge by scale level
(time ~/Codice/ace/python/istat-ace.py -d istat_data -p -v -ma -mc -mp -mr) 2>&1 | tee log_merge_full.log

# Pack and annotate joining naming data
(time ~/Codice/ace/python/istat-ace.py -d istat_data -pa r p c a) 2>&1 | tee log_pack_full.log

# Plot to test
(time ~/Codice/ace/python/istat-plot.py -s r p c a -m) 2>&1 | tee log_plot_full.log

• output: Collection of csv and shapefiles aggregated at various ISTAT scale (reg, pro, com, ace) with naming metadata.

References

Details of ISTAT databases available here