Version: v0.3.0

Python API index

Every stable name Python exports, and its extension seams.

Package: earthsciio 0.3.0

Documentation extracted with griffe 2.3.2.

Extension-tier names are on the Python extension page .

Stable names

PythonCanonicalKindSummary
CachecachetypeA content-addressed fetch cache over a pluggable Store.
cache_keycache_keyfunctionReturn the lowercase-hex sha256 of the resolved URL.
CacheEntrycache_entrytypeThe result of a fetch: where the blob is + how it got there.
CacheMisscache_misserrorRaised in offline mode when the blob for a resolved URL is absent.
CalendarPeriodcalendar_periodtypeA cadence step of months calendar months plus seconds seconds.
CalendarPeriodErrorcalendar_period_errorerrorAn ISO 8601 period EarthSciIO cannot read; the message contains esm_period_invalid.
CommitErrorcommit_errortypeAn owner’s commit refused the delivered tokens (spec/writer.md §5.3): a missing or duplicate writer, a divergent fingerprint, a gap or an overlap between regions, divergent…
CSVReadercsv_readertypeThe active csv reader — a non-NetCDF format behind the same registry.
DataSourcedata_sourcetypeThe I/O-relevant projection of an ESS DataSource the Provider needs.
decode_time_axisdecode_time_axisfunctionThe Unix seconds (UTC, floored to the second) of a raw CF time axis, or None when it cannot be decoded (spec/esm-sources.md §2.5).
DimWindowdim_windowtypeA window that names its dimensions (spec/prefetch.md §2.2).
EarthSciIOErrorerrorerrorBase class for every EarthSciIO error.
EpochSampleepoch_sampletypeEvery member’s Sample for one epoch: ep["U"].data.
esm_template_namesesm_template_namesfunctionThe substitution names template needs, in order of first appearance, without date.
EsmSourceErroresm_source_errorerrorAn esm data source EarthSciIO cannot read.
EsmTemplateesm_templatetypeA loader URL that is an esm template (spec/esm-sources.md §1.5).
EsmTemplateErroresm_template_errorerrorAn esm URL template could not be expanded.
expand_esm_templateexpand_esm_templatefunctionExpand an esm URL template at anchor (a UTC instant; a naive datetime is read as UTC) with substitutions.
FF10Readerff10_readertypeThe active ff10 reader — the RAW long-format FF10 point table.
file_source_is_currentfile_source_is_currentfunctionRung 0 as a yes/no: is the source provably the file that was ingested?
file_source_statefile_source_statefunctionRung 0 without a memo: what is the file:// source behind this entry?
GeoTIFFReadergeotiff_readertypeThe active geotiff reader — raster bands on a native lon/lat grid.
IntegrityErrorintegrity_errorerrorA cached or freshly downloaded blob failed its checksum / size check.
JSONReaderjson_readertypeThe active json reader: a JSON array of records becomes a points table.
ManifestmanifesttypeIn-memory view of meta/<key>.json (see the schema for field meanings).
NativeDatasetnative_datasettypeThe native arrays from one blob: data variables + grid coords.
NativeFieldnative_fieldtypeOne native-grid array as a reader decodes it.
NetCDFReadernetcdf_readertypeThe active netcdf reader, backed by xarray (netCDF4 engine).
ParquetReaderparquet_readertypeThe active parquet reader — an Apache Parquet file as a flat table.
PrefetchGroupprefetch_grouptypeBackground decode of upcoming forcing epochs (spec/prefetch.md §3).
ProviderprovidertypeA loader-bound provider of native-grid arrays, refreshed at the loader’s cadence.
provider_from_esmprovider_from_esmfunctionA Provider over an esm data_sources entry, bound to cache and the run window (UTC datetimes).
RegionNotShardAlignedregion_not_shard_alignedtypeA writer region violates the alignment rule of spec/writer.md §4.
resolve_cache_rootdata_dirfunctionResolve the cache root directory.
resolve_offlineis_offlinefunctionResolve effective offline mode.
Sampleprefetch_sampletypeOne member’s data for one epoch.
sha256_filesha256_filefunctionsha256 of a file’s contents, streamed so large blobs don’t load to RAM.
ShapefileReadershapefile_readertypeThe active shapefile reader — an ESRI shapefile as a feature table.
source_from_esmsource_from_esmfunctionThe DataSource an esm data_sources entry declares (spec/esm-sources.md §3).
SourceTemporalsource_temporaltypeThe temporal cadence of a DISCRETE loader (absent ⇒ CONST).
TemporaltemporaltypeThe freshness policy derived from a loader’s temporal block.
WindowwindowtypeA run window (start, end) — half-open [start, end).