Reinforcement BillOfMaterial: Difference between revisions

From FreeCAD Documentation
(Fix grammar issues)
(Marked this version for translation)
 
(12 intermediate revisions by 3 users not shown)
Line 5: Line 5:
{{Docnav
{{Docnav
|[[Arch_Rebar|Rebar]]
|[[Arch_Rebar|Rebar]]
|[[Reinforcement_BarShapeCutList|BarShapeCutList]]
|[[Reinforcement_Bar_Shape_Cut_List|RebarShapeCutList]]
|[[Reinforcement_Workbench|Reinforcement]]
|[[Reinforcement_Workbench|Reinforcement]]
|IconL=Arch_Rebar.svg
|IconL=Arch_Rebar.svg
|IconR=Reinforcement_BarShapeCutList.svg
|IconC=Reinforcement_Workbench.svg
|IconC=Reinforcement_Workbench.svg
|IconR=Reinforcement_Bar_Shape_Cut_List.svg
}}
}}



<!--T:2-->
<!--T:2-->
{{GuiCommand
{{GuiCommand
|Name=Arch Rebar BOM
|Name=Reinforcement BillOfMaterial
|MenuLocation=Reinforcement → Bill Of Material
|MenuLocation=
|Workbenches=[[Reinforcement_Workbench|Reinforcement]], [[Arch_Workbench|Arch]], [[BIM_Workbench|BIM]]
|Workbenches=[[Reinforcement_Workbench|Reinforcement]]
|SeeAlso=[[Reinforcement_Bar_Bending_Schedule|Bar Bending Schedule]], [[Arch_Rebar_Drawing_Dimensioning#Reinforcement_Dimensioning|Reinforcement Dimensioning]]
|Version=0.19
|Version=0.19
|SeeAlso=
}}
}}


Line 25: Line 24:


<!--T:4-->
<!--T:4-->
The [[Arch Rebar BOM|Bill Of Material]] tool allows the user to create a bill of material of reinforcing bars.
The [[Reinforcement BillOfMaterial|Reinforcement BillOfMaterial]] tool allows the user to create a bill of material of reinforcing bars.


<!--T:5-->
<!--T:5-->
This command is part of the [[Reinforcement Workbench|Reinforcement Workbench]], an [[External workbenches|external workbench]] that can be installed with the [[Image:AddonManager.svg|24px]] [[Addon Manager|Addon Manager]] via the {{MenuCommand|Tools → Addon manager → Reinforcement}} menu.
This tool is part of the [[Reinforcement_Workbench|Reinforcement Workbench]], an [[External_workbenches|external workbench]] that can be installed with the [[Image:Std_AddonMgr.svg|24px]] [[Std_AddonMgr|Addon Manager]].


</translate>
</translate>
[[Image:Arch_Rebar_BOM_example.png|1000px]]
[[Image:Arch_Rebar_BOM_example.png|1000px]]
<translate>
<translate>

<!--T:6-->
<!--T:6-->
{{Caption|Bill Of Material of reinforcing bars}}
{{Caption|Bill Of Material of reinforcing bars}}
Line 40: Line 38:


<!--T:8-->
<!--T:8-->
1. Select {{Button|[[Image:Arch_Rebar.svg|16px]] [[Arch Rebar|Arch Rebar]]}} objects you want to include in the Bill Of Material. Or select {{Button|[[Image:Arch_Structure.svg|16px]] [[Arch Structure|Arch Structure]]}} objects to include {{Button|[[Image:Arch_Rebar.svg|16px]] [[Arch Rebar|Arch Rebar]]}} objects hosted by that into Bill Of Material. If nothing is selected, then Bill Of Material will be generated for all {{Button|[[Image:Arch_Rebar.svg|16px]] [[Arch Rebar|Arch Rebar]]}} and Rebar2 objects present in the model.
1. Select {{Button|[[Image:Arch_Rebar.svg|16px]] [[Arch_Rebar|Arch Rebar]]}} and Rebar2 objects you want to include in the Bill Of Material. Or select {{Button|[[Image:Arch_Structure.svg|16px]] [[Arch_Structure|Arch Structure]]}} objects to include {{Button|[[Image:Arch_Rebar.svg|16px]] [[Arch_Rebar|Arch Rebar]]}} objects hosted by those into Bill Of Material. If nothing is selected, then Bill Of Material will be generated for all {{Button|[[Image:Arch_Rebar.svg|16px]] [[Arch_Rebar|Arch Rebar]]}} and Rebar2 objects present in the model.


<!--T:9-->
<!--T:9-->
2. Then select {{Button|[[Image:Arch_Rebar_BOM.svg|16px]] [[Arch Rebar BOM|Bill Of Material]]}} from the rebar tools.
2. Then select {{Button|[[Image:Reinforcement_BillOfMaterial.svg|16px]] [[Reinforcement_BillOfMaterial|Rebar Bill Of Material]]}} from the rebar tools.


<!--T:10-->
<!--T:10-->
Line 49: Line 47:


</translate>
</translate>
[[Image:BOMDialog_General.png|500px]]
: [[Image:BOMDialog_General.png|500px]]
<translate>
<translate>

<!--T:11-->
<!--T:11-->
{{Caption|Dialog Box for the Arch Rebar BOM tool}}
: {{Caption|Dialog Box for the Arch Rebar BOM tool}}


<!--T:12-->
<!--T:12-->
Line 59: Line 56:


<!--T:13-->
<!--T:13-->
5. To edit {{Button|[[Image:Arch_Rebar_BOM.svg|16px]] [[Arch Rebar BOM|Bill Of Material]]}} SVG configurations, click on {{Button|Edit SVG Configurations}}. A dialog box will pop-out as shown below.
5. To edit {{Button|[[Image:Reinforcement_BillOfMaterial.svg|16px]] [[Reinforcement_BillOfMaterial|Rebar Bill Of Material]]}} SVG configurations, click on {{Button|Edit SVG Configurations}}. A dialog box will pop-out as shown below.


</translate>
</translate>
[[Image:BOMDialog_SVG.png|500px]]
: [[Image:BOMDialog_SVG.png|500px]]
<translate>
<translate>

<!--T:14-->
<!--T:14-->
{{Caption|Dialog Box for the Arch Rebar BOM SVG configuration editing}}
: {{Caption|Dialog Box for the Arch Rebar BOM SVG configuration editing}}


<!--T:15-->
<!--T:15-->
6. Modify {{Button|[[Image:Arch_Rebar_BOM.svg|16px]] [[Arch Rebar BOM|Bill Of Material]]}} SVG configurations and then click on {{Button|OK}} to apply changes.
6. Modify {{Button|[[Image:Reinforcement_BillOfMaterial.svg|16px]] [[Reinforcement_BillOfMaterial|Rebar Bill Of Material]]}} SVG configurations and then click on {{Button|OK}} to apply changes.


<!--T:16-->
<!--T:16-->
Line 77: Line 73:
8. Click {{Button|Cancel}} to exit the dialog box.
8. Click {{Button|Cancel}} to exit the dialog box.


==Properties== <!--T:18-->
==Properties== <!--T:18-->


<!--T:19-->
<!--T:42-->
'''General:'''
'''General:'''

<!--T:19-->
* {{PropertyData|Column Headers}}: A dictionary with column_data as key and tuple (column_display_header, column_sequence) as value.
* {{PropertyData|Column Headers}}: A dictionary with column_data as key and tuple (column_display_header, column_sequence) as value.
* {{PropertyData|Column Units}}: A dictionary with keys: "Diameter", "RebarLength", "RebarsTotalLength" and their corresponding units as value.
* {{PropertyData|Column Units}}: A dictionary with keys: "Diameter", "RebarLength", "RebarsTotalLength" and their corresponding units as value.
Line 87: Line 85:
* {{PropertyData|Rebar Objects}}: A list of ArchRebar and/or rebar2 and/or structures (to select ArchRebar in that structure) objects.
* {{PropertyData|Rebar Objects}}: A list of ArchRebar and/or rebar2 and/or structures (to select ArchRebar in that structure) objects.


<!--T:20-->
<!--T:43-->
'''SVG:'''
'''SVG:'''

<!--T:20-->
* {{PropertyData|Font Family}}: Font Family of text in BOM SVG.
* {{PropertyData|Font Family}}: Font Family of text in BOM SVG.
* {{PropertyData|Font Filename}}: Font filename corresponding to font-family required in console mode.
* {{PropertyData|Font Filename}}: Font filename corresponding to font-family required in console mode.
Line 109: Line 109:


<!--T:23-->
<!--T:23-->
The [[Arch Rebar BOM|Bill Of Material]] tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:
The Reinforcement BillOfMaterial tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:


=== Create Bill Of Material Spreadsheet === <!--T:24-->
=== Create Bill Of Material Spreadsheet === <!--T:24-->
Line 164: Line 164:
from BillOfMaterial import BillOfMaterial_Spreadsheet
from BillOfMaterial import BillOfMaterial_Spreadsheet


<translate>

<!--T:27-->
# It doesn't work if the structure is not based on a face
# It doesn't work if the structure is not based on a face
</translate>
# Structure = Arch.makeStructure(length=1000, width=400, height=400)
# Structure = Arch.makeStructure(length=1000, width=400, height=400)


Line 178: Line 174:
Structure2.Placement = FreeCAD.Placement(FreeCAD.Vector(1000, 0, 0), FreeCAD.Rotation(FreeCAD.Vector(0, 0, 1), 0))
Structure2.Placement = FreeCAD.Placement(FreeCAD.Vector(1000, 0, 0), FreeCAD.Rotation(FreeCAD.Vector(0, 0, 1), 0))
FreeCAD.ActiveDocument.recompute()
FreeCAD.ActiveDocument.recompute()
<translate>


<!--T:28-->
# Create Straight Rebars
# Create Straight Rebars
</translate>
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
l_cover_of_ties=40,
l_cover_of_ties=40,
Line 207: Line 200:
)
)


