Bulk Identity

Module: spectralbridge.bulk.identity.

Extensible scientific-identity parsing for bulk flightline discovery.

API glossary · Workflow / scientific context

Signatures and documentation below are collected from the current source. Advanced objects are not newly declared stable by inclusion here.

Audience: public. Also exported as spectralbridge.bulk.FlightlineIdentity.

FlightlineIdentity dataclass

FlightlineIdentity(flightline_id: str, site: str | None, acquisition_date: str | None, identity_source: str)

Scientific identity for one independently processed flightline.

Attributes:

Name	Type	Description
flightline_id	str	Canonical scientific flightline identifier; histories from the same underlying flight must retain this identity.
site	str | None	Scientific site code recovered from the canonical identity or manifest, not an arbitrary outer directory name.
acquisition_date	str | None	ISO acquisition date associated with this scientific flightline; None indicates unavailable metadata.
identity_source	str	Parser or manifest provenance explaining how the scientific flightline identity was recovered.

Audience: public. Also exported as spectralbridge.bulk.FlightlineIdentityParser.

FlightlineIdentityParser

Protocol for adding identity conventions without changing discovery.

Attributes:

Name	Type	Description
name	str	Stable parser/profile identifier used in configuration and provenance.

parse

parse(directory: Path) -> FlightlineIdentity | None

Return an identity when directory matches this convention.

Audience: advanced.

ManifestIdentityParser dataclass

ManifestIdentityParser(filename: str = 'spectralbridge_flightline.json', name: str = 'spectralbridge_flightline_manifest')

Parse a generic, user-authored flightline identity manifest.

parse

parse(directory: Path) -> FlightlineIdentity | None

Audience: advanced.

NEONDirectoryIdentityParser dataclass

NEONDirectoryIdentityParser(name: str = 'canonical_neon_directory')

Preserve canonical NEON-directory support as one parser plugin.

parse

parse(directory: Path) -> FlightlineIdentity | None

Audience: advanced.

resolve_flightline_identity

resolve_flightline_identity(directory: str | Path, *, parsers: Sequence[FlightlineIdentityParser] = DEFAULT_IDENTITY_PARSERS) -> FlightlineIdentity | None

Resolve one directory, rejecting conflicting parser results.

Explicitly exported constants and type aliases

These values describe package metadata, schemas or configuration; they are not observations from a production dataset.

Name	Source expression
DEFAULT_IDENTITY_PARSERS	(ManifestIdentityParser(), NEONDirectoryIdentityParser())