easyidp.data.ForestBirds

class easyidp.data.ForestBirds(*, cache_root=None, notify_missing=True)

Dataset for the forest ecology survey in Florida.

• Author : Prof. Ben Weinstein, The University of Florida

• Location : Florida, US

• Flight date : March 24, 2022

• UAV model : DJI FC6540

• Image number : 93

• Image size : 6016 x 4008

• Software : Metashape

• Outputs : DOM, DSM

__init__(*, cache_root=None, notify_missing=True)

Create a lightweight handle to the forest birds demo dataset.

The constructor only exposes paths. It does not download files; call download() explicitly when is_ready() returns False.

Accessible path attributes include:

• .photo : raw image folder

• .shp : plot ROI shapefile

• .metashape.project : Metashape project file

• .metashape.param : Metashape project folder

• .metashape.dom : Metashape orthomosaic GeoTIFF

• .metashape.dsm : Metashape digital surface model GeoTIFF

Parameters:

• cache_root (Path or str, optional) – Root directory for cached datasets. Defaults to idp.config.get("data_dir").

• notify_missing (bool, optional) – Retained for backward compatibility only; no longer logs warnings.

Examples

>>> fb = idp.data.ForestBirds()
>>> fb.photo
PosixPath('.../2022_florida_forestbirds/Hidden_Little_03_24_2022')

Methods

__init__(*[, cache_root, notify_missing])	Create a lightweight handle to the forest birds demo dataset.
download([mirror, force, progress])	Download this dataset to cache_root.
dry_run()	Return a JSON-friendly summary dict without touching the network.
is_ready()	Return True when every ready_check file exists on disk.
path(key)	Return the absolute Path for a dotted file key.

Attributes

name	Dataset manifest name.
root	Extracted dataset directory.