<translate>

<!--T:29-->
# Create LShaped Rebars with hook along x-axis
# Create LShaped Rebars with hook along x-axis
</translate>
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
l_cover_of_ties=40,
l_cover_of_ties=40,
Line 270: Line 259:
}
}


<translate>
<!--T:30-->
# To create Bill Of Material Spreadsheet for all rebars in a model
# To create Bill Of Material Spreadsheet for all rebars in a model
</translate>

BillOfMaterial_Spreadsheet.makeBillOfMaterial(
BillOfMaterial_Spreadsheet.makeBillOfMaterial(
column_headers=COLUMN_HEADERS,
column_headers=COLUMN_HEADERS,
Line 282: Line 267:
)
)


<translate>
<!--T:31-->
# To create Bill Of Material Spreadsheet for rebars in Structure1
# To create Bill Of Material Spreadsheet for rebars in Structure1
</translate>

BillOfMaterial_Spreadsheet.makeBillOfMaterial(
BillOfMaterial_Spreadsheet.makeBillOfMaterial(
column_headers=COLUMN_HEADERS,
column_headers=COLUMN_HEADERS,
Line 294: Line 275:
rebar_objects=[Structure1],
rebar_objects=[Structure1],
)
)

}}
}}
<translate>
<translate>
Line 383: Line 363:
from BillOfMaterial import BillOfMaterial_SVG
from BillOfMaterial import BillOfMaterial_SVG


