• energy: Central hub for related research, documentation, and reproducibility artifacts.
• casimir-ultra-smooth-fabrication-platform: Fabrication and quality-control artifacts relevant to prototype hardware.
• casimir-environmental-enclosure-platform: Environmental control and synchronization examples for testbeds.
• casimir-anti-stiction-metasurface-coatings: Materials research that informs prototype performance and friction/stiction behavior.

This repository documents research-stage code, derivations, simulations, and prototype experiments exploring precision nanopositioning and Casimir-aware control. Reported capabilities are derived from simulation studies and limited prototype experiments; they are not production guarantees.

The platform contains prototype implementations for Casimir-force modeling with material and polymer-inspired corrections, mechanical stability analyses, uncertainty-aware specification workflows, and a multi-physics digital twin intended for reproducible experiments. Mathematical derivations and example scripts are provided for reference; results depend on modeling assumptions, numerical choices, and test configurations.

• Casimir-aware modeling (prototype): Modeling studies explore material dispersion, metamaterial enhancements, and polymer-inspired corrections (see src/physics and docs/ for provenance). Results vary with model choices and input data.
• Multi-Physics Digital Twin (prototype): Example integrations and synchronization approaches are provided for lab testbeds; latency/fidelity depend on hardware, network, and calibration.
• Uncertainty Quantification: Example Monte Carlo and sensitivity analyses are included; sample sizes and reported summaries are specific to the experiments in docs/ and should be re-evaluated for new configurations.
• Control Architecture: Prototype multi-rate and model-predictive control examples are provided for research and comparison, not as certified control systems.
• Bayesian State Estimation (examples): Several estimators are included for benchmarking; performance depends on model mismatch and tuning.

Numeric figures reported in this repository come from controlled test conditions or simulation runs. They are presented as example outcomes; users should consult raw artifacts and reproduce analyses for new datasets.

• Resolution (example): ~0.05 nm reported in selected controlled experiments (dependent on calibration and measurement methods)
• Thermal Drift (example): ~0.1 nm/hour in specific fixtures
• Bandwidth (example): ~1 kHz observed in select closed-loop tests

Refer to docs/ for the input files, scripts, and exact experimental conditions used to generate these numbers.

The digital twin components provide example state representations, propagation utilities, and interfaces to integrate multiple physics domains. See the src/ modules and docs/ for runnable examples and configuration used in tests.

• Scope: Research prototypes and reproducible experiment examples. The repository is intended to document derivations, scripts, and example runs for researchers and maintainers.
• Validation: The project includes targeted validation artifacts for selected experiments (see docs/); CI checks cover a small set of algebraic identities and example inputs where available. Validation is not exhaustive.
• Limitations: Reported performance depends strongly on fabrication quality, environmental control, calibration, and the numerical methods used. Deterministic or long-term operational guarantees are not established by these example runs.

If you plan to reuse or cite reported performance, attach the raw data, the exact script/parameters, and UQ artifacts (e.g., docs/UQ-notes.md, docs/benchmarks.md) to support reproducibility and context.

• Reproduce numeric experiments by creating an isolated Python environment and installing required packages (see requirements.txt when present). Use the provided data/ inputs and re-run the scripts in scripts/ and src/.
• For determinant or ill-conditioned computations, increase precision (e.g., mpmath or sympy with higher precision) and run scripts/uq_determinant_stability.py to assess conditioning.
• Use scripts/ that record random seeds and environment metadata to improve reproducibility. Attach those artifacts when reporting performance figures.

Several example validation scripts are included; these are targeted checks rather than exhaustive V&V:

• Monte Carlo sensitivity and coverage checks for selected scenarios (examples in docs/)
• Conditioning and stability checks for determinant-based computations
• Cross-checks against material and dispersion models imported from related repositories

See docs/ for concrete run instructions and the input files used in the example experiments. Example scripts in scripts/ demonstrate how to reproduce key analyses and export artifacts.

Contributions should include reproducible artifacts (inputs, environment, exact script commands, and UQ summaries) for any numeric claims. Open an issue or PR with data attachments and a short description of the validation performed.

This repository is intended as a research-stage collection of models, scripts, and experimental artifacts. Numeric summaries are provisional and should be reproduced with the provided artifacts before being cited or used beyond the documented test configurations.