External view

External view#

eo-data-embedding operates over a small set of local files and external interfaces; the detailed data and model interface definitions are given in the Interface Control Document (ICD).

File / interface

Role

Notes

configs/default.yaml

Run configuration

Read at startup; CLI flags override

data/

Input EO imagery (EuroSAT / BigEarthNet / OSCD)

Public benchmark data; downloaded on demand

artifacts/embeddings.parquet

Embedding store

Produced by extract, consumed by search / probe

artifacts/*_results.md

Result reports

Derived metrics; overwritten per run

Clay v1.5 checkpoint

Frozen foundation model

External weights; required for extract / change

Demo bundle (DEFAULT_BUNDLE_URL)

Prebuilt embeddings for the demo

Downloaded by demo

All files are local and governed by ordinary host filesystem permissions; they contain only derived embeddings and metrics over public EO benchmark data, so there are no special privacy markings. To resume operation after an interruption it is sufficient to retain artifacts/embeddings.parquet (and the input data/); any result file can be regenerated by re-running its command. See the ICD for the precise external data and model interface specifications.