satellit_sam.core.tree

Auto-generated from satellit_sam/src/satellit_sam/core/tree.py by satellit_sam/scripts/generate_api_docs.py.

Tree data model and coordinate transforms used by SAM workflows.

Back to API index

Functions

No public module-level functions.

Classes

Tree

Represents one inventory tree with geodetic coordinates and stem diameter.

Attributes:
tree_id: Inventory identifier for the tree.
stem_id: Inventory stem identifier when available.
species: Species label when available.
status: Tree status from the source inventory (for example, alive/dead).
x_wgs84: Longitude in decimal degrees (EPSG:4326).
y_wgs84: Latitude in decimal degrees (EPSG:4326).
dbh_cm: Diameter at breast height in centimeters.

Attributes

  • dbh_cm: float
  • species: str | None
  • status: str | None
  • stem_id: str | None
  • tree_id: str
  • x_wgs84: float
  • y_wgs84: float

Methods

pos_to_utm
def pos_to_utm(self, utm_zone: int, northern_hemisphere: bool) -> tuple[float, float]:
Project WGS84 coordinates to UTM easting/northing in meters.

Arguments

  • utm_zone: UTM longitudinal zone number (1-60). northern_hemisphere: Truefor northern hemisphere zones,False for southern.

Returns

  • Tuple (x_utm, y_utm) containing easting and northing in meters.