diff --git a/ATTRIBUTION.md b/ATTRIBUTION.md index 03098d4..72d99d3 100644 --- a/ATTRIBUTION.md +++ b/ATTRIBUTION.md @@ -30,6 +30,7 @@ is committed and listed here with its exports. | docs/media/examples/impact.png | FieldCraft contributors | Original: the FieldCraft window captured (`ui.capture`) with the solved impact sample (docs/examples.md) | MIT OR Apache-2.0 | | docs/media/examples/ibeam.png | FieldCraft contributors | Original: the FieldCraft window captured (`ui.capture`) with the solved ibeam sample (docs/examples.md) | MIT OR Apache-2.0 | | crates/ui-egui/thumbnails/ibeam.png | FieldCraft contributors | Original: the solved ibeam sample rendered by FieldCraft (`ui.render`, light theme), cropped to the model and scaled to 320 px wide (ImageMagick, 128-colour palette), the ibeam sample's thumbnail on the Start card | MIT OR Apache-2.0 | +| crates/ui-egui/thumbnails/heated-flow.png | FieldCraft contributors | Original: the heated-flow sample's temperature slice rendered directly at 320 × 213 by `fieldcraft-cli snapshot` with the CPU renderer; geometry is the original upright-bracket recipe | MIT OR Apache-2.0 | | docs/media/examples/parts.png | FieldCraft contributors | Original: the FieldCraft window captured (`ui.capture`) with the parts sample (meshes only, nothing to solve) (docs/examples.md) | MIT OR Apache-2.0 | | crates/ui-egui/thumbnails/flow-past.png | FieldCraft contributors | Original: the flow-past sample as docs/media/examples/flow-past.png shows it, rendered by FieldCraft (`ui.render`, light theme), cropped to the model and scaled to 320 px wide (ImageMagick, 128-colour palette), the flow-past sample's thumbnail on the Start card | MIT OR Apache-2.0 | | crates/ui-egui/thumbnails/cantilever.png | FieldCraft contributors | Original: the cantilever sample as docs/media/examples/cantilever.png shows it, rendered by FieldCraft (`ui.render`, light theme), cropped to the model and scaled to 320 px wide (ImageMagick, 128-colour palette), the cantilever sample's thumbnail on the Start card | MIT OR Apache-2.0 | diff --git a/crates/engine/src/cmd/forms.rs b/crates/engine/src/cmd/forms.rs index 49f3449..60a3ed4 100644 --- a/crates/engine/src/cmd/forms.rs +++ b/crates/engine/src/cmd/forms.rs @@ -1971,6 +1971,7 @@ pub const SAMPLE: &[Field] = &[choice( ("drop-test", "Drop test"), ("rubber-seal", "Rubber seal"), ("flow-past", "Flow past a bracket"), + ("heated-flow", "Heated flow past a bracket"), ("heated-bracket", "Heated bracket"), ("bracket-hex", "Hex-meshed bracket"), ("crank-arm", "Bicycle crank arm"), diff --git a/crates/engine/src/sample.rs b/crates/engine/src/sample.rs index 7ef03ca..ba266fd 100644 --- a/crates/engine/src/sample.rs +++ b/crates/engine/src/sample.rs @@ -18,6 +18,8 @@ use fieldcraft_geometry::Shape; use serde_json::{Value, json}; +mod heated_flow; + /// A sample the app offers (Help › Samples, the empty viewport, `file.sample`, `--sample NAME`). pub struct Sample { pub name: &'static str, @@ -92,6 +94,14 @@ pub const SAMPLES: &[Sample] = &[ prepare: None, script: |_| flow_past(), }, + Sample { + name: "heated-flow", + label: "Heated Flow Past a Bracket", + about: "Cool air passing an 80 °C bracket: temperature slices and signed wall heat, a small transient demonstration", + design: Some(UPRIGHT_BRACKET), + prepare: None, + script: heated_flow::script, + }, Sample { name: "heated-bracket", label: "Heated Bracket", diff --git a/crates/engine/src/sample/heated_flow.rs b/crates/engine/src/sample/heated_flow.rs new file mode 100644 index 0000000..5a6f4e0 --- /dev/null +++ b/crates/engine/src/sample/heated_flow.rs @@ -0,0 +1,58 @@ +//! A small transient heated-flow demonstration using the original upright bracket. +//! Air at 20 °C passes an 80 °C bracket; no buoyancy or conjugate solid conduction. + +use fieldcraft_geometry::Shape; +use serde_json::{Value, json}; + +pub(super) fn script(bodies: &[Shape]) -> Value { + let walls: Vec = bodies + .iter() + .filter(|b| b.name == "Bracket") + .flat_map(|b| { + b.faces().iter().map(move |f| { + json!({ + "face": {"body": b.name, "face": f.name}, + "condition": {"type": "temperature", "value": 80.0} + }) + }) + }) + .collect(); + let [density, viscosity] = super::AIR; + json!([ + {"command": "model.units", "params": {"system": "mm-t-s-N-MPa"}}, + {"command": "model.material.create", "params": {"name": "Air", "density": density, + "fluid": {"type": "newtonian", "viscosity": viscosity}, + "thermal": {"conductivity": 0.026, "specific_heat": 1.005e9}}}, + {"command": "model.fluid_domain.create", "params": { + "name": "WarmAir", "material": "Air", "min": [-30, -20, 0], "max": [100, 60, 70], "spacing": 5, + "faces": {"x_min": {"type": "velocity", "velocity": [1, 0, 0]}, "x_max": {"type": "pressure", "pressure": 0}, + "y_min": {"type": "slip"}, "y_max": {"type": "slip"}, "z_min": {"type": "wall"}, "z_max": {"type": "slip"}}, + "obstacles": ["Bracket"], "initial_velocity": [1, 0, 0], + "thermal": {"initial_temperature": 20, "surfaces": walls, + "faces": {"x_min": {"type": "temperature", "value": 20}}} + }}, + {"command": "model.step.create", "params": {"name": "HeatedFlow", "procedure": { + "type": "fluid", "domain": "WarmAir", "steps": 180, "frames": 6 + }}} + ]) +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn heated_flow_sample_solves_and_exposes_temperature_and_wall_heat() { + let mut s = crate::Session::default(); + s.execute("file.sample", &json!({"name": "heated-flow"})).unwrap(); + s.execute("solve.fluid", &json!({"backend": "cpu"})).unwrap(); + let report = s.execute("results.slice", &json!({"field": "temperature"})).unwrap(); + let max = report["contour"]["range"]["max"]["value"].as_f64().unwrap(); + let min = report["contour"]["range"]["min"]["value"].as_f64().unwrap(); + assert!(max > 20.1 && max <= 80.01 && min >= 19.99, "{report}"); + let report = s.execute("results.surface", &json!({"field": "wall_heat_flux"})).unwrap(); + assert_eq!(report["contour"]["unit"], "mW/mm²"); + assert!(report["wall_heat"]["faces"].as_array().unwrap().iter().any(|f| f["power"].as_f64().unwrap_or(0.0) < 0.0)); + assert_eq!(report["frames"].as_array().unwrap().len(), 7); + } +} diff --git a/crates/ui-egui/src/samples.rs b/crates/ui-egui/src/samples.rs index 0698197..a3992b8 100644 --- a/crates/ui-egui/src/samples.rs +++ b/crates/ui-egui/src/samples.rs @@ -20,6 +20,7 @@ const THUMBNAILS: &[(&str, &[u8])] = &[ ("heated-bracket", include_bytes!("../thumbnails/heated-bracket.png")), ("bracket-hex", include_bytes!("../thumbnails/bracket-hex.png")), ("flow-past", include_bytes!("../thumbnails/flow-past.png")), + ("heated-flow", include_bytes!("../thumbnails/heated-flow.png")), ("cantilever", include_bytes!("../thumbnails/cantilever.png")), ("impact", include_bytes!("../thumbnails/impact.png")), ("parts", include_bytes!("../thumbnails/parts.png")), diff --git a/crates/ui-egui/thumbnails/heated-flow.png b/crates/ui-egui/thumbnails/heated-flow.png new file mode 100644 index 0000000..e7d376d Binary files /dev/null and b/crates/ui-egui/thumbnails/heated-flow.png differ diff --git a/docs/examples.md b/docs/examples.md index eaeea9c..c37a9da 100644 --- a/docs/examples.md +++ b/docs/examples.md @@ -6,7 +6,7 @@ press **Solve** (`solve.run`). Each opens fully defined — geometry, mesh, mate conditions, loads and steps — in mm, t, s, N and MPa, and opens and solves within half a minute. The geometry is our own: SolidCraft scripts run when the sample opens (a recipe from [`tests/corpus`](../tests/corpus) or one written in `crates/engine/src/sample.rs`). Each sample has a test in -`crates/engine/src/sample.rs` that opens it, checks it clean, solves it and holds its result to +`crates/engine/src/sample.rs` or its modules that opens it, checks it clean, solves it and holds its result to the check given below. ## Drop test (`drop-test`) @@ -200,3 +200,22 @@ SolidCraft geometry with persistent face names, swept all-hex (hex8 of 4 mm, inc clamped at `F2:start` and loaded with 1000 N down through a kinematic coupling to `F2:top`. **Look at:** the bending stress in the flanges, highest at the clamp; the tip moves 0.18 mm down (beam theory with shear: 0.184 mm). + +## Heated flow past a bracket (`heated-flow`) + +Air at 20 °C enters at 1 mm/s and passes the original upright bracket, whose faces are +held at 80 °C. The 130 × 80 × 70 mm domain has 5 mm cells (5,824 cells), a pressure outlet, +slip sides and top, and a no-slip floor. There are 180 steps and six saved output intervals, +plus the initial frame. Open `file.sample {"name":"heated-flow"}` and solve on CPU or GPU. +The slow prescribed flow keeps this coarse lattice away from its small-relaxation-time limit. + +**Look at:** Results → Temperature, or `results.slice {"field":"temperature"}`, for the +warming air. `results.surface {"field":"wall_heat_flux"}` shows heat received by each +bracket face per area: the hot wall heating the air is negative. In this model's mm–tonne–second +units the wall flux is mW/mm². The initial frame has no recorded wall heat and stays uncoloured. + +**Check:** the fluid warms above its inlet temperature while staying below the held wall +temperature (with a small numerical tolerance); recorded hot walls give heat to the fluid. +This coarse, short transient is a quick display demonstration, not a converged convection +benchmark. It has neither buoyancy nor solid heat conduction. The sample is isolated in +`crates/engine/src/sample/heated_flow.rs` and its gallery registration.