get_metadata
get_metadata(
self ,
resource: LocalPath ,
snap: bool | str | collections.abc.Collection[bool, str, collections.abc.Collection[str]] = (),
)-> ‘list[dc.PatchMeta]’
Used to get metadata about a file without reading the whole file.
Returns lightweight scan metadata without loading the data array.
Trace headers store the start in whole seconds; a Silixa textual header time stamp within that second refines it.
Trace header positions become x, y and z coordinates along channel: GroupX and GroupY (else CDP_X and CDP_Y) and ReceiverGroupElevation, with their scalars applied. Traces with x and y both zero get NaN. z keeps the file’s convention: Silixa writes receiver true vertical depth (positive down) in ReceiverGroupElevation, so there z is depth. Units are not set, since files often misstate their measurement system.
The textual header is kept, one line per row, as the segy_text_header attr; it is per-file provenance, so merges do not compare it (the first file’s is kept) and the index does not store it. Where it says the values are proportional to strain rate (Silixa), data_type is “strain_rate”, and a stated scale to nm/m/s sets data_units (eg “11600 nm/m/s” for “SC= X11600 TO NM/M/S”), so patch.convert_units("nm/m/s") applies it.