Astro World — Field Guide

pics-anim-pi-pixi.html · a field guide · volume two

The Astro World

The same tank, a different universe. Press ✦ Astro and the society is replaced by softened Newtonian gravity: a spinning cloud that collapses, orbits, flattens into a disk and accretes into planets. This page maps the physics and the knobs.

Part one

The physics

Physics · Origin

Two missing ingredients

Watching the flock cluster under cohesion-vs-temperature looks like star formation — but the mechanics differ in exactly two ways. Flock cohesion is a short-range, overdamped nudge on bodies that all move at one fixed speed. Gravity is long-range (every pair attracts, however far) and acts on bodies with momentum — they fall, overshoot, and orbit. Astro mode adds precisely those two ingredients and removes the society: no breeding, no disease, no predators. Bodies only ever merge or escape, so the count only falls.

force G·m / (r² + ε²) — softened Newton, all pairs O(N²) integration semi-implicit, real momentum inertia < 1 adds drag → orbital decay, the bridge back to flock motion society systems off — ☄ overlay counts bodies, never up

Physics · Stability

A knife-edge called virial balance

Long-lived orbiting structure exists only in a narrow band: kinetic energy must sit near half the gravitational binding energy. Slower → collapse; faster → the cloud unbinds. That is real astrophysics, and it is why the sliders feel delicate. Two protections widen the sweet spot: moving gravity live rescales every velocity by √(G′/G) so the balance rides along (structures tighten or relax instead of shattering), and the integrator subdivides its steps whenever anything would move further than the softening length can resolve — without that, close encounters inject phantom energy and the cluster boils into noise.

Softening. Raw 1/r² diverges at contact — slingshots to infinity. The ε term caps the force at close range; big ε = gentle porridge, small ε = violent encounters.
Inertia. At 1.0 a body falls past the centre and returns — an orbit. Below 1.0, drag bleeds the motion and it spirals in: overdamped, flock-like.
adiabatic G: v × √(G′/G) on every live change adaptive substeps ≤ ×4, step ≤ ½ ε sim speed = base substeps per frame

Physics · Disk formation

Birth of a pancake

The cloud seeds as a 3D ball spinning about an axis tilted 65° from your line of sight — because a disk whose spin axis points at the viewer forms face-on, and flattening along the line of sight is invisible. Tilted, you watch the collapse edge-on, like an inclined galaxy. But rotation alone is not enough: a collisionless system conserves energy, so bodies oscillate through the plane forever and the cloud stays a puffy spheroid — real stellar systems never flatten. Disks need dissipation. The settle (gas) slider damps only the motion along the spin axis, the way colliding gas radiates energy away while angular momentum protects the rotation: the cloud thins into a rotating band before your eyes.

Settle 0 — stars. Energy conserved: eternal vertical oscillation, a puffy spheroid forever. Physically correct, pancake-free.
Settle > 0 — gas. Vertical motion dies, rotation survives: the same cloud flattens into a thin inclined disk.
spin 0 — cold collapse: plunge, bounce, swarming ball spin ≈ 0.8 — rotating disk (acts at seed time) settle 0 = stars · 0.02 = gas (default) depth 0 = flat 2D — every 3D term vanishes exactly

Physics · Growth & decay

Accretion and evaporation

Not every collision sticks. A contact merges — conserving mass and momentum — only when the bodies meet slower than their mutual escape speed (× the stickiness slider); harder hits bounce inelastically. So the hot young disk resists clumping, every bounce sheds energy, and accretion accelerates as the disk cools — the way real disks grow. Size grows as ∛mass and heavy bodies gain a glow. Growth is hierarchical and runaway — grains sweep up grains, planetesimals sweep up planetesimals, until a few massive survivors orbit each other. The counter-current is evaporation: close encounters slingshot bodies outward while the core tightens (gravitating systems get hotter as they lose energy — the famous negative heat capacity of star clusters). Escapers past 12× the half-mass radius are removed; they were never coming back.

Accretion. Merges conserve mass and momentum; radius grows as the cube root, so giants rise slowly out of the dust.
stick below stickiness × vesc · harder hits bounce (e 0.4) growth 0.10 — chance per frame a bound pair fuses; the timeline dial grains collide compact (35% of drawn size) — the disk phase survives merge radius tracks image scale — 0.1× default keeps accretion gradual stickiness 0 = bouncing gravel — nothing ever sticks accretion off = fully collisionless — bodies pass through 700 grains at seed (astro default)

Part two

Watching it

Watching · The camera

A camera that frames the mass

There are no walls in astro, so a camera has to choose what matters. It tracks the centre of mass and zooms to frame the half-mass radius — the standard astrophysical measure of a cluster's core. Mass-weighted, so a runaway minority of escapers can't drag the view out, and once accretion builds heavy bodies the camera stays on the mass, not the leftover dust. Positions use the true zoom; sizes use √zoom — the cartographer's compromise (astronomy software draws stars by brightness, not true angular size): bodies stay visible when the camera pulls far out and don't balloon when it dives in. Floors guarantee nothing ever renders below ~6 px or a hairline trail.

frame ≈ 2.5 × R½, envelope-smoothed — widens instantly, contracts slowly endgame (≤12 bodies): every survivor stays in shot zoom clamped 0.05–4× · sizes ∝ √zoom perspective CoM-relative, clamped 0.25–2.2× bodies are shaded balls; your loaded image wins if present

Watching · Recipes

Five experiments

Enter ✦ Astro and the defaults already give the pancake. From there, one knob at a time:

The pancake (default). depth 400 · spin 0.8 · settle 0.02 · inertia 1.0 — a 3D cloud collapses, wobbles, and thins into a rotating inclined band with long orbit trails on black.
Stars vs gas. Set settle 0, re-seed: the identical cloud now stays a puffy spheroid forever. One slider toggles between simulating a star cluster and a gas cloud.
Cold collapse. spin 0 · settle 0 · accretion off — radial plunge, overshoot through the centre, a breathing swarming ball: a miniature globular cluster.
Planet factory. Accretion on in a disk; nudge image scale up to make grains stickier. Watch glowing giants rise, then a final few survivors orbit each other.
Letting go. Mid-disk, sweep gravity → 0: the whole structure sails apart in straight lines — nothing was holding it but the force you just removed.
gravity 0–400 · pace & tightness (adiabatic live) inertia 0–1 · orbits ↔ orbital decay softening 1–40 · violence of close encounters spin 0–1.5 · at seed settle 0–0.10 · stars ↔ gas sim speed 1–8 · substeps initial spread — reused speed slider · seed dispersion