manage BAN

Management of BAN database

BAN is a DB that describes addresses in France, with also lon-lat coordinates. It has 2 formats, one named BAN with one position per adress, another names BAL with several positions per address. Both formats are continuously updated. They can be downloaded in their last version from data.gouv.fr :

• https://adresse.data.gouv.fr/data/ban/adresses/latest/csv
• https://adresse.data.gouv.fr/data/ban/adresses/latest/csv-bal

Functions/dataset to be added

• download_ban
  • description download the data from official repository (and maybe cquest if available)
  • output archive in original version
• adapt_ban
  • description format the data from official repository in aimed data based on scheme_ban (and scheme_bal if to be done)
  • output: archive in formatted version
  • adaptation needed for used of analyse_archive to get useful information on archive from its name and path
• scheme_ban
  • description global data to be used for formatting data
• analyse_ban
  • description some analyses to be performed after downloading and formatting. At least:
    • new addresses given
    • old addresses dismissed
    • possible incoherence (to be defined)
• vignettes/admin_express_fr.Rmd
  • description presentation of the data in French
  • complete what has already be done
• vignettes/admin_express_en.Rmd
  • description presentation of the data in English
  • translate admin_express_fr when it is done.
• analyse _archive
  • description need a option origin = "ban" that analyses archives of type 'ban' or 'bal
  • output: information for archives of type 'ban' or 'bal'
  • need to pass a path to the function, not only the name, as some informations (date) are included only in the path
  • need to check that original archives are stored in the same way as in data.gouv.fr for the function can analyze both external and local paths.

For each function/dataset. Please follow this procedure

• creation of function
  • code of function
  • documentation of function
  • example for function
  • test for function
• creation of dataset
  • script for creation of "raw" data (if needed)
  • storage of raw data in ascii format, normally in inst/extdata
  • script in to maintain data in /data-raw
  • documentation of data