# Architectural Compliance

Upload a drawing set or building model and get a report of what passes, what fails and what needs a look under IRC, IBC and ADA.

A permit set that comes back from plan review with a narrow door or a missing smoke alarm costs a resubmittal and weeks. At Acme Precision, the project architect imports the Lakeside Residence model before the set goes out, and the check flags that a bedroom has no emergency escape opening while there is still time to fix it.

[Add it from the Marketplace](/tenant/?open=settings/marketplace)

## What it does

Architectural Compliance checks building drawings and models against building codes: **IRC 2021**, **IBC 2021** and **ADA 2010**. Each finding gives the code section, the element or sheet where it appears, and a suggested fix. Anything the drawings don't show clearly enough is marked as needing review, never passed.

The module has one page, with:

- **The file list**: every drawing set and model you import, with its **Name**, **Kind** (with a readiness grade), **Size**, **Details** and **Imported** date, and icons to run a check, view in 3D, open the latest report, download or delete.
- **The upload area**: **Drop drawing sets or models here**, with the **File requirements for designers** link.
- **The type buttons**: **All**, **PDF**, **IFC**, **STEP**, **SketchUp** and **Shapefile**.
- **Runs**: every check that has been run.
- **The compliance report**: the counts, the findings that need attention, and a checklist of every rule.

It reads PDF drawing sets, IFC models (for example exported from Revit) and SketchUp models for checking. STEP files and shapefiles are stored only, and IFC and STEP models can be viewed in 3D.

## Set it up

A Workspace Admin does this first.

1. There are no settings to fill in. **Module Settings**, from the ⋮ on the **Architectural Compliance** sidebar row, shows the version you have. See [Module settings and versions](article:fb7c92e4-6dcc-4ef4-80bc-1b6e7482e540).
2. Checks on PDF drawing sets use AI to read the drawings, with the workspace's own AI provider key. Add it in **System Settings → AI Providers**. IFC and SketchUp checks don't need it.
3. Give the permissions to your own roles (see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f)). Everyone can read files and reports out of the box; only Admin can import, run checks and delete. Give code reviewers both **Run a code check** and **Manage code sets and rules**: the check window needs both.
4. Send whoever prepares the drawings the **File requirements for designers** page, linked in the upload area. It explains how to export each file type so the check can read it, and ends with a checklist.
5. Import your first drawing set or model (below). The code sets load the first time someone opens the check window.

## Import drawings or a model

1. Click **Import Files**, or drop files on **Drop drawing sets or models here**. You can bring in several at once.
2. Each row shows **Uploading** with a percentage, then the file appears in the list. Its type is worked out from the file itself.
3. PDF, IFC and SketchUp files start a code check straight away, with the code sets used last time. The row shows **Reading the drawings…** and **Evaluating code rules…**, then the number of failures, items needing review and passes. Click **View results** to open the report.

Accepted files: PDF (`.pdf`), IFC (`.ifc`), STEP (`.step`, `.stp`), SketchUp (`.skp`) and Esri shapefiles (`.shp`, or a `.zip`), up to 1 GB each.

To show only one kind of file, click **PDF**, **IFC**, **STEP**, **SketchUp** or **Shapefile** at the top. Click **All** to see everything again, and **Refresh** to reload the list.

## See whether a file is ready to check

Every import gets a grade under its kind:

| Grade | Meaning |
|---|---|
| **Ready** | Ready for compliance review. |
| **Limited** | Can be checked, but some rules will come back not applicable or needing review. |
| **Needs prep** | The check would find almost nothing. Fix the export first. |
| **View only** | A valid file, but this type isn't code-checked. |

1. Click the grade on the file's row.
2. Read the summary, and each issue with its **Fix:** advice.
3. Click the **File requirements for designers** link for export instructions to pass on.

When you import a single file that isn't fully ready, this window opens by itself.

## Run a code check

1. On a PDF, IFC or SketchUp row, click the check mark (**Run compliance check**).
2. Tick the code sets to check. Each shows how many rules it has, and **IRC 2021** is ticked to start. Code sets under **Planned — no rules authored yet** can't be picked.
3. Click **Run check**. Progress shows on the file's row. A large drawing set can take several minutes.
4. When it finishes, click **View results**.

The window warns you when results will be weaker: a PDF with no text layer (scanned or flattened) is read from the image only, and a SketchUp model has no room data.

## Read a compliance report

1. On a file's row, click the eye icon (**View latest compliance report**).
2. The top shows what was read from the model, such as spaces, doors, windows and stairs, then the counts: **Failures**, **Critical**, **Need review**, **Passed** and **Not applicable**.
3. Below, failures come first, then items that need review, grouped by code section. Each finding names the element or sheet, explains the problem, and gives a **Fix** and the code text.
4. Scroll to **Checklist — every rule evaluated** for every rule and its result: **Fail**, **Review**, **Pass** or **N/A**.
5. Click **Print report** for a printable copy you can save as a PDF, or **« Back to files** to return.

## Open an earlier check

1. Click **Runs** at the top.
2. Each run shows its code sets, **Status**, and its **Fail**, **Review** and **Pass** counts, with when it **Started**.
3. Click a run to open its report.

## View, download or delete a file

- **View in 3D**: on an IFC or STEP row, click the cube icon. The model opens in the 3D viewer in a new tab.
- **Download**: click the download icon to save the original file.
- **Delete**: click the bin icon and confirm in **Delete model file**. The file and its stored copy are removed for good.

## Who can do what

Each action in the module needs a permission. A Workspace Admin gives permissions to roles; see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f). **Out of the box** shows the module's starting roles that have it.

| Permission | What it lets someone do | Out of the box |
|---|---|---|
| **View models and findings** | See imported drawings and models, past checks, reports and findings; download files and open the 3D viewer. | Admin, Operator, Viewer |
| **Import drawings and models** | Upload new drawing sets and models. Also (behind the scenes) accept or dismiss individual findings with a note. | Admin |
| **Delete imported models** | Permanently delete imported files. **Give with care.** | Admin |
| **Run a code check** | Start code checks. Each check uses AI and counts as AI usage. | Admin |
| **Manage code sets and rules** | See the list of code sets, turn code sets and individual rules on or off, and add local amendments. In practice it is also needed to open the Run compliance check dialog. **Give with care.** | Admin |

## Good to know

- **Give reviewers both check permissions.** Someone with **Run a code check** alone sees *Could not load code sets* and can't open the check window. The automatic check after an import needs both too.
- **Needs review is never a pass.** It means the rule applies but the drawings don't show enough to decide. A person needs to look.
- **Some rules use a general limit.** A finding can be right as arithmetic and still not apply to your building, for example because of its occupancy. Read each finding against the code section it cites.
- **Export PDFs from CAD.** A vector PDF has a text layer that is read exactly. A scanned set is read from the image only and is less accurate.
- **SketchUp models carry no rooms.** Room area, ceiling height, light and ventilation, bedroom egress and smoke alarms show as needing review. Check the drawing set for those.
- **IECC, NFPA 101, ICC A117.1, IFGC and IPC** are listed as planned but have no rules yet.
- **There is no screen for code sets yet.** The code sets can't be switched on or off, or amended, from the page.
- **Deleted files can't be brought back.**
- The module's data is available for reports and dashboards. See [Dashboard](article:1d8a33a4-3a13-4874-b8e5-5ef9da22df95).

## More help

Click **Help** at the top of the page for the module's full guide: importing, running a check, reading the report, file types, readiness grades, code sets, who can do what, and common questions. The module has no runbooks or AI assistant of its own.


Source: https://datavisions.ai/docs/module-guides/architectural-compliance
