Package: gloBFPr 2.0.0

Xiaohao Yang

gloBFPr: Urban Environment Analysis Using Global Building Height Datasets

Automated access and analysis of multidimensional building profile in cities. The package provides tools to access, search, and download global 3D building footprint datasets. It includes functions to retrieve building height tiles, compute a range of 2D/2.5D building morphology metrics, assess environmental context (e.g., greenery accessibility), aggregate metrics to the city-block scale, support noise, shadow/radiation, and wind simulation, export study areas as 3D scenes (terrain, buildings, canopy) for 3D modeling software, such as Rhino3D and Blender.

Authors:Xiaohao Yang [aut, cre, cph]

gloBFPr_2.0.0.tar.gz
gloBFPr_2.0.0.zip(r-4.7-x86_64)gloBFPr_2.0.0.zip(r-4.7-arm64)gloBFPr_2.0.0.zip(r-4.6-x86_64)gloBFPr_2.0.0.zip(r-4.6-arm64)
gloBFPr_2.0.0.tar.gz(r-4.7-arm64)gloBFPr_2.0.0.tar.gz(r-4.7-x86_64)gloBFPr_2.0.0.tar.gz(r-4.6-arm64)gloBFPr_2.0.0.tar.gz(r-4.6-x86_64)
gloBFPr_2.0.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION
card.svg |card.png
gloBFPr/json (API)

