pantometry-thermal

Heat as a simulation domain: lumped masses, explicit conduction, radiative and convective loss


Keywords
conduction, heat, physics, simulation, thermal, acoustics, computational-physics, elasticity, electromagnetism, fluid-dynamics, heat-transfer, molecular-dynamics, multiphysics, optics, physics-engine, porous-media, rust, scientific-computing, visualization
Licenses
MIT/Apache-2.0

Documentation

pantometry

CI crates.io docs.rs

Physics for simulated worlds — a kernel that knows nothing about any particular physics, and thirteen domains built on it that do: light, heat, motion, sound, electricity, electromagnetic fields, elastic deformation, incompressible flow, flow through a packed bed, matter one atom at a time, a quantum wavefunction in a well, and a drug distributing through a body. Two layers above them place a simulation in the world and draw it, and neither knows a domain either.

Dimensions live in the type system, so Length + Time does not compile. Conservation is audited rather than assumed, and a Violation names what went missing and where. Every result is reproducible bit for bit — across platforms, across optimisation levels, in WebAssembly, and under sixteen threads as readily as one.

Every claim is checked against a closed form or an independent computation, never against another implementation that might be wrong in the same direction. Where no closed form exists, EVIDENCE.md says so.

A cemented achromat traced in three colours, crossing the axis within a tenth of a millimetre

cargo run --release --example lens_spots -- lens.svg. Every figure here is the output of an example CI runs on every commit, and every example checks itself against a closed form.

Install

cargo add pantometry     # one dependency, all nineteen published crates
pip install pantometry   # or from Python — see bindings/python
pantometry = "0.21"

Run

In a clone of this repository:

cargo run --release --example melting            # a crystal melting, read off its own structure
cargo run --release --example beam_hot_spot      # a laser on a mirror, and the hot spot a lumped
                                                 # model misses
cargo test --workspace                           # the suite, all against closed forms

Add an output path to any example and it draws the result:

cargo run --release --example lens_spots -- lens.svg

Everything a person runs is one binary, in app/ — the CLI, the viewer, the editor and the GPU accelerator:

cd app
cargo run --release -- run    scene.json out.html   # run it and write an asset, by extension
cargo run --release -- verify scene.json --deep     # margins, determinism, sweeps, geometry
cargo run --release -- edit   scene.json            # the editor: check as you type, run, verify

pantometry edit with no file opens on a start screen: a new project, a scene to open, or one you had open before.

The editor: an outliner, the scene as JSON, a shaded viewport and an inspector

pantometry edit 29-a-designed-bracket-becomes-cells.json --run. An L-bracket designed as an STL, filled into 4 100 cells at 2 mm and cooling to still air. The scene is the text on the left and the picture is what running it produced — the readings, the colour bar and the frame transport are the run's, and the note in orange is the mesher saying what it did.

Temperature along a bar under a laser, at five times, against the lumped mean

A laser on a mirror. The thin line is the lumped mean, which every curve has exactly — and the thick ones are what a lumped model cannot tell you: the peak is well above it.

Where everything else is

read for
AGENTS.md the whole API on one page. cargo run --example agents_quickstart is a runnable version, including a deliberate 10% energy leak so you can see what the audit says
ARCHITECTURE.md the map: three layers, the nineteen crates, what is built, what is missing, and what is deliberately not here
EVIDENCE.md how the claims are checked, and what checking them found — including two real defects the conservation audit reported as clean
EXAMPLES.md every example and what it demonstrates
app/README.md the binary: CLI, viewer, editor, accelerator
CONTRIBUTING.md the conventions, and everything CI runs in the order it runs it
CHANGELOG.md what was found, as well as what was added
CLAUDE.md working on pantometry rather than with it

There is one consumer, pantometry-world, and its first job was not to be a good application but to use the SDK the way a stranger would. app/pantometry-world/FRICTION.md is what it came back with: forty-eight findings, forty-three fixed and five argued down in writing. Not one of the library's own tests could have found any of them — a test is written by somebody who already knows the shape.

Citation

If this software contributes to work you publish, please cite it. CITATION.cff is beside this file and GitHub renders it as a Cite this repository button; the same content as BibTeX:

@software{park_pantometry,
  author  = {Park, Younghyeon},
  title   = {pantometry: physics for simulated worlds, checked against closed forms},
  version = {0.21.0},
  year    = {2026},
  doi     = {10.5281/zenodo.22233493},
  url     = {https://doi.org/10.5281/zenodo.22024817},
  note    = {ORCID: 0000-0002-4733-5049. The `doi` is 0.20.0's; the `url` is the concept DOI,
             which always resolves to the newest version. Both move with a release --
             this block named 0.16.0 through the whole of 0.17.0, and its `version`
             was left at 0.19.0 through the 0.20.0 bump because no list covered it},
  license = {MIT OR Apache-2.0}
}

Co-authorship is not requested, and here is why that is the honest answer

It would be easy to write "please add me as an author" here, and it would be wrong on three counts.

It could not be required. MIT OR Apache-2.0 is already granted irrevocably, and a licence with an authorship condition attached would no longer be an open-source licence under the OSI definition — it would impose a restriction the two licences people already rely on do not have.

It is contrary to how authorship works. ICMJE and COPE both rest authorship on an intellectual contribution to the specific work being published. Supplying a tool is not that, however much work the tool was. Authorship asked for on those grounds is what the literature calls gift or honorary authorship, and an editor who saw it as a condition of use would strike it.

And it would cost the thing it was reaching for. A tool with a tax on it loses users, and users are where citations come from.

What is invited instead

If you build something with this, I would like to hear about it — and if there is a question the library cannot answer yet, open an issue. Where that turns into real involvement in your work — a domain built for your problem, an analysis argued through together — a joint contribution is earned in the ordinary way, and I am glad to do it. That is an invitation and not a condition.

An acknowledgement, if the work does not warrant more, is always welcome and never expected.

Licence

Dual-licensed under either MIT or Apache-2.0 at your option — the Rust ecosystem's convention, and not indecision. Each covers a gap the other has. Apache-2.0 carries an explicit patent grant and MIT does not, which is the first thing a corporate legal review asks about. MIT is compatible with GPLv2 and Apache-2.0 is not, which matters here because the scientific-computing world has plenty of GPLv2 code. Offering both lets a consumer take whichever they need, so OR is strictly less restrictive than either alone.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 licence, shall be dual-licensed as above, without any additional terms or conditions.

Every dependency is permissive too, and that is checked rather than remembered: deny.toml holds an allow-list and CI fails on anything outside it. Twelve external crates at the time of writing, of which three reach a published artifact — glam, serde and serde_core, all under the same MIT OR Apache-2.0. serde_json and its three transitive crates are a dev-dependency of four of the published crates, so they reach no artifact either. The rest are compile-time or test-only.

Two crates were added in 0.9.0 and the count did not move. pantometry-view has no dependency at all beyond pantometry-scene: SVG and HTML are text, so a renderer is a format! and a file write, and the alternative would have put a plotting stack into the tree of every consumer who wanted a picture.