View source for Reinforcement ColumnRebars Circular/it

<languages/>
{{docnav|[[Arch_Rebar_ColumnReinforcement_TwoTiesSixRebars|ColumnReinforcement TwoTiesSixRebars]]|[[Arch_Rebar|Rebar]]|[[Arch_Module|Arch]]|IconL=Arch_Rebar_ColumnReinforcement.svg|IconC=Workbench_Arch.svg|IconR=Arch_Rebar.png}}

{{GuiCommand/it
|Name=Arch Rebar ColumnReinforcement
|Name/it=Rinforzo di colonna
|MenuLocation=Arch → Strumenti armatura
|Workbenches=[[Arch Workbench/it|Arch]], [[BIM Workbench/it|BIM]]
|SeeAlso=[[Arch_Rebar_ColumnReinforcement_TwoTiesSixRebars/it|Rinforzo di colonna con 2 staffe e 6 barre]], [[Arch Rebar/it|Armatura]]
|Version=0.19
}}

==Description==

Lo strumento [[Arch_Rebar_Circular_ColumnReinforcement/it|Rinforzo di colonna rotonda]] consente all'utente di creare delle barre di rinforzo all'interno di un oggetto [[Arch Structure/it|Struttura]] Colonna.

This command is part of the [[Reinforcement Addon]], that you can install with the [[Addon Manager]] via the menu {{MenuCommand|Tools → Addon manager → Reinforcement}}.

[[Image:Arch_Rebar_Circular_ColumnReinforcement_example.png|400px]]
{{Caption|Circular Column Reinforcement inside a Column [[Arch Structure]]}}

==How to use==

1. Select top face of a previously created {{Button|[[Image:Arch_Structure.svg|16px]] [[Arch Structure]]}} object. <br>
2. Then select  {{Button|[[Image:Arch_Rebar_ColumnReinforcement.svg|16px]] [[Arch Rebar ColumnReinforcement|Column Reinforcement]]}} from the rebar tools. <br>
3. A dialog box will pop-out on screen as shown below. <br>
[[Image:ColumnReinforcementDialog_Ties.png|700px]]
{{Caption|Dialog Box for the Arch Rebar ColumnReinforcement tool}}
4. Select the Circular Column radio button in column reinforcement dialog. <br>
[[Image:CircularColumnReinforcementDialog.png|700px]]
{{Caption|Dialog Box for Circular Column Reinforcement}}
5. Give inputs for data related to circular column reinforcement. <br>
6. Click {{Button|OK}} or {{Button|Apply}} to generate circular column reinforcement. <br>
7. Click {{Button|Cancel}} to exit the dialog box. <br>


==Properties== 

'''Helical Rebars:'''
* {{PropertyData|Side Cover}}: The distance between rebar to the curved face.
* {{PropertyData|Top Cover}}: The distance between rebar from the top face of the structure.
* {{PropertyData|Bottom Cover}}: The distance between rebar from the bottom face of the structure.
* {{PropertyData|Pitch}}: The pitch of a helix is the height of one complete helix turn, measured parallel to the axis of the helix.
* {{PropertyData|Diameter}}: Diameter of the rebar.

'''Main Rebars:'''
* {{PropertyData|Top Offset}}: The distance between rebars from the top face of the structure.
* {{PropertyData|Bottom Offset}}: The distance between rebars from the bottom face of the structure.
* {{PropertyData|Diameter}}: Diameter of the main rebars.
* {{PropertyData|Number}}: The number of main rebars.
* {{PropertyData|Angle}}: The angular distance between ties.

==Scripting==

{{Emphasis|See also:}} [[Arch API]], [[Reinforcement API]] and [[FreeCAD Scripting Basics]].

The ColumnReinforcement tool can be used in [[macros]] and from the [[Python]] console by using the following function:

=== Create Circular Column Reinforcement ===
{{Code|code=
RebarGroup = CircularColumn.makeReinforcement(
    s_cover,
    helical_rebar_t_offset,
    helical_rebar_b_offset,
    pitch,
    dia_of_helical_rebar,
    main_rebars_t_offset,
    main_rebars_b_offset,
    dia_of_main_rebars,
    number_angle_check,
    number_angle_value,
    structure=None,
    facename=None,
)

}}