<translate>

<!--T:36-->
# It doesn't work if the structure is not based on a face
# It doesn't work if the structure is not based on a face
</translate>
# Structure = Arch.makeStructure(length=1000, width=400, height=400)
# Structure = Arch.makeStructure(length=1000, width=400, height=400)


Line 397: Line 373:
Structure2.Placement = FreeCAD.Placement(FreeCAD.Vector(1000, 0, 0), FreeCAD.Rotation(FreeCAD.Vector(0, 0, 1), 0))
Structure2.Placement = FreeCAD.Placement(FreeCAD.Vector(1000, 0, 0), FreeCAD.Rotation(FreeCAD.Vector(0, 0, 1), 0))
FreeCAD.ActiveDocument.recompute()
FreeCAD.ActiveDocument.recompute()
<translate>


<!--T:37-->
# Create Straight Rebars
# Create Straight Rebars
</translate>
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
l_cover_of_ties=40,
l_cover_of_ties=40,
Line 426: Line 399:
)
)


<translate>

<!--T:38-->
# Create LShaped Rebars with hook along x-axis
# Create LShaped Rebars with hook along x-axis
</translate>
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
l_cover_of_ties=40,
l_cover_of_ties=40,
Line 489: Line 458:
}
}


<translate>
<!--T:39-->
# To create Bill Of Material SVG for all rebars in a model
# To create Bill Of Material SVG for all rebars in a model
</translate>

BillOfMaterial_SVG.makeBillOfMaterialSVG(
BillOfMaterial_SVG.makeBillOfMaterialSVG(
column_headers=COLUMN_HEADERS,
column_headers=COLUMN_HEADERS,
Line 515: Line 480:
)
)


