Geometry - Catalog

The Geometry_Catalog can be used to standardize the sizes of rectangles representing doors and windows or circles representing columns or technical holes. There are two scenarios for using this tool:

1. Mathematical Rounding for height and width (For rectangles only)

2. Selection of the most suitable size from a CSV catalog

Requirements: 

• Select multiple geometric objects before running the script.

Steps:

A. Select multiple geometric shapes that represent doors, windows, or columns in each room. These objects can be created using the standard Cyclone 3DR tool, Best Rectangle, Circle, from the contours generated with the Mesh_Extract Border tool.

B. Execute the script and select the Geometry_Catalog option.

C. The script will ask you which scenario you would like to apply:

• Math Rounding (Only for Rectangles)

• Catalog Selection

Math Rounding:

1. Select type of rounding:

• Round to Units - Rounds the selected part of the rectangle to the nearest value in mm, cm, or m. For example, 2.486m will be rounded up to 2.49m if rounding to cm is selected.

• Multiple Value - Makes the selected part of the rectangle a multiple of 1cm, 2cm, or 5cm. For example, 2.486m will be rounded up to 2.50m if making the value a multiple of 5cm is selected.

2. Select Rounding Parameters:

• Units - Related only to the function Round to Units: mm, cm, m.

• Multiple (cm) - Related only to the function Multiple Value: 1cm, 2cm, 5cm.

• Direction - Related to both functions: Up, Down, Nearest.

3. Select which part of the rectangle you would like to apply the changes to:

• Length - Changes only the length.

• Width - Changes only the width.

• Lock bottom Z level - When this option is activated, the bottom of the rectangle will stay in the same place after applying changes.

Catalog Selection: 

1. Specify the path for the CSV file catalog with all sizes. The format of the catalog looks like this:

For Rectangles:

• Name,Length_mm,Width_mm,Description,Category

• Example: "Door-600",2050,600,"Single door 60 cm","Door" 

For Circles:

• Name,Radius_mm,Diameter_mm,Description,Category

• Example: "300mm",300,600,"Column Concrete","Columns"
  
  

2. Choose selection criteria:

• Nearest by Area - Selects the nearest item from the catalog by matching the area parameter.

• Nearest Larger - Selects the nearest larger item from the catalog.

• Nearest Smaller - Selects the nearest smaller item from the catalog.

3. Define tolerance - the difference between the user item and the nearest catalog item

4. Select which part of the rectangle you would like to apply the changes to:

• Length - Changes only the length.

• Width - Changes only the width.

• Lock bottom Z level - When this option is activated, the bottom of the rectangle will stay in the same place after applying changes.

D. Click the Preview button, and the script will show you a new shape with changed length and width based on the selected parameters. The preview geometry will be white.

Notes:

• When using the Best Fit tool to create geometries, the software may create rectangles or circles with custom sizes. This could be inconvenient if you want to include standard sizes for each object in the report. That's why the Geometry_Catalog feature could be used