Process CRAN feedback:
Argumentsfilenames inflexurba::download_GHSLdata(), andoutput_filenames andglobal_filenames inflexurba::crop_GHSLdata() are now required as per CRANpolicy.
Minor changes to unit test such that files created in thetemporary directory are cleaned up.
Changes to examples ofdownload_GHSLdata.
Update spatial boundaries inflexurba::units_belgiumbased on data from theAlgemeneDirectie Statistiek - Statistics Belgium, as these are availableunder Creative Commons CC BY 4.0 licence. Note that analysis that relyonflexurba::units_belgium might have differentresults.
Update parameter list in the functionflexurba::DoU_get_grid_parameters(). The valuesUC_smooth_pop andUC_smooth_pop_window weremissing from Level 1.
Several minor modifications on the developers side of the packageto prepare for a CRAN submission.
Newapply_threshold() identifies urban areas byapplying a threshold on grid cells.
Newconvert_regions_to_grid() convert regions from avector layer to gridded format.
New R packageflexurbaDatawith global datasets accompanying the Flexurba R package. The packageincludes processed population and built-up area derived from theGlobalHuman Settlement Layer, and night-time light grid derived from theEarthObservation Group.
Newload_proxies_belgium() loads a sample of theproxy datasets inflexurbaData for the country ofBelgium.
Two new vignettes: (1)vignette("vig8-apply-thresholds") discussing differentthresholding approaches and (2)vignette("vig9-different-proxies") on different proxydatasets used to construct urban boundaries.
The functions that were specifically design to reconstruct theDegree of Urbanisation delineation have been renamed with theprefixDoU_ to make a more consistent API and allowing fora better tab-completion. The old names remain available for backwardcompatibility.
| New name | Old name |
|---|---|
DoU_preprocess_grid() | preprocess_grid() |
DoU_classify_grid() | classify_grid() |
DoU_classify_grid_urban_centres() | classify_grid_urban_centres() |
DoU_classify_gid_urban_clusters() | classify_gid_urban_clusters() |
DoU_classify_grid_rural() | classify_grid_rural() |
DoU_classify_grid_water() | classify_grid_water() |
DoU_get_grid_parameters() | get_grid_parameters() |
DoU_get_optimal_builtup() | get_optimal_builtup() |
DoU_preprocess_units() | preprocess_units() |
DoU_classify_units() | classify_units() |
DoU_preprocess_units() | preprocess_units() |
DoU_load_grid_data_belgium() | load_grid_data_belgium() |
DoU_plot_grid() | plot_grid() |
DoU_plot_units() | plot_units() |
The grid classification rules for semi-dense urban clusters inLevel 2 of DEGURBA have been modified in July 2024. To reflect the mostup-to-date rules, the defaultflexurba grid parameters forsemi-dense urban clusters inDoU_get_grid_parameters() havealso been updated. Specifically:
SDUC_density_threshold)increased from 300 to 900 inhabitants per km²SDUC_size_threshold)decreased from 5000 to 2500 inhabitantsSDUC_contiguity_rule) is modifiedfrom the queen (=8) to rook (=4)contiguitySDUC_buffer_size is adjusted to 2 km
Note that these changes will affect the results ofDoU_classify_grid() andDoU_classify_grid_urban_clusters() iflevel1isset toFALSE. The previous classification rules forsemi-dense urban clusters can still be applied by specifying themexplicit in the function argumentparameters.
The unit classification rules for Level 2 of DEGURBA have beenmodified in July 2024. To reflect the most up-to-date rules, theflexurba functionDoU_classify_units() is alsoupdated (see the documentation page for more information). The previousclassification rules can still be applied by setting the functionargumentrules_from_2021 toTRUE.
The function reference is restructured and the README, functiondocumentation pages and vignettes are modified to reflect theupdates.