---
title: "ChecksResult"
description: "Result of running design checks."
canonical_url: "https://www.rosette.dev/docs/api-reference/ChecksResult"
markdown_url: "https://www.rosette.dev/docs/api-reference/ChecksResult.md"
source_url: "https://github.com/PreFab-Photonics/rosette/blob/f086d7670645fd36c05362d696d442a2b2e74850/www/content/docs/api-reference/ChecksResult.mdx"
docs_channel: "main"
docs_revision: "f086d7670645fd36c05362d696d442a2b2e74850"
---

# ChecksResult

Result of running design checks.

Import with `from rosette.checks import ChecksResult`.

Returned by `run_checks()`. Contains connectivity and bend radius violations
along with summary statistics. Use the `passed` attribute for a quick
pass/fail check.

```python
result = run_checks(cell, config=config)
if result.passed and result.complete:
    print(f"All checks passed ({result.ports_checked} ports, {result.connections_found} connections)")
else:
    print(f"Found {len(result.violations)} violations")
    for v in result.violations:
        print(f"  {v.message}")
```

## Attributes



### `passed`

```python
passed: bool
```

`True` if no error-severity violations were found. Warnings remain available in
`violations` but do not fail the run.





### `complete`

```python
complete: bool
```

`True` if hierarchy traversal completed and every discovered port, width, bend,
and required route-annotation entry was checkable.





### `error_count`

```python
error_count: int
```

Number of error-severity violations.





### `warning_count`

```python
warning_count: int
```

Number of warning-severity violations.





### `violations`

```python
violations: list[CheckViolation]
```

List of all check violations found.





### `ports_checked`

```python
ports_checked: int
```

Number of ports checked during the run.





### `connections_found`

```python
connections_found: int
```

Number of valid port-to-port connections found.





### `connectivity_nodes`

```python
connectivity_nodes: int
```

Number of spatial connectivity nodes checked after hierarchical port promotion.





### `ports_uncheckable`

```python
ports_uncheckable: int
```

Number of ports or port widths that could not be transformed or checked.





### `hierarchy_issues`

```python
hierarchy_issues: int
```

Number of missing references or hierarchy cycles encountered.





### `bends_checked`

```python
bends_checked: int
```

Number of bends checked against the minimum radius.





### `bends_uncheckable`

```python
bends_uncheckable: int
```

Number of annotated bends that could not be checked safely.





### `route_annotation_cells_checked`

```python
route_annotation_cells_checked: int
```

Number of cell placements with explicit route-annotation entries.





### `route_annotation_cells_missing`

```python
route_annotation_cells_missing: int
```

Number of local-geometry cell placements missing required route annotations.





### `elapsed_ms`

```python
elapsed_ms: float
```

Elapsed time in milliseconds.