Daylight
Windows, glass area, the way each room faces and its hours of direct sun on a chosen day.
What it answers
Section titled “What it answers”- Which bedroom gets morning sun?
- Is the living room bright in winter?
For the agent, the tool is described as: For one scan, per room: window count and glazed area from the wall graph, the compass direction of each window and the hours of direct sun on a date. Returns a lens of sun hours per room and findings for rooms with no window. Directions are low confidence until the scan’s compass rotation is verified.
Who it is for
Section titled “Who it is for”Light sleeper or night-shift worker, Film or photo location scout, Office tenant, Older adult or family, Remote worker, Renter checking a listing’s claims, Renter checking a listing, Plant lover or home office worker choosing a room, Agent or host staging a home virtually.
Inputs
Section titled “Inputs”| Input | Type | Required | Default | Notes |
|---|---|---|---|---|
scan |
string | yes | Scan id. Filled from the selected building. | |
date |
string | Day to trace the sun on, YYYY-MM-DD; today if empty. Saved preference daylight.date. |
An input that nothing fills (the selected building, a saved preference, a persona’s preset) becomes a question to the person. The agent asks only for those.
Data used
Section titled “Data used”| Layer | Id | Needed | If it is missing |
|---|---|---|---|
| Doors and windows | matterport.openings |
required | The verdict is unknown, with the reason. |
| Scan position | matterport.geo |
optional | window counts and glass area only |
What it returns
Section titled “What it returns”A tool result: a verdict (pass, warn, fail or unknown), metrics, checks and findings, each with its source.
- Draws on the building: a colour per room.
- Panel blocks:
VerdictHeader,MetricRow,MiniChart,CheckList,FloorPlanMini,Controls,AssumptionChips,StepLog. - Speed: fast. Read-only.
How it works
Section titled “How it works”Daylight: per room, how many windows, how much glass, which way they face and how long the sun reaches them.
Reliability
Section titled “Reliability”Sources this tool gave on the test home:
| Where it came from | Layer | Method | Reliability | Note |
|---|---|---|---|---|
| Measured from the scan | matterport |
geometry |
high | Window widths and heights in the wall graph |
The tool sets the label for each value. A model never does. The tools give a scan’s wall graph the layer matterport whichever device made the scan, so a phone scan’s geometry carries that label too.
Limits
Section titled “Limits”- Needs: doors and windows. On a scan without it, the verdict is
unknownand says why. - A result is a planning aid, not an inspection.
On the made-up test home
Section titled “On the made-up test home”This section was written by running the tool when the docs were built, on a hand-made RoomPlan export (no real place was scanned), with no sponsor keys and the network switched off.
Pass 5 windows over 5 rooms. This scan has no geocoordinates. Hours of sun cannot be traced.
| Value | Result | Where it came from | Reliability |
|---|---|---|---|
| Windows | 5 | Measured from the scan | high |
| Glass area | 6.6 m² | Measured from the scan | high |
| Glass to floor | 8 % | Measured from the scan | high |
| Rooms with no window | 0 | Measured from the scan | high |
| Check | Measured | Against | Status |
|---|---|---|---|
| Direct sun, Bedroom | not measured | pass | |
| Direct sun, Bedroom | not measured | pass | |
| Direct sun, Living Room | not measured | pass | |
| Direct sun, Kitchen | not measured | pass | |
| Direct sun, Bathroom | not measured | pass | |
| Direct sun, Hallway | not measured | unknown |
What it reported while it ran:
- Read windows in 5 rooms from the wall graph
- No sun trace: This scan has no geocoordinates.
Run it
Section titled “Run it”threshold run daylight --scan <scan-id>curl -X POST http://127.0.0.1:8787/api/tools/daylight/run -H 'content-type: application/json' -d '{...inputs}'Over MCP the tool is named daylight. See MCP server and CLI.