Globe-Box Approach (Printable Earth)

This document captures how model-render-print-box turns the GDEM data on the shared /datasets volume into STL models that load into a slicer and print on a 3D printer. It is a decision log; mark each option decided with a date and reason.

Goal

A small desk globe, 100 mm in diameter at sea level, that prints as two halves divided at the equator plus a third piece — a hollow twist-lock cylinder that joins the halves. The Earth’s surface comes from the ETOPO 2022 dataset (/datasets/dataset-etopo-2022/, 15-arcsecond GeoTIFF tiles, read-only). The set is three STL files that: - load into OrcaSlicer / PrusaSlicer (binary STL, millimeters, watertight), - print on a common FDM printer (each half’s rim is a flat annulus that sits on the bed, dome up), - assemble into a sphere whose hemispheres meet at the equator with an aligned relief seam, locked by twisting the two hemispheres in opposite directions (the ring is entirely inside).

Source data

• ETOPO 2022 — global relief model combining land elevation and seafloor bathymetry at 15-arcsecond (~450 m) resolution, as 350 GeoTIFF tiles.
• Maintained and versioned by the model-elevation-earth project; the manifest is /datasets/manifest.yml (etopo-2022).
• Read-only consumption: this project never writes to /datasets; derived pieces go in dataflow.out/box/.

Candidate approaches

1. Two hemisphere halves + twist-lock cylinder — CHOSEN (decided 2026-08-27)
   • The globe is split at the equator into a northern half (lat 0..90) and a southern half (lat -90..0). Each half is a hollow shell: the outer surface is the sphere at radius radius_mm + relief, the inner surface is a sphere at radius_mm - wall_mm with a cylindrical socket (bore) at the rim of radius socket_radius_mm for socket_depth_mm. The rim is a flat annulus at z = 0 that sits on the print bed.
   • The third piece is a hollow cylinder whose outer surface mates with the halves’ sockets. It is entirely INTERNAL: a plain tube spanning the two sockets, with no protruding band, so the hemispheres’ rims meet at the equator (decided 2026-08-31). Locking is done by twisting the two hemispheres, so the ring needs no grip.
   • Bayonet lock: 3 pins on the cylinder near each end, at 0/120/240 degrees, engage L-shaped grooves cut into the socket bores. Insert the cylinder into one half (pins aligned to the groove entrances), slide the other half over the far end, then twist the two hemispheres in OPPOSITE directions by twist_degrees (30) — both pin sets ride into both halves’ grooves at once, and the ring stays put (held by its friction fit). Two hands, one on each hemisphere, lock and unlock the globe (the natural two-hand motion).
   • The two halves’ grooves are generated with the SAME handedness in their own STL frames (both -twist); the south half’s assembly flip (180 deg about x) reverses its azimuth, so in the assembled globe the north grooves turn -twist and the south +twist — OPPOSITE handedness, which is what an opposite-direction two-hand twist needs.
   • The north half’s groove pattern (axial channels AND circumferential grooves) is rotated +2 x twist_degrees (60) in its STL frame, so at insertion the north relief starts 2 x twist degrees WEST of the south half’s. Twisting north +30 and south -30 (opposite directions) brings both halves to the same rotation, so the relief seam is aligned when locked (decided 2026-08-31).
   • History: without the offset, an opposite-direction twist locked the halves 2 x twist_degrees (60 deg) apart and offset the relief seam (measured ~50 deg); a same-direction twist aligned them but felt unnatural. The offset gives the natural two-hand motion AND an aligned seam.
2. Threaded halves — rejected (decided 2026-08-27)
   • The two halves screw together directly on a thread at the rim. Simple to print, but the halves rotate many turns relative to each other during assembly, so the relief seam ends up at an arbitrary longitude unless the thread pitch is engineered for exact alignment; the bayonet avoids that with a fixed 30-degree stop.
3. Full solid globe / stacked rings — deferred (decided 2026-08-27)
   • Prints a solid sphere or concentric rings; heavier, larger than the bed at useful sizes, and the task asks for two halves plus a twist-lock.

