Pattern Manager Troubleshooting¶
Use these checks if a library or project pattern is missing, a definition cannot be saved, geometry generation fails or a filled-region operation cannot be completed.
The Pattern Library Is Not Available¶
If Pattern Manager reports Library not found, Library unavailable or Library error:
- Confirm that the configured hatch-pattern library location is accessible.
- Confirm that the expected library folder has not been renamed or moved.
- Check network or shared-storage access where applicable.
- Click Refresh.
Pattern Manager scans all subfolders, so PAT files do not need to be stored directly in the library root.
I Cannot Find a Library Pattern¶
- Clear the library search.
- Set the folder filter to All Folders.
- Click Refresh if the PAT file was recently added or changed.
- Review the library warning count and messages.
- Confirm that the definition has a recognised target and at least one usable grid.
Search matches the pattern name, description, category and relative folder path, while the folder filter includes the selected folder and its descendants.
A PAT File Produces Warnings¶
Review the reported filename, line number and pattern name where available.
Common causes include:
- invalid numeric grid data;
- no model or drafting target declaration;
- a pattern header without a name; or
- a grid line containing fewer than five values.
Correct the PAT file and click Refresh. Other valid patterns can remain available even when one file or definition produces warnings.
Unknown units and definitions with no grid lines do not currently add a library warning. Check the displayed Units value and source PAT content if loading or exporting fails without a warning.
A Library Pattern Does Not Create a New Project Pattern¶
Flow standardises the pattern name before loading it. If a pattern with the same standardised name and the same model or drafting target already exists, Flow returns that existing definition instead of creating a duplicate.
Check Project Patterns using the standardised ADa_ name.
A Project Pattern Is Missing¶
- Clear the project search.
- Set the type filter to All Types.
- Confirm that the pattern is loaded in the active project.
Solid fill is intentionally excluded from Pattern Manager’s project-pattern list.
A Pattern Cannot Be Saved¶
Read the validation message shown by Pattern Editor and check:
- the name is not empty or already used;
- the definition contains at least one grid;
- every grid has a valid, non-zero offset;
- dash and gap segments have non-zero lengths; and
- a segmented grid is not made only from gaps and dots.
Pattern Editor stays open after validation fails so the definition can be corrected.
Editing Creates a Temporary Update Pattern¶
The current Edit implementation prepares a pattern whose name ends in __FlowUpdate, but does not yet transfer project references, remove the original pattern or complete the replacement.
Until that workflow is completed:
- use Duplicate to create a separate pattern;
- reassign materials or filled-region types deliberately in Revit; and
- do not repeatedly run Edit if a temporary update pattern already exists.
Changing only the Name in Edit mode may also leave Save disabled. Use Conform Name for an ADa prefix correction.
Pattern Generation from Geometry Fails¶
Check the following:
- Use a supported plan, section, detail, elevation or drafting view.
- Select detail lines, model lines, supported curves or a filled region with a usable fill pattern.
- Exclude unrelated or zero-length geometry.
- Select one complete repeat of the intended pattern.
- Pick two opposite tile corners with non-zero width and height.
If Flow reports that no grids could be generated, simplify the selection and confirm that it contains a repeatable family of lines.
Curves are converted to straight tessellated chords. Very complex curves can therefore create many grids and may need to be simplified first.
The Generated Pattern Repeats Incorrectly¶
The most likely cause is the selected tile rather than the linework.
Try again and pick equivalent opposite corners of exactly one complete repeat. Avoid selecting a partial repeat or a rectangle covering several unequal repeats.
Also review the generated grid offsets, origins, shifts and segment sequences in Pattern Editor before saving.
The Preview Looks Different from Revit¶
The Flow preview is intended for review and editing, but Revit remains the final reference for display.
Differences are most likely with:
- dense dot patterns;
- very short dash or gap segments;
- very large repeat spacing;
- complex tessellated curves; or
- model patterns viewed at a very different display scale.
Check the target and units, then load or save the pattern and review it in an appropriate Revit view.
Merge or Cut Is Not Available¶
Open a supported graphical view. Merge and Cut are not available in unsupported view types such as schedules, sheets or non-graphical views.
Also confirm that an active Revit document is available.
Merge Filled Regions Fails¶
Confirm that:
- at least two filled regions were selected for merging;
- a valid sample filled region was selected for the result type;
- the regions belong to the active view; and
- the combined boundaries can form a valid Revit filled region.
Cut Filled Region Fails¶
Confirm that:
- one base filled region was selected;
- at least one cutter region was selected;
- the cutter geometry overlaps the intended base area; and
- the subtraction produces valid closed boundary loops.
Choose Delete Cutters or Keep Cutters before selecting the cutters. If Delete Cutters is used and the cut succeeds, every selected cutter is deleted—even a selected cutter that did not overlap the base.
Create Filled Region Fails¶
Confirm that:
- the source project pattern is valid;
- the captured boundary consists of valid closed loops;
- existing linework is suitable for profile capture; and
- the active view supports filled regions.
If existing linework is unsuitable, retry using Draw Boundary.
When using Use Linework, the selected source CurveElements are deleted after successful region creation. Copy linework first if it must remain. When using Draw Boundary, press Esc after placing at least three points so Flow can close the final segment automatically.
If creation fails after boundary capture, a temporary preview line or a newly prepared Flow - [pattern name] filled-region type may remain. Remove it manually after confirming it is not required.
Reporting a Problem¶
If the problem continues, record:
- the Revit and Flow versions;
- the pattern name and whether it is a library or project pattern;
- the model or drafting target and units;
- the active Revit view type;
- the workflow being used;
- the exact message shown by Flow;
- the relevant PAT file where applicable; and
- screenshots of Pattern Manager and the affected Revit result.