Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

Hull and Outfitting

Hole Management Utility

  • Last UpdatedNov 14, 2025
  • 6 minute read

The Hole Management Utility which creates and manages penetrations is available only in the Pipework and HVAC Designer applications and accessed from the Penetration Utilities toolbar.

To start the application, click the Hole Management Utility icon on the toolbar to display the Managed Hole Utility window.

Create Holes

In the Clearance field, enter how much clearance to apply to the penetrating item. The clearance is not applied if the software detects a clash with a pipework or HVAC component that has hole size properties.

Note:
The clearance can be controlled by the component that passes through the panel if the penetrating component has a Property AHDI (for circular) or AHX, AHY (for non-circular) then these property values will control the hole size. for further information, refer to Configuration of Hole Management Data.

An example of the properties created in the catalogue:

NEW DATA /HVACPeneStrt1-Rext-RPlate-DETAIL-DATA-AHX

DESC 'Penetration Clearance X'

DKEY AHX

PTYP DIST

PPRO ( ATTRIB DDESP[2 ] + 100 mm )

DTIT 'Penetration Clearance X'

OLD /HVACPeneStrt1-Rext-RPlate-DETAIL-DATA-AHX

END

NEW DATA /HVACPeneStrt1-Rext-RPlate-DETAIL-DATA-AHY

DESC 'Penetration Clearance Y'

DKEY AHY

PTYP DIST

PPRO ( ATTRIB DDESP[3 ] + 100 mm )

DTIT 'Penetration Clearance Y'

Insulation

Select the Insulation check box to add 2* insulation thickness (as returned by the INTHK pseudo attribute) to the hole size for holes created using the Auto Penetrate CE and Create Holes functionality.

Note:
Auto Penetrate CE and Create Holes functionality uses catalogue hole size parameters where possible (with no clearance applied) and if the catalogue hole size parameters are not available then the pipe OD or HVAC duct size is used with the clearance applied.

Click Auto Penetrate CE to automatically create holes in the selected Current Element.

The clash analysis by the software can take a few minutes, a progress message and bar will be displayed. Once the analysis has taken place, the Hole Association Manager window is displayed with the details of the newly created virtual holes. Refer to Multi Disciplinary Penetration and Hole Management for further information.

Note:
The Hole Association Manager window is not displayed if no virtual holes are created.

If more than 3D virtual holes have been created a confirmation message to display the Hole Association Manager window is displayed.

To create holes individually click Create Hole, the user will be prompted to pick a panel, pipe or HVAC branch that penetrates the selected panel, section or wall element. The creation of the hole is identical to the automatic hole creation.

Merge Holes

Merged holes are individual holes merged together into a single hole generated by the software.

To merge holes, from the Merge Holes part of the Managed Hole Utility window, click Pick Holes, the user is prompted to pick a Managed Hole fitting to be combined into a single merged hole.

Note:
A minimum of two holes must be picked.

Click Merge Holes, the software creates a merged hole containing the selected penetrations. To change the shape of the merged hole, for further information, refer to .

Modify Holes

Created holes can be modified, managed or deleted, to modify a created hole, from the Modify Holes part of the Management Hole Utility window, click Modify CE. The Hole Management Definition window is displayed, modify the created hole as required.

The Default Size functionality is used when a hole is created and is recorded in the hole data (this data is used when a hole is modified). Since holes in existing projects do not have this data recorded then the Pipe or Duct Default Size functionality is selected and the Insulation functionality is not.

Hole size is determined from the catalogue parameters and insulation thickness at the time that the hole is created. When these parameters, insulation thickness or the basic pipe/duct size change after a hole is created, these changes are not automatically reflected in the hole size. Use the Data Check Utility to check for these changes, refer to for further information.

Note:
The Free Hole Boundary Editor can also be started from this window.

Clicking Manage Holes displays the Hole Association Manager window. Refer to Multi Disciplinary Penetration and Hole Management for further information.

Delete Holes

To delete a managed hole, the user is prompted to pick the hole to be deleted. If the hole has no status it is then deleted, if the hole is Requested, the user will be prompted to confirm the deletion of the hole.

Note:
If the hole is Approved, the deletion is not permitted.

Utilities

All panels within the volume of the selected pipe or HVAC can be added to the 3D view. To do this, from the Utilities part of the Managed Hole Utility window, click Add Structure.

To view all pipe or HVAC elements within the volume of the selected structural panels, from the Utilities part of the Managed Hole Utility window, click Add Pipe/HVAC.

To generate and define a report on selected holes, click Hole Report. The report can then be printed or exported to Excel.

Hole Association Filter

Searches for Managed Holes and displays the search results in the Hole Report. The filter criteria specify which Managed Holes will be selected.

Current Element

Displays any holes associated with the currently selected element only.

Graphical Selection

Applies filtering to all managed holes associated with elements in the current graphical selection.

All Managed Holes

Applies filtering to all managed holes in the MDB.

Report Headings:

Discipline

Specify holes for all disciplines or for a single discipline using the drop-down menu.

Status

Specify holes at any Status or specify holes at a single Status option using the drop-down menu.

Valid

Select only holes that pass or fail the validation tests, or select all holes regardless of validity.

Note:
Having any option other than Not Checked selected may significantly slow down the report generation as all the validation tests will be run for every selected hole.

Invalid

Include hole associations that have any invalid references or invalid data.

Report Headings

Select headings that are required on the report from the three categories. Information about the hole, information about the penetrated structural item and information about the penetrating item.

Run Report

Displays Managed Hole Reports window.

The Managed Hole Report window displays the report generated by the specified selection criteria and report headings.

Use grid column functions to sort and filter columns before printing the report or exporting it to Excel. Select Print Preview to view the report or select Export to Excel to export the report to Excel.

Right click the Hole Associations list to display the following pop-up menu:

Navigate to

To the Hole Association, the penetrated item or the penetrating item (single selection only).

Add to 3D view

Adds the selected holes and associated items.

Remove from 3D view

Removes the selected holes and associated items.

Focus in Hole

Zooms to centre the 3D view on the selected hole and zoom in to the hole. Clipping is applied if it is enabled (single selection only).

Export list to Excel

Exports the report grid to Excel.

Print list

Shows a standard grid print preview for the report grid.

TitleResults for “How to create a CRG?”Also Available in