Skip to content

NewGraphEnvironment/fly

Repository files navigation

fly fly logo

Footprints from Legacy aerial photographY

Select the minimum set of historic airphotos needed to cover your study area.

Why

Historic airphotos are essential for documenting landscape change, but ordering them is tedious — you're choosing from thousands of overlapping frames across multiple scales and decades. Photo centroids are available from the BC Data Catalogue but knowing which frames actually cover your area of interest requires estimating ground footprints from scale and film format.

fly estimates those footprints, filters by actual ground coverage (not just centroids), and picks the smallest set that meets your target. Best-resolution photos first, coarser scales fill the gaps.

Priority selection: 1:12000 (blue) and 1:31680 (orange) footprints covering a floodplain AOI near Houston, BC

Upper Bulkley River floodplain near Houston, BC — 1968 photos at 1:12,000 (blue) and 1:31,680 (orange).

Installation

pak::pak("NewGraphEnvironment/fly")

Example

library(fly)
library(sf)

# Estimate footprint rectangles from centroids
footprints <- fly_footprint(centroids)

# Filter photos whose footprint overlaps the AOI (not just centroids)
filtered <- fly_filter(centroids, aoi, method = "footprint")

# Fewest photos to reach 95% coverage
selected <- fly_select(filtered, aoi, mode = "minimal", target_coverage = 0.95)

# Ensure every disconnected AOI polygon gets at least one photo
selected <- fly_select(filtered, aoi, mode = "minimal",
                       target_coverage = 0.95, component_ensure = TRUE)

# Or grab every photo touching the AOI
all_photos <- fly_select(filtered, aoi, mode = "all")

Related packages

  • flooded — delineate floodplain extents from DEMs and stream networks to generate AOI polygons
  • drift — land cover change detection from satellite imagery; fly adds longer-term historic airphoto context
  • fresh — FWA/bcfishpass database queries (DB functions previously in fly moved here in v0.2.0)

Documentation

Full walkthrough with priority selection at the airphoto selection vignette.

About

Airphoto Footprint Estimation and Coverage Selection

Resources

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
LICENSE.md

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages