easyidp.data.Lotus

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

Dataset for the lotus plot in Tanashi, Tokyo.

2017_tanashi_lotus.png

  • Crop : lotus

  • Location : Tanashi, Nishi-Tokyo, Japan

  • Flight date : May 31, 2017

  • UAV model : DJI Inspire 1

  • Flight height : 30 m

  • Image number : 142

  • Image size : 4608 x 3456

  • Software : Pix4D, Metashape

  • Outputs : DOM, DSM, PCD

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

Create a lightweight handle to the lotus 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

  • .pix4d.project : Pix4D project folder

  • .pix4d.param : Pix4D parameter folder

  • .pix4d.dom : Pix4D orthomosaic GeoTIFF

  • .pix4d.dsm : Pix4D digital surface model GeoTIFF

  • .pix4d.pcd : Pix4D point cloud file

  • .metashape.project : Metashape project file

  • .metashape.param : Metashape project folder

  • .metashape.dom : Metashape orthomosaic GeoTIFF

  • .metashape.dsm : Metashape digital surface model GeoTIFF

  • .metashape.pcd : Metashape point cloud file

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

>>> lotus = idp.data.Lotus()
>>> lotus.shp
PosixPath('.../2017_tanashi_lotus/plots.shp')
>>> lotus.pix4d.dom.name
'hasu_tanashi_20170531_Ins1RGB_30m_transparent_mosaic_group1.tif'

Lotus inherits the common dataset API from easyidp.data.dataset.Dataset. The inherited attributes and methods are documented on the hidden Data Advanced API page.

Inherited attributes

Attribute

Description

name

Dataset manifest name.

root

Extracted dataset directory.

Inherited methods

Method

Description

download()

Download and extract the dataset.

dry_run()

Return a JSON-friendly summary without touching the network.

is_ready()

Check whether required dataset files are available.

path()

Resolve a dotted manifest key to an absolute path.