# Install 'gloBFPr' in R:
install.packages('gloBFPr', repos = c('https://cran.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/billbillbilly/globfpr/issues

Uses libs:
  • c++– GNU Standard C++ Library v3
  • openmp– GCC OpenMP (GOMP) support library
Datasets:

On CRAN:

Conda:

cppopenmp

2.78 score 2 scripts 491 downloads 30 exports 57 dependencies

Last updated from:6cd4c9535f. Checks:10 OK. Indexed: no.

TargetResultTimeFilesSyslog
linux-devel-arm64OK260
linux-devel-x86_64OK269
source / vignettesOK250
linux-release-arm64OK259
linux-release-x86_64OK199
windows-devel-arm64OK452
windows-devel-x86_64OK320
windows-release-arm64OK356
windows-release-x86_64OK271
wasm-releaseOK176

Exports:add_flow_vectorsaggregate_blockgenerate_blockget_3d_worldget_bgviget_dngget_era5_metget_fused_dsmget_metadataget_morphologyget_neighborsget_noise_mapget_radiationget_shadow_footprintget_shadow_heightinfer_osm_trafficinstall_noisemodellingosm_noise_traffic_defaultsplot_bgvi_viewshedplot_foam_mapplot_noise_mapprepare_foam_caseprepare_foam_geometryprepare_noisemodelling_inputsprepare_openfoam_inputsread_foam_pedestrian_slicerun_openfoam_dockersample_foam_slicesearch_3dglobdfsvf

Dependencies:askpasscachemclassclassIntclicodetoolscpp11curlDBIdigestdplyre1071ecmwfrfastmapfilelockfurrrfuturegenericsgetPassglobalsgluehttrhttr2igraphjsonliteKernSmoothkeyringlatticelifecyclelistenvmagrittrMatrixmemoisemimenominatimliteopensslparallellypillarpkgconfigproxypurrrR6Rcpprlangrstudioapis2sfsysterratibbletidyselectunitsutf8vctrswithrwkyaml

Block-Level Analysis with gloBFPr
Block-Level Analysis | 1 Generating blocks | Dual carriageway simplification | Controlling block size | 2 Aggregating metrics to block level | Custom aggregation functions | Block-level population | Block-level residential proportion | 3 Visualizing block-level metrics | Comparing several block metrics in one figure | 4 A complete block analysis pipeline

Last update: 2026-09-04
Started: 2026-09-04

Building Metrics with gloBFPr
Analyze Building Footprints | Example data | 1 Morphological Metrics | 2 Neighbor Metrics | 3 Distance to Nearest Greenspace | Measuring Along Real Streets | 4 Building Green View Index | 5 A Complete Metric Pipeline

Last update: 2026-09-04
Started: 2026-09-04

Building Shadows and Radiation with gloBFPr
Analyze Building Shadows and Radiation | 1 Workflow Summary | 2 Solar Position | 3 Shadow Footprints | 4 Shadow Height as a Terra Surface | 5 Tree Canopy and Terrain | 6 Building Surface Radiation | 6.1 Building surface visualization | 6.2 Tree canopy and terrain | 6.3 Canopy impact: radiation difference | 6.4 2D map view | 6.5 Cumulative daily radiation | 7 Ground-Level Radiation | 7.1 Ground shadow map | 7.2 Ground radiation with tree canopy | 7.3 Ground vs. roof comparison

Last update: 2026-09-04
Started: 2026-09-04

gloBFPr_data_acquisition
1 Retrieve Building Footprints with Heights Using a Bounding Box | 2 Build a Fused Digital Surface Model from Building Height Data | 3 Exporting 3D City Models | 3.1 Quick start | 3.2 Satellite texture | 3.3 Voxel mode

Last update: 2026-09-04
Started: 2026-09-04

Urban Noise Mapping with gloBFPr and NoiseModelling
Urban Noise Mapping | 1 Prepare Inputs | Fetch Canopy, Greenspace, and DEM Internally | 2 Run NoiseModelling | Advanced NoiseModelling Controls

Last update: 2026-09-04
Started: 2026-09-04

Urban Wind CFD with gloBFPr and OpenFOAM
1 Quick start | 2 Inputs | 2.1 Spatial layers | 2.2 Terrain and canopy geometry | 2.3 Ground roughness z0 from land-cover data | 2.4 ERA5 weather conditions | 3 Wind simulation | 3.1 Write the case | Any wind direction works | 3.2 Run via Docker | 3.3 Visualise

Last update: 2026-09-04
Started: 2026-09-04

Readme and manuals

Help Manual

Help pageTopics
Add wind / flow vector arrows to a foam map plotadd_flow_vectors
aggregate_blockaggregate_block
generate_blockgenerate_block
get_3d_worldget_3d_world
Fetch ERA5 conditions for OpenFOAM boundary conditionsget_era5_met
get_fused_dsmget_fused_dsm
get_metadataget_metadata
get_metricsget_bgvi get_dng get_metrics get_morphology get_neighbors
Create a screening-level urban road-noise workflow objectget_noise_map
Building shadow and radiation calculationsget_radiation get_shadows get_shadow_footprint get_shadow_height svf
Test 3D-GloBFP datasetglobfp_example
Example canopy height raster for the 3D-GloBFP sampleglobfp_example_canopy_height
Example DEM for the 3D-GloBFP sampleglobfp_example_dem
Infer screening-level road traffic inputs from OSM road attributesinfer_osm_traffic
Install the headless NoiseModelling runnerinstall_noisemodelling
Default OSM traffic assumptions for screening-level road noiseosm_noise_traffic_defaults
Visualize an Individual Building BGVI Viewshedplot_bgvi_viewshed
Plot an OpenFOAM pedestrian-level mapplot_foam_map
Plot a NoiseModelling-style road-noise mapplot_noise_map
Prepare a transient OpenFOAM case for urban windprepare_foam_case
Build terrain, canopy and terrain-based building geometry for a caseprepare_foam_geometry
Prepare NoiseModelling-style input layersprepare_noisemodelling_inputs
Prepare gloBFPr spatial outputs for an OpenFOAM Docker workflowprepare_openfoam_inputs
Read the pedestrian-level slice and compute wind mapsread_foam_pedestrian_slice
Run an OpenFOAM case via Dockerrun_openfoam_docker
Sample OpenFOAM results at pedestrian level and return a rastersample_foam_slice
search_3dglobdfsearch_3dglobdf