<!--
  Copyright 2026 Can Deniz Kaya

  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
  You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
-->

# 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.