# Room Reading → Revit (one page) Two ways in. Same result, same script inside. | | Dynamo graph | pyRevit button | |---|---|---| | Install | nothing (Dynamo ships with Revit) | pyRevit, once (free; needs rights to install add-ins) | | Each time | open the graph, pick the file, Run | click the button, pick the file | | Choose | level name, rooms on/off, phases on/off | defaults: level from the file, rooms, fixed elements and phases on | ## Dynamo (nothing to install) **Which file:** Revit 2027 → `room_to_revit_2027.dyn`. Revit 2025 or 2026 → `room_to_revit_2025-2026.dyn`. Same graph, different Python engine. 1. Open a new project from the **stock architectural template** (metric). Any project with a door and a window family loaded works. For bifold doors, load a bifold door family first (the graph uses it if its name says bifold or folding). 2. **Manage › Dynamo** (in some versions **Manage › Visual Programming › Dynamo**). Open the `.dyn` file. 3. In the green group, set: 1. **room_checked.json**: click *Browse…* and pick the file from the Room Reading output (one room or several joined, it's the same file). 2. **Level name**: leave blank and the graph uses the level in the file, or the level already at that height (the template's *Level 1*), or makes one. 3. **Place rooms and fixed elements**: true. 4. **Keep / strip / alter as phases**: true. 4. Run mode (bottom left) **Manual**, then **Run**. 5. Read the **Report** node: what was placed, anything skipped and why, doors whose hinge side to check, and true north. 6. Open the new view **RR – ‹level› – existing**. ## pyRevit (one button) 1. Install pyRevit from pyrevitlabs.io (once). 2. Unzip `RoomReading.extension.zip` somewhere permanent, e.g. `Documents\pyRevit\`. 3. pyRevit tab › **Settings** › *Custom Extension Directories* › add that folder › Save and Reload. 4. A **RoomReading** tab appears. Click **Room to Revit**, pick `room_checked.json`. The report opens in a pyRevit window. ## What lands - **Walls** on the reading's centrelines as single-layer types `EX_110mm`, `EX_230mm` … at the ceiling height in the file (2700 if none, and the report says so). - **Doors and windows** from the loaded families, as types sized to the reading (`RR_D_820x2040`, `RR_W_1600x1200`; `RR_BF_…` bifold, `RR_G_…` glazed, `RR_DD_…` double). Doors swing into the room they were read from, or out where the reading says `opens: out`. Windows face out. Plain openings as wall openings. - **Fixed elements** (fireplace, joinery, stair, kitchen, bath …) as simple Generic Model blocks at a nominal height. Voids are not modelled; the report lists them. - **Rooms** named and numbered from the reading (Number = `LOUNGE.R01`), with **Floor, Wall and Ceiling Finish** filled from the register. Room separation lines where the reading has no wall. - Every element's **Mark** is its reading id (`LOUNGE.W01`, `BED1.F01`). **Comments** read, for example, `ROOM-READING LOUNGE.D03 low | STRIP | HAZARD LOUNGE.X22 | HERITAGE LOUNGE.X41`. Schedule by Mark and Comments to walk the register against the model. ## Keep / strip / alter as phases - Everything is created in **Existing**. - **Strip** is demolished in the next phase (**New Construction** in the stock template). A door or window in a stripped wall goes with it; the Comments say so. - **Alter** stays Existing, flagged ALTER in Comments. - **Not decided** stays Existing, unflagged. The report counts them. - To see it: a plan view with Phase = New Construction and Phase Filter = *Show Complete* or *Show Demo + New*. Your decisions come from `room_checked.json`, which the Room Reading script writes after you fill `keep_strip_alter` in `register_room.csv` and run it again. Decide first, then go to Revit. ## Running it again After corrections: run Room Reading again, then in Dynamo flip **Run again** and press **Run** (or click the pyRevit button again). Everything the script placed last time (Comments starting `ROOM-READING`, and only that) is deleted and placed afresh. Anything you drew yourself is untouched. Don't type `ROOM-READING` at the start of your own Comments. ## Known limits - **Hinge side** is not set. The report lists the doors whose reading gives a hinge; use the flip arrows. - **Wall joins** follow Revit's rules. Tidy corners where the reading was loose. Joined rooms meet on the shared wall; check it once in plan. - **True north** is reported, not applied (it changes the project's coordinates). Set it yourself with *Manage › Location › Rotate True North* if you want it. - Revit measures rooms to wall faces, so its areas are a little smaller than centreline areas. That difference is correct. - A photo reading is a **starting sketch, not a survey**. Everything in the model carries the reading's confidence in Comments; nothing here is measured unless the register says so. - Tested against a stand-in for the Revit API (logic and call shapes, both graphs and the button). The test in real Revit is logged in `_BUILD_LOG.md`; until it says passed, treat the Revit route as a preview.