OpticalPath

Continuous optical path described by independent component, geometry, coupling, and annotation tracks.

No more than one OpticalPath per (FiberArray, location_code) is valid at a given time. Validity intervals are half-open and all times are UTC. Optical components tile [start_distance, start_distance + total component length).

Aliases: Path

Attributes

Name	Type	Description
name	str	Human-readable optical path name.
start_distance	float	Origin of this path’s optical-distance axis in meters; 0 for whole paths. Set by select and split_at so path pieces keep absolute optical distances.
location_code	str	FDSN-style location code naming this path lineage within its fiber array; blank by default. Acquisitions sharing this location code interrogate this path.
start_time	datetime64	Start time for which this metadata item is valid.
end_time	datetime64 | None	End time for which this metadata item is valid; None while ongoing.
optical_components	tuple[OpticalComponent, …]	Ordered optical components on this path.
geometry	tuple[Geometry, …]	Ordered geometries on this path.
coupling	tuple[CouplingCondition, …]	Ordered coupling conditions on this path.
annotations	tuple[OpticalPathAnnotation, …]	Ordered optical path annotations.
measurements	tuple[OpticalMeasurement, …]	OTDR and other optical measurements of this whole path.
optical_length	float	Computed total optical length from optical_components.

Contains

• OpticalComponent
• Geometry
• CouplingCondition
• OpticalPathAnnotation

Contained By

• FiberArray

References

• uses Cable
• uses Enclosure

Referenced By

None.