* Creates a {{incode|RebarGroup}} object from the given {{incode|structure}}, which is an [[Arch Structure]], and {{incode|facename}}, which is a face of that structure.
** If no {{incode|structure}} nor {{incode|facename}} are given, it will take the user selected face as input.
* {{incode|s_cover}}, {{incode|helical_rebar_t_offset}}, and {{incode|helical_rebar_b_offset}} are inner offset distances for the helical rebar with respect to the faces of the structure. They are respectively the side, top and bottom offsets.
* {{incode|pitch}} is the parameter that determines how close or far apart each helical loop is to each other.
* {{incode|dia_of_helical_rebar}} is the diameter of the helical rebar inside the structure.
* {{incode|main_rebars_t_offset}} and {{incode|main_rebars_b_offset}} are inner offset distances for the main rebars with respect to the top and bottom faces of the structure, respectively.
* {{incode|dia_of_main_rebars}} is the diameter of the main rebars.
* {{incode|number_angle_check}} if it is {{incode|True}} it will create as many main rebars as given by {{incode|number_angle_value}}; if it is {{incode|False}} it will create main rebars at an angle of {{incode|number_spacing_value}}, specified in degrees.
* {{incode|number_angle_value}} specifies the number of main rebars, or the value of the angle between the main rebars, depending on {{incode|number_angle_check}}.


==== Example ====
{{Code|code=
import FreeCAD, Draft, Arch
from ColumnReinforcement import CircularColumn

Circle = Draft.makeCircle(radius=250)
Structure = Arch.makeStructure(Circle)
Structure.ViewObject.Transparency = 80
FreeCAD.ActiveDocument.recompute()

RebarGroup = CircularColumn.makeReinforcement(
    s_cover=20,
    helical_rebar_t_offset=40,
    helical_rebar_b_offset=40,
    pitch=50,
    dia_of_helical_rebar=8,
    main_rebars_t_offset=20,
    main_rebars_b_offset=20,
    dia_of_main_rebars=16,
    number_angle_check=True,
    number_angle_value=6,
    structure=Structure,
    facename="Face3",
).rebar_group

}}

=== Edition of Circular Column Reinforcement ===
You can change the properties of the halical and main rebars with the following function
{{Code|code=
rebar_group = editReinforcement(
    rebar_group,
    s_cover,
    helical_rebar_t_offset,
    helical_rebar_b_offset,
    pitch,
    dia_of_helical_rebar,
    main_rebars_t_offset,
    main_rebars_b_offset,
    dia_of_main_rebars,
    number_angle_check,
    number_angle_value,
    structure=None,
    facename=None,
)

}}

* {{incode|rebar_group}} is a previously created {{incode|ColumnReinforcement}} group object.
* The other parameters are the same as required by the {{incode|makeSingleTieFourRebars()}} function.
* {{incode|structure}} and {{incode|facename}} may be omitted so that the rebar stays in the original structure.

==== Example ====
{{Code|code=
from ColumnReinforcement import CircularColumn

rebar_group = CircularColumn.editReinforcement(
    rebar_group,
    s_cover=30,
    helical_rebar_t_offset=30,
    helical_rebar_b_offset=30,
    pitch=60,
    dia_of_helical_rebar=10,
    main_rebars_t_offset=-30,
    main_rebars_b_offset=-30,
    dia_of_main_rebars=18,
    number_angle_check=False,
    number_angle_value=45,
    structure=Structure,
    facename="Face3",
)

}}

{{docnav|[[Arch_Rebar_ColumnReinforcement_TwoTiesSixRebars|ColumnReinforcement TwoTiesSixRebars]]|[[Arch_Rebar|Rebar]]|[[Arch_Module|Arch]]|IconL=Arch_Rebar_ColumnReinforcement.svg|IconC=Workbench_Arch.svg|IconR=Arch_Rebar.png}}

{{Arch Tools navi}}

{{Userdocnavi}}

[[Category:Reinforcement]]