path

Plot what lies along one optical path, against optical distance.

Every track the path describes becomes a lane: the channels each acquisition places on it, the optical components which give it its length, how it is coupled to the ground, and one lane per label group. A geometry column such as chainage or depth can be drawn as a line panel beneath, sharing the distance axis; it breaks wherever the path states no value rather than bridging the gap. Where the fiber physically is belongs to map().

Parameters

Parameter	Description
inventory	The inventory holding the path.
optical_path	The path to draw, as an `network.array.location` address, a path name, or the object. Optional when the choice is not ambiguous.
acquisition_key	Resolve the path from an acquisition key instead.
time	The instant to resolve at, which is how one epoch of a repaired path is chosen.
distance	The optical distances to draw between, as (low, high). Either end may be None, or …, to run to the path’s own bound. A long lead-in otherwise crushes the instrumented part into a corner.
tracks	Which lanes to draw, in order: any of “channels”, “components”, “coupling”, and the path’s label group names. None draws all.
columns	Geometry columns to draw as line panels beneath the lanes. The CRS’s position axes are refused, since they belong on a map.
n_samples	How finely the columns are sampled.
color	Passed to the lane renderer to override its colors.
max_labels	Draw no lane text at all past this many intervals.
ax	An Axes to draw the lanes on. Column panels need their own figure, so passing this and naming columns is refused.
figsize	Size of the figure built when ax is None.
show	Whether to call plt.show.

Examples

import dascore as dc
from dascore.viz.inventory import path

inventory = dc.get_example_inventory("tunnel")
_ = path(inventory, time="2024-07-01", distance=(1495, 1780))
_ = path(inventory, time="2024-07-01", tracks=("coupling", "section"))