<translate>
<!--T:40-->
# To create Bill Of Material SVG for rebars in Structure1
# To create Bill Of Material SVG for rebars in Structure1
</translate>
BillOfMaterial_SVG.makeBillOfMaterialSVG(
BillOfMaterial_SVG.makeBillOfMaterialSVG(
column_headers = COLUMN_HEADERS,
column_headers = COLUMN_HEADERS,
Line 546: Line 508:
{{Docnav
{{Docnav
|[[Arch_Rebar|Rebar]]
|[[Arch_Rebar|Rebar]]
|[[Reinforcement_BarShapeCutList|BarShapeCutList]]
|[[Reinforcement_Bar_Shape_Cut_List|RebarShapeCutList]]
|[[Reinforcement_Workbench|Reinforcement]]
|[[Reinforcement_Workbench|Reinforcement]]
|IconL=Arch_Rebar.svg
|IconL=Arch_Rebar.svg
|IconR=Reinforcement_BarShapeCutList.svg
|IconC=Reinforcement_Workbench.svg
|IconC=Reinforcement_Workbench.svg
|IconR=Reinforcement_Bar_Shape_Cut_List.svg
}}
}}

</translate>
</translate>
[[Category:External Command Reference{{#translation:}}]]
[[Category:External_Command_Reference{{#translation:}}]]
[[Category:Reinforcement{{#translation:}}]]
[[Category:Reinforcement{{#translation:}}]]

Latest revision as of 21:40, 9 March 2024

Reinforcement BillOfMaterial

Menu location
None
Workbenches
Reinforcement
Default shortcut
None
Introduced in version
0.19
See also
None

Description

The Reinforcement BillOfMaterial tool allows the user to create a bill of material of reinforcing bars.

This tool is part of the Reinforcement Workbench, an external workbench that can be installed with the Addon Manager.

Bill Of Material of reinforcing bars

Usage

1. Select Arch Rebar and Rebar2 objects you want to include in the Bill Of Material. Or select Arch Structure objects to include Arch Rebar objects hosted by those into Bill Of Material. If nothing is selected, then Bill Of Material will be generated for all Arch Rebar and Rebar2 objects present in the model.

2. Then select Rebar Bill Of Material from the rebar tools.

3. A dialog box will pop-out on the screen as shown below.

Dialog Box for the Arch Rebar BOM tool

4. Modify data to suit your requirements.

5. To edit Rebar Bill Of Material SVG configurations, click on Edit SVG Configurations. A dialog box will pop-out as shown below.

Dialog Box for the Arch Rebar BOM SVG configuration editing

6. Modify Rebar Bill Of Material SVG configurations and then click on OK to apply changes.

7. Click OK or Apply to generate Bill Of Material for rebars.

8. Click Cancel to exit the dialog box.

Properties

General:

  • DataColumn Headers: A dictionary with column_data as key and tuple (column_display_header, column_sequence) as value.
  • DataColumn Units: A dictionary with keys: "Diameter", "RebarLength", "RebarsTotalLength" and their corresponding units as value.
  • DataDiameter Weight Map: A dictionary with the diameter as key and corresponding weight as value.
  • DataRebar Length Type: Rebar Length Type specifies the type of rebar length used for BOM calculations i.e. "RealLength" or "LengthWithSharpEdges".
  • DataRebar Objects: A list of ArchRebar and/or rebar2 and/or structures (to select ArchRebar in that structure) objects.

SVG:

  • DataFont Family: Font Family of text in BOM SVG.
  • DataFont Filename: Font filename corresponding to font-family required in console mode.
  • DataFont Size: Font size in mm.
  • DataColumn Width: Width of each column in the BOM SVG table.
  • DataRow Height: Height of each row in the BOM SVG table.
  • DataLeft Offset: Left offset of BOM SVG table.
  • DataTop Offset: Top offset of BOM SVG table.
  • DataMinimum Right Offset: Minimum right offset of BOM SVG table.
  • DataMinimum Bottom Offset: Minimum bottom offset of the BOM SVG table.
  • DataMaximum Width: Maximum width of the BOM SVG table.
  • DataMaximum Height: Maximum height of the BOM SVG table.
  • DataTemplate File: Template SVG file for BOM SVG.
  • DataOutput File: BOM SVG Output file.

Scripting

See also: Arch API, Reinforcement API and FreeCAD Scripting Basics.

The Reinforcement BillOfMaterial tool can be used in macros and from the Python console by using the following function:

Create Bill Of Material Spreadsheet

bom_spreadsheet = makeBillOfMaterial(
    column_headers=None,
    column_units=None,
    dia_weight_map=None,
    rebar_length_type=None,
    rebar_objects=None,
    obj_name="RebarBillOfMaterial",
)
  • Creates a RebarBillOfMaterial spreadsheet object for given rebar_objects.
    • If rebar_objects list is empty, then RebarBillOfMaterial spreadsheet will be created for all rebars in a model.
  • column_headers is a dictionary with keys: "Host", "Mark", "RebarsCount", "Diameter", "RebarLength", "RebarsTotalLength" and values are tuple of column_header and their sequence number.
   Example: {
                "Host": ("Member", 1),
                "Mark": ("Mark", 2),
                "RebarsCount": ("No. of Rebars", 3),
                "Diameter": ("Diameter in mm", 4),
                "RebarLength": ("Length in m/piece", 5),
                "RebarsTotalLength": ("Total Length in m", 6),
            }
            set column sequence number to 0 to hide column.
  • column_units is a dictionary with keys: "Diameter", "RebarLength", "RebarsTotalLength" and their corresponding units as value.
   Example: {
                "Diameter": "mm",
                "RebarLength": "m",
                "RebarsTotalLength": "m",
            }
  • dia_weight_map is a dictionary with diameter as key and corresponding weight as value.
   Syntax: {
                6: FreeCAD.Units.Quantity("0.222 kg/m"),
                8: FreeCAD.Units.Quantity("0.395 kg/m"),
                10: FreeCAD.Units.Quantity("0.617 kg/m"),
                12: FreeCAD.Units.Quantity("0.888 kg/m"),
                ...,
            }
  • rebar_length_type specifies the type of rebar length used for BOM calculations; it can be "RealLength" or "LengthWithSharpEdges".
  • rebar_objects is a list of ArchRebar and/or rebar2 and/or structures (to select ArchRebar in that structure) objects.

Example

import FreeCAD, Draft, Arch
from ColumnReinforcement import TwoTiesSixRebars
from BillOfMaterial import BillOfMaterial_Spreadsheet

# It doesn't work if the structure is not based on a face
# Structure = Arch.makeStructure(length=1000, width=400, height=400)

Rect = Draft.makeRectangle(400, 400)
Structure1 = Arch.makeStructure(Rect, height=1600)
Structure1.ViewObject.Transparency = 80
Structure2 = Arch.makeStructure(Rect, height=1600)
Structure2.ViewObject.Transparency = 80
Structure2.Placement = FreeCAD.Placement(FreeCAD.Vector(1000, 0, 0), FreeCAD.Rotation(FreeCAD.Vector(0, 0, 1), 0))
FreeCAD.ActiveDocument.recompute()

# Create Straight Rebars
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
    l_cover_of_ties=40,        
    r_cover_of_ties=40,
    t_cover_of_ties=40,
    b_cover_of_ties=40,
    offset_of_ties=100,
    bent_angle_of_ties=135,
    extension_factor_of_ties=2,
    dia_of_ties=8,
    number_spacing_check=True,
    number_spacing_value=10,
    dia_of_main_rebars=16,
    t_offset_of_rebars=40,
    b_offset_of_rebars=40,
    main_rebars_type="StraightRebar",
    hook_orientation="Top Inside",
    hook_extend_along="x-axis",
    l_rebar_rounding=None,
    hook_extension=None,
    ties_sequence=("Tie1", "Tie2"),
    structure=Structure1,
    facename="Face6",
)

# Create LShaped Rebars with hook along x-axis
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
    l_cover_of_ties=40,
    r_cover_of_ties=40,
    t_cover_of_ties=40,
    b_cover_of_ties=40,
    offset_of_ties=100,
    bent_angle_of_ties=135,
    extension_factor_of_ties=2,
    dia_of_ties=8,
    number_spacing_check=True,
    number_spacing_value=10,
    dia_of_main_rebars=16,
    t_offset_of_rebars=-40,
    b_offset_of_rebars=-40,
    main_rebars_type="LShapeRebar",
    hook_orientation="Top Outside",
    hook_extend_along="x-axis",
    l_rebar_rounding=2,
    hook_extension=40,
    ties_sequence=("Tie1", "Tie2"),
    structure=Structure2,
    facename="Face6",
)

COLUMN_UNITS = {
    "Diameter": "mm",
    "RebarLength": "m",
    "RebarsTotalLength": "m",
}

COLUMN_HEADERS = {
    "Host": ("Member", 1),
    "Mark": ("Mark", 2),
    "RebarsCount": ("No. of Rebars", 3),
    "Diameter": ("Diameter in " + COLUMN_UNITS["Diameter"], 4),
    "RebarLength": ("Length in " + COLUMN_UNITS["RebarLength"] + "/piece", 5),
    "RebarsTotalLength": ("Total Length in " + COLUMN_UNITS["RebarsTotalLength"], 6),
}

DIA_WEIGHT_MAP = {
    6: FreeCAD.Units.Quantity("0.222 kg/m"),
    8: FreeCAD.Units.Quantity("0.395 kg/m"),
    10: FreeCAD.Units.Quantity("0.617 kg/m"),
    12: FreeCAD.Units.Quantity("0.888 kg/m"),
    14: FreeCAD.Units.Quantity("1.206 kg/m"),
    16: FreeCAD.Units.Quantity("1.578 kg/m"),
    18: FreeCAD.Units.Quantity("2.000 kg/m"),
    20: FreeCAD.Units.Quantity("2.466 kg/m"),
    22: FreeCAD.Units.Quantity("2.980 kg/m"),
    25: FreeCAD.Units.Quantity("3.854 kg/m"),
    28: FreeCAD.Units.Quantity("4.830 kg/m"),
    32: FreeCAD.Units.Quantity("6.313 kg/m"),
    36: FreeCAD.Units.Quantity("7.990 kg/m"),
    40: FreeCAD.Units.Quantity("9.864 kg/m"),
    45: FreeCAD.Units.Quantity("12.490 kg/m"),
    50: FreeCAD.Units.Quantity("15.410 kg/m"),
}

# To create Bill Of Material Spreadsheet for all rebars in a model
BillOfMaterial_Spreadsheet.makeBillOfMaterial(
    column_headers=COLUMN_HEADERS,
    column_units=COLUMN_UNITS,
    dia_weight_map=DIA_WEIGHT_MAP,
    rebar_length_type="RealLength",
)

# To create Bill Of Material Spreadsheet for rebars in Structure1
BillOfMaterial_Spreadsheet.makeBillOfMaterial(
    column_headers=COLUMN_HEADERS,
    column_units=COLUMN_UNITS,
    dia_weight_map=DIA_WEIGHT_MAP,
    rebar_length_type="LengthWithSharpEdges",
    rebar_objects=[Structure1],
)

Create Bill Of Material SVG

makeBillOfMaterialSVG(
    column_headers: Optional[Dict[str, Tuple[str, int]]] = None,
    column_units: Optional[Dict[str, str]] = None,
    dia_weight_map: Optional[Dict[float, FreeCAD.Units.Quantity]] = None,
    rebar_length_type: Optional[
        Literal["RealLength", "LengthWithSharpEdges"]
    ] = None,
    font_family: Optional[str] = None,
    font_filename: Optional[str] = None,
    font_size: Optional[float] = None,
    column_width: Optional[float] = None,
    row_height: Optional[float] = None,
    bom_left_offset: Optional[float] = None,
    bom_top_offset: Optional[float] = None,
    bom_min_right_offset: Optional[float] = None,
    bom_min_bottom_offset: Optional[float] = None,
    bom_table_svg_max_width: Optional[float] = None,
    bom_table_svg_max_height: Optional[float] = None,
    template_file: Optional[str] = None,
    output_file: Optional[str] = None,
    rebar_objects: Optional[List] = None,
    reinforcement_group_by: Optional[Literal["Mark", "Host"]] = None,
    return_svg_only: bool = False,
) -> BOMContent
  • Creates and return a RebarBillOfMaterial_SVG BOMContent object for given rebar_objects.
    • If rebar_objects list is empty, then BOMContent object will be created for all rebars in a model.
  • column_headers is a dictionary with keys: "Host", "Mark", "RebarsCount", "Diameter", "RebarLength", "RebarsTotalLength" and values are tuple of column_header and their sequence number.
   Example: {
                "Host": ("Member", 1),
                "Mark": ("Mark", 2),
                "RebarsCount": ("No. of Rebars", 3),
                "Diameter": ("Diameter in mm", 4),
                "RebarLength": ("Length in m/piece", 5),
                "RebarsTotalLength": ("Total Length in m", 6),
            }
            set column sequence number to 0 to hide column.
  • column_units is a dictionary with keys: "Diameter", "RebarLength", "RebarsTotalLength" and their corresponding units as value.
   Example: {
                "Diameter": "mm",
                "RebarLength": "m",
                "RebarsTotalLength": "m",
            }
  • dia_weight_map is a dictionary with diameter as key and corresponding weight as value.
   Syntax: {
                6: FreeCAD.Units.Quantity("0.222 kg/m"),
                8: FreeCAD.Units.Quantity("0.395 kg/m"),
                10: FreeCAD.Units.Quantity("0.617 kg/m"),
                12: FreeCAD.Units.Quantity("0.888 kg/m"),
                ...,
            }
  • rebar_length_type specifies the type of rebar length used for the bill of material calculations; it can be "RealLength" or "LengthWithSharpEdges".
  • font_family specifies the font family of data text.
  • font_filename specifies font filename or full path of the font file corresponding to font_family. This is required if you are working in pure console mode, without any GUI.
  • font_size specifies the font size of the data text.
  • column_width specifies the width of each column in the bill of material table SVG.
  • row_height specifies the height of each row in the bill of material table SVG.
  • bom_left_offset specifies the left offset of the bill of material SVG on template_file.
  • bom_top_offset specifies the top offset of the bill of material SVG on template_file.
  • bom_min_right_offset specifies the minimum right offset of the bill of material SVG on template_file.
  • bom_min_bottom_offset specifies the minimum bottom offset of the bill of material SVG on template_file
  • bom_table_svg_max_width specifies the maximum width of the bill of material table in SVG.
  • bom_table_svg_max_height specifies the maximum height of the bill of material table in SVG.
  • template_file specifies the template file used to place the generated bill of material table on it. It must be a valid TechDraw template file as here.
  • output_file specifies the output file to write generated bill of material SVG.
  • rebar_objects is a list of ArchRebar and/or rebar2 and/or structures (to select ArchRebar in that structure) objects.
  • reinforcement_group_by specifies how reinforcement objects should be grouped; it can be "Mark" or "Host".
  • return_svg_only specifies if the BOMContent object is to be created or not. If return_svg_only is True, then neither BOMContent object is created nor SVG is written to output_file. And it returns the SVG element.

Example

from pathlib import Path
import FreeCAD, Draft, Arch
from ColumnReinforcement import TwoTiesSixRebars
from BillOfMaterial import BillOfMaterial_SVG

# It doesn't work if the structure is not based on a face
# Structure = Arch.makeStructure(length=1000, width=400, height=400)

Rect = Draft.makeRectangle(400, 400)
Structure1 = Arch.makeStructure(Rect, height=1600)
Structure1.ViewObject.Transparency = 80
Structure2 = Arch.makeStructure(Rect, height=1600)
Structure2.ViewObject.Transparency = 80
Structure2.Placement = FreeCAD.Placement(FreeCAD.Vector(1000, 0, 0), FreeCAD.Rotation(FreeCAD.Vector(0, 0, 1), 0))
FreeCAD.ActiveDocument.recompute()

# Create Straight Rebars
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
    l_cover_of_ties=40,        
    r_cover_of_ties=40,
    t_cover_of_ties=40,
    b_cover_of_ties=40,
    offset_of_ties=100,
    bent_angle_of_ties=135,
    extension_factor_of_ties=2,
    dia_of_ties=8,
    number_spacing_check=True,
    number_spacing_value=10,
    dia_of_main_rebars=16,
    t_offset_of_rebars=40,
    b_offset_of_rebars=40,
    main_rebars_type="StraightRebar",
    hook_orientation="Top Inside",
    hook_extend_along="x-axis",
    l_rebar_rounding=None,
    hook_extension=None,
    ties_sequence=("Tie1", "Tie2"),
    structure=Structure1,
    facename="Face6",
)

# Create LShaped Rebars with hook along x-axis
RebarGroup = TwoTiesSixRebars.makeTwoTiesSixRebars(
    l_cover_of_ties=40,
    r_cover_of_ties=40,
    t_cover_of_ties=40,
    b_cover_of_ties=40,
    offset_of_ties=100,
    bent_angle_of_ties=135,
    extension_factor_of_ties=2,
    dia_of_ties=8,
    number_spacing_check=True,
    number_spacing_value=10,
    dia_of_main_rebars=16,
    t_offset_of_rebars=-40,
    b_offset_of_rebars=-40,
    main_rebars_type="LShapeRebar",
    hook_orientation="Top Outside",
    hook_extend_along="x-axis",
    l_rebar_rounding=2,
    hook_extension=40,
    ties_sequence=("Tie1", "Tie2"),
    structure=Structure2,
    facename="Face6",
)

COLUMN_UNITS = {
    "Diameter": "mm",
    "RebarLength": "m",
    "RebarsTotalLength": "m",
}

COLUMN_HEADERS = {
    "Host": ("Member", 1),
    "Mark": ("Mark", 2),
    "RebarsCount": ("No. of Rebars", 3),
    "Diameter": ("Diameter in " + COLUMN_UNITS["Diameter"], 4),
    "RebarLength": ("Length in " + COLUMN_UNITS["RebarLength"] + "/piece", 5),
    "RebarsTotalLength": ("Total Length in " + COLUMN_UNITS["RebarsTotalLength"], 6),
}

DIA_WEIGHT_MAP = {
    6: FreeCAD.Units.Quantity("0.222 kg/m"),
    8: FreeCAD.Units.Quantity("0.395 kg/m"),
    10: FreeCAD.Units.Quantity("0.617 kg/m"),
    12: FreeCAD.Units.Quantity("0.888 kg/m"),
    14: FreeCAD.Units.Quantity("1.206 kg/m"),
    16: FreeCAD.Units.Quantity("1.578 kg/m"),
    18: FreeCAD.Units.Quantity("2.000 kg/m"),
    20: FreeCAD.Units.Quantity("2.466 kg/m"),
    22: FreeCAD.Units.Quantity("2.980 kg/m"),
    25: FreeCAD.Units.Quantity("3.854 kg/m"),
    28: FreeCAD.Units.Quantity("4.830 kg/m"),
    32: FreeCAD.Units.Quantity("6.313 kg/m"),
    36: FreeCAD.Units.Quantity("7.990 kg/m"),
    40: FreeCAD.Units.Quantity("9.864 kg/m"),
    45: FreeCAD.Units.Quantity("12.490 kg/m"),
    50: FreeCAD.Units.Quantity("15.410 kg/m"),
}

# To create Bill Of Material SVG for all rebars in a model
BillOfMaterial_SVG.makeBillOfMaterialSVG(
    column_headers=COLUMN_HEADERS,
    column_units=COLUMN_UNITS,
    dia_weight_map=DIA_WEIGHT_MAP,
    rebar_length_type="RealLength",
    font_family = "DejaVu Sans",
    font_filename = "DejaVuSans.ttf",
    font_size = 3,
    column_width = 30,
    row_height = 10,
    bom_left_offset = 6,
    bom_top_offset = 40,
    bom_min_right_offset = 6,
    bom_min_bottom_offset = 6,
    bom_table_svg_max_width = 0,
    bom_table_svg_max_height = 0,
    template_file = str(Path(BillOfMaterial_SVG.__file__).parent.absolute() / "BOMTemplate.svg"),
    output_file = None,
    reinforcement_group_by = "Host",
)

# To create Bill Of Material SVG for rebars in Structure1
BillOfMaterial_SVG.makeBillOfMaterialSVG(
    column_headers = COLUMN_HEADERS,
    column_units = COLUMN_UNITS,
    dia_weight_map = DIA_WEIGHT_MAP,
    rebar_length_type = "LengthWithSharpEdges",
    font_family = "DejaVu Sans",
    font_filename = "DejaVuSans.ttf",
    font_size = 3,
    column_width = 30,
    row_height = 10,
    bom_left_offset = 6,
    bom_top_offset = 40,
    bom_min_right_offset = 6,
    bom_min_bottom_offset = 6,
    bom_table_svg_max_width = 0,
    bom_table_svg_max_height = 0,
    template_file = str(Path(BillOfMaterial_SVG.__file__).parent.absolute() / "BOMTemplate.svg"),
    rebar_objects=[Structure1],
    reinforcement_group_by = "Host",
)