# Datadir Guide

This folder contains shared runtime input data files used by PEM workflows.

## Contents

- `obl_ecc_lsp_mars.asc`: reference orbital forcing table for Mars workflows
- `obl_ecc_lsp_future-mars.asc`: alternate orbital forcing table for extended/future scenarios

## When You Need These Files

Orbital forcing input is required only when `evo_orbit=.true.` in `run_pem.def`.

Set `orbitdata_path` explicitly to one of the files in this folder.

If `orbitdata_path` is not set, runtime fallback remains `obl_ecc_lsp_mars.asc`.

## Usage

Copy default table to your simulation directory:

```bash
cp datadir/obl_ecc_lsp_mars.asc <simulation_dir>/
```

Or set an explicit file path in `run_pem.def`:

```ini
orbitdata_path=/absolute/or/relative/path/to/obl_ecc_lsp_mars.asc
```

Operational note:

- use explicit `orbitdata_path` when running multiple experiments to avoid ambiguity across run directories.

## Contributor Notes

- Keep orbital tables versioned and immutable once published for reproducibility.
- Document any new data file semantics in this README and in workflow docs.
- When adding or renaming data files, update references in `../deftank/README.md` and `../USER_GUIDE.md`.

## Related Docs

- `../USER_GUIDE.md`: build, run, coding guidance, and version/provenance commands
- `../deftank/README.md`: workflow setup and execution
- `../toolbox/README.md`: post-processing and helper tools