Geometry (per piece)

• radius_mm (default 50): the sea-level sphere radius; the globe is 100 mm in diameter at sea level.
• relief_mm (default 4): land elevation mapped over the global ETOPO range. The standard build uses flat oceans (--oceans-flat): water cells clamp to sea level, so the ocean surface is exactly the sea-level sphere (decided 2026-08-27, matching model-render-print).
• wall_mm (default 3): shell wall; the inner sphere radius is radius_mm - wall_mm.
• socket_radius_mm (default 43) and socket_depth_mm (default 13): the cylindrical bore at each half’s rim that receives the cylinder. The socket radius is smaller than the inner sphere radius, so the cavity opens out above the socket (the ledge is hidden inside the globe).
• Twist-lock cylinder: outer radius socket_radius_mm - clearance_mm (clearance 0.2 for FDM, reduced from 0.3 on 2026-08-27 after the first prints: the fit was good and a 85.6 mm OD cylinder tightened the join without changing the hemispheres), wall 2.5 mm, and a total length of 2 x cylinder_socket_length_mm (24 mm) — a plain tube with NO band (band_width_mm 0, set 2026-08-31: the ring is entirely inside the two sockets, so the hemispheres’ rims meet at the equator). With a positive band_width_mm the ring instead carries a knurled band of radius radius_mm + relief_mm + 1.5 that stays outside at the seam as a grip.
• Pins: pin_count (3) at 0/120/240 degrees, pin_height_mm (1.6), radius 2 mm, axial length 4 mm, sitting pin_distance_from_end_mm (3) from each cylinder end so they land at the groove depth when seated.
• Grooves: axial channel groove_width_degrees (7) wide and axial_channel_depth_mm (9) deep from the rim, then a circumferential groove of groove_axial_width_mm (4.5) turning twist_degrees (30).

South half mirroring

• The south half is generated in the same print orientation as the north (rim at z = 0, dome up) but samples mirrored longitude: the relief at STL longitude lon is the ETOPO elevation at geographic longitude -lon. When the printed south half is flipped over for assembly (rotated 180 degrees about the x axis), its surface shows the true relief, and the two halves’ rim rings carry the same relief at every longitude — the seam is continuous.
• The grooves of the two halves are generated with the SAME handedness in their own STL frames (both -twist); the south half’s assembly flip reverses its azimuth, so in the assembled globe the two halves’ grooves turn in OPPOSITE directions (north -twist, south +twist). Locking is a two-handed twist: turn the hemispheres in opposite directions (the natural two-hand motion) and the ring stays put (held by its friction fit). The north half’s groove pattern is offset +2 x twist in its STL frame, so the north starts 2 x twist west of the south and the opposite twists bring the halves to the same rotation — the seam is aligned when locked (decided 2026-08-31). Verified in tests/04-globe-box-math.sh.

Print and assembly notes

• Each half prints rim-down: the flat rim annulus sits on the bed and the dome rises, so no supports are needed under the shell (the dome is self-supporting; the interior cavity is open at the rim).
• The cylinder prints on one of its flat end faces, or lying on its side with light supports for the pins.
• Assembly: push the cylinder into one half with the pins aligned to the groove entrances (the entrances are visible at the rim), slide the other half over the far end until the rims meet at the equator, then twist the hemispheres in OPPOSITE directions 30 degrees each (the ring stays put — held by its friction fit). To disassemble, twist the halves back and pull them apart.
• Because the ring is entirely internal, the assembled globe is a clean sphere: the hemispheres’ rims meet at the equator with no visible band.
• Because the north half starts 2 x twist west of the south and the opposite twists bring both to the same rotation, the relief seam is aligned when locked (see the mechanism note under Candidate approaches).
• Clearances are sized for a 0.4 mm nozzle; expect to tune clearance_mm, pin_height_mm, and groove_depth_mm after the first print (tracked in TODO.md).