{ "_comment": "One config per town. Paths are relative to this file. Copy it next to your map and edit every value.", "town": "Exampleburg", "map": { "path": "map.png", "meters_per_px": 0.5, "origin_px": [1200, 800], "_how": "meters_per_px: calibrate on something of known size on the map (a canon building, a bridge span). origin_px: the bitmap pixel that is world (0,0); pick a landmark so world coordinates stay readable." }, "massing": { "town_npz": "town.npz", "min_house_m2": 40, "core_density": 0.16, "default_core_zone": 2, "default_edge_zone": 1, "water_depth_m": 3.0, "zones": { "1": {"name": "outskirts, poor", "eaves_min": 2.8, "eaves_max": 4.2, "pitch": 0.70}, "2": {"name": "dense core, modest", "eaves_min": 4.6, "eaves_max": 7.2, "pitch": 0.85}, "3": {"name": "wealthy quarter", "eaves_min": 7.0, "eaves_max": 10.4, "pitch": 0.80, "polygon_px": [[900, 300], [1500, 300], [1500, 700], [900, 700]]} }, "cutouts": [ [[1180, 760], [1240, 760], [1240, 840], [1180, 840]] ], "_how": "zones: eaves ranges by wealth; the map gives footprints, never heights. A zone with polygon_px is assigned by position; the rest by roof density. cutouts: polygons (map px) of landmarks you model by hand in scene.json so the auto-massing does not double them." }, "terrain": { "path": null, "snowline_m": 1050, "_how": "optional terrain.npz with H (m above the town ground plane, 2D), cell (m), x0, y1 (world m of the top-left cell). Leave null for a flat site. Terrain is almost never on a map; what you build is a proposal and your report must say so." }, "world_extent_m": [-6000, 6000, -5000, 5000], "suns": { "day": {"az": 248, "el": 24}, "sunset": {"az": 297, "el": 1.5}, "morning": {"az": 128, "el": 29}, "_how": "azimuth clockwise from north, elevation in degrees. Pick a date and hour for your latitude; write the hour into the light prompt block too, so the plate's shadows and the prompt agree." }, "views": "views.json", "scene": "scene.json", "plates_dir": "plates", "renderer": { "adapter": "openai_images", "model": "gpt-image-2.5-flare", "quality": "high", "size": "2048x1152", "cost_usd": {"per_call_1ref": 0.06, "per_call_4ref": 0.09}, "_how": "Credentials never live here: export IMAGE_API_KEY and optionally IMAGE_API_BASE. cost_usd is what the Cost line uses; measure your own." }, "gates": { "landmark_groups": "castle,library,gate", "figure_band": 0.25, "_how": "landmark_groups: solid groups from scene.json whose region gets its own gradient-correlation score and which the invented-structure check treats as allowed skyline." } }