Arch Stairs/en: Difference between revisions
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
(9 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{docnav|[[Arch_Space|Space]]|[[Arch_Panel|Panel]]|[[Arch_Module|Arch]]|IconL=Arch_Space.svg |IconC=Workbench_Arch.svg |IconR=Arch_Panel.svg}} |
|||
{{Docnav |
|||
|[[Arch_Space|Space]] |
|||
|[[Arch_CompPanel|CompPanel]] |
|||
|[[Arch_Workbench|Arch]] |
|||
|IconL=Arch_Space.svg |
|||
|IconR=Arch_CompPanel.png |
|||
|IconC=Workbench_Arch.svg |
|||
}} |
|||
{{GuiCommand |
{{GuiCommand |
||
|Name=Arch Stairs |
|Name=Arch Stairs |
||
|MenuLocation=Arch → Stairs |
|MenuLocation=Arch → Stairs |
||
|Workbenches=[[ |
|Workbenches=[[Arch_Workbench|Arch]] |
||
|Shortcut=S R |
|Shortcut={{KEY|S}} {{KEY|R}} |
||
|SeeAlso=[[Arch Structure]], [[Arch Equipment]] |
|||
|Version=0.14 |
|Version=0.14 |
||
|SeeAlso=[[Arch_Structure|Arch Structure]], [[Arch_Equipment|Arch Equipment]] |
|||
}} |
}} |
||
==Description== |
==Description== |
||
The [[Arch Stairs]] tool allows you to build automatically several types of stairs. At the moment, only straight stairs (with or without a central landing) are supported. Stairs can be built from scratch, or from a straight [[Draft Line|line]], in which case the stairs follow the line. If the line is not horizontal but has a vertical inclination, the stairs will also follow its slope. |
|||
The [[Arch_Stairs|Arch Stairs]] tool allows you to build automatically several types of stairs. At the moment, only straight stairs (with or without a central landing) are supported. Stairs can be built from scratch, or from a straight [[Draft_Line|Draft Line]], in which case the stairs follow the line. If the line is not horizontal but has a vertical inclination, the stairs will also follow its slope. |
|||
See the [http://en.wikipedia.org/wiki/Stairs Stairs entry in wikipedia] for a definition of the different terms used to describe parts of stairs. |
|||
See the [https://en.wikipedia.org/wiki/Stairs Stairs entry in wikipedia] for a definition of the different terms used to describe parts of stairs. |
|||
[[Image:Arch Stairs example.jpg|640px]] |
[[Image:Arch Stairs example.jpg|640px]] |
||
Line 20: | Line 30: | ||
==Options== |
==Options== |
||
* Stairs share the common properties and |
* Stairs share the common properties and behaviors of all [[Arch_Component|Arch Components]] |
||
== |
==Usage== |
||
# Press the {{Button|[[Image:Arch_Stairs.svg|16px]] [[Arch Stairs]]}} button, or press {{KEY|S}}, {{KEY|R}} keys. |
|||
# Press the {{Button|[[Image:Arch_Stairs.svg|16px]] [[Arch_Stairs|Arch Stairs]]}} button, or press {{KEY|S}}, {{KEY|R}} keys. |
|||
# Adjust the desired properties. Some parts of the stairs, such as the structure, might not appear immediately, if any of the properties makes it impossible, such as a structure thickness of 0. |
# Adjust the desired properties. Some parts of the stairs, such as the structure, might not appear immediately, if any of the properties makes it impossible, such as a structure thickness of 0. |
||
==Properties== |
==Properties== |
||
===Data=== |
|||
Base |
|||
{{TitleProperty|Segment and Parts}} |
|||
* {{PropertyData|Align}}: The alignment of these stairs on their baseline, if applicable. |
|||
* {{PropertyData|Base}}: The baseline of these stairs, if any. |
|||
* {{PropertyData|Height}}: The total height of these stairs, if not based on a baseline, or the baseline is horizontal. |
|||
* {{PropertyData|Length}}: The total length of these stairs if no baseline is defined. |
|||
* {{PropertyData|Width}}: The width of these stairs. |
|||
* {{PropertyData|Abs Top|Vector}}: (read-only) The absolute top level the stairs lead to. |
|||
Steps |
|||
* {{PropertyData|Last Segment|Link}}: Last segment (flight or landing) of an Arch Stairs connecting to this segment. The start level of the stairs will be the end level of this last segment. |
|||
* {{PropertyData|Outline Left|VectorList}}: The left outline of the stairs. |
|||
* {{PropertyData|Outline Left All|VectorList}}: The left outline of all segments of the stairs. |
|||
* {{PropertyData|Outline Right|VectorList}}: The right outline of the stairs. |
|||
* {{PropertyData|Outline Right All|VectorList}}: The right outline of all segments of the stairs. |
|||
* {{PropertyData|Railing Height Left|Length}}: Height of the left railing of the stairs or landing. |
|||
* {{PropertyData|Railing Height Right|Length}}: Height of the right railing of the stairs or landing. |
|||
* {{PropertyData|Railing Left|String}}: Name of the left railing object. |
|||
* {{PropertyData|Railing Offset Left|Length}}: Offset of the left railing from the edge of the stairs or landing. |
|||
* {{PropertyData|Railing Offset Right|Length}}: Offset of the right railing from the edge of the stairs or landing. |
|||
* {{PropertyData|Railing Right|String}}: Name of the right railing object. |
|||
{{TitleProperty|Stairs}} |
|||
* {{PropertyData|Nosing}}: The size of the nosing. |
|||
* {{PropertyData|Number of Steps}}: The numbers of steps (risers) in these stairs. |
|||
* {{PropertyData|Riser Height}}: The height of the risers. |
|||
* {{PropertyData|Tread Depth}}: The depth of the treads. |
|||
* {{PropertyData|Tread Thickness}}: The thickness of the treads. |
|||
* {{PropertyData|Align|Enumeration}}: The alignment of the stairs on the baseline. Only used if a baseline is defined. Can be {{value|Left}}, {{value|Right}} or {{value|Center}}. |
|||
Structure |
|||
* {{PropertyData|Height|Length}}: The total height of the stairs. Only used if no baseline is defined, or if the baseline is horizontal. Ignored if {{PropertyData|Riser Height Enforce}} is non-zero. |
|||
* {{PropertyData|Length|Length}}: The total length of the stairs if no baseline is defined. Ignored if {{PropertyData|Tread Depth Enforce}} is non-zero. |
|||
* {{PropertyData|Width|Length}}: The width of the stairs. |
|||
* {{PropertyData|Width of Landing|FloatList}}: If the {{PropertyData|Number Of Steps}} is 1, the stairs object acts as a landing. When this is the case and the baseline is multi-segment, the width of first segment of the landing follows the {{PropertyData|Width}}, the widths of subsequent segments follow the list set here. |
|||
{{TitleProperty|Steps}} |
|||
* {{PropertyData|Landings}}: The type of landings. |
|||
* {{PropertyData|Stringer Offset}}: The offset between the border of the stairs and the structure. |
|||
* {{PropertyData|Blondel Ratio|Float}}: (read-only) The calculated Blondel ratio. This ratio indicates comfortable stairs and should be between 62 and 64cm or 24.5 and 25.5in. |
|||
* {{PropertyData|Stringer Width}}: The width of the stringers. |
|||
* {{PropertyData| |
* {{PropertyData|Landing Depth|Length}}: The depth of the landing of the flight, if enabled in {{PropertyData|Landings}}. Defaults to the {{PropertyData|Width}} if 0. |
||
* {{PropertyData| |
* {{PropertyData|Nosing|Length}}: The size of the nosing. |
||
* {{PropertyData| |
* {{PropertyData|Number Of Steps|Integer}}: The numbers of steps (risers). |
||
* {{PropertyData|Riser Height|Length}}: (read-only) The height of the risers. If {{PropertyData|Riser Height Enforce}} is 0 it is calculated ({{PropertyData|Height}} / {{PropertyData|Number of Steps}}). Else it is the same as {{PropertyData|Riser Height Enforce}}. |
|||
* {{PropertyData|Riser Height Enforce|Length}}: The enforced height of the risers. |
|||
* {{PropertyData|Riser Thickness|Length}}: The thickness of the risers. |
|||
* {{PropertyData|Tread Depth|Length}}: (read-only) The depth of the treads. If {{PropertyData|Tread Depth Enforce}} is 0 it is calculated ({{PropertyData|Length}} / {{PropertyData|Number of Steps}}). Else it is the same as {{PropertyData|Tread Depth Enforce}}. |
|||
* {{PropertyData|Tread Depth Enforce|Length}}: The enforced depth of the treads. |
|||
* {{PropertyData|Tread Thickness|Length}}: The thickness of the treads. |
|||
{{TitleProperty|Structure}} |
|||
* {{PropertyData|Connection Down Start Stairs|Enumeration}}: The type of connection between the lower floor slab and the start of the stairs. Can be {{value|HorizontalCut}}, {{value|VerticalCut}} or {{value|HorizontalVerticalCut}}. |
|||
* {{PropertyData|Connection End Stairs Up|Enumeration}}: The type of connection between the end of the stairs and the upper floor slab. Can be {{value|toFlightThickness}} or {{value|toSlabThickness}}. |
|||
* {{PropertyData|Down Slab Thickness|Length}}: The thickness of the lower floor slab. |
|||
* {{PropertyData|Flight|Enumeration}}: The direction of the flight after the landing. Can be {{value|Straight}}, {{value|HalfTurnLeft}} or {{value|HalfTurnRight}}. |
|||
* {{PropertyData|Landings|Enumeration}}: The type of landings. Can be {{value|None}} or {{value|At center}} ({{value|At each corner}} not implemented yet). |
|||
* {{PropertyData|Stringer Overlap|Length}}: The overlap of the stringers above the bottom of the treads. |
|||
* {{PropertyData|Stringer Width|Length}}: The width of the stringers. |
|||
* {{PropertyData|Structure|Enumeration}}: The structure type of the stairs. Can be {{value|None}}, {{value|Massive}}, {{value|One stringer}} or {{value|Two stringers}}. |
|||
* {{PropertyData|Structure Offset|Length}}: The offset between the border of the stairs and the structure. |
|||
* {{PropertyData|Structure Thickness|Length}}: The thickness of the structure. |
|||
* {{PropertyData|Up Slab Thickness|Length}}: The thickness of the upper floor slab. |
|||
* {{PropertyData|Winders|Enumeration}}: The type of winders. Not implemented. |
|||
==Limitations== |
|||
* Only straight stairs are available at the moment |
|||
* See the [http://forum.freecadweb.org/viewtopic.php?f=23&t=6534 forum entry] for circle stairs. |
|||
* See the [http://forum.freecadweb.org/viewtopic.php?f=9&t=4564 forum announcement]. |
|||
== Scripting == |
== Scripting == |
||
{{Emphasis|See also:}} [[Arch API]] and [[FreeCAD Scripting Basics]]. |
|||
{{Emphasis|See also:}} [[Arch_API|Arch API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]]. |
|||
The Stairs tool can be used in [[macros]] and from the [[Python]] console by using the following function: |
|||
The Stairs tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following function: |
|||
{{Code|code= |
{{Code|code= |
||
Stairs = makeStairs(baseobj=None, length=None, width=None, height=None, steps=None, name="Stairs") |
Stairs = makeStairs(baseobj=None, length=None, width=None, height=None, steps=None, name="Stairs") |
||
Line 71: | Line 117: | ||
}} |
}} |
||
==Limitations== |
|||
* Only straight stairs are available at the moment |
|||
* See the [http://forum.freecadweb.org/viewtopic.php?f=23&t=6534 forum entry] for circle stairs. |
|||
* See the [http://forum.freecadweb.org/viewtopic.php?f=9&t=4564 forum announcement]. |
|||
{{Docnav |
|||
{{docnav|[[Arch_Space|Space]]|[[Arch_Panel|Panel]]|[[Arch_Module|Arch]]|IconL=Arch_Space.svg |IconC=Workbench_Arch.svg |IconR=Arch_Panel.svg}} |
|||
|[[Arch_Space|Space]] |
|||
{{Arch Tools navi}} |
|||
|[[Arch_CompPanel|CompPanel]] |
|||
{{Userdocnavi}} |
|||
|[[Arch_Workbench|Arch]] |
|||
|IconL=Arch_Space.svg |
|||
|IconR=Arch_CompPanel.png |
|||
|IconC=Workbench_Arch.svg |
|||
}} |
|||
{{Arch Tools navi{{#translation:}}}} |
|||
{{Userdocnavi{{#translation:}}}} |
Revision as of 18:03, 18 February 2022
Arch Stairs |
Menu location |
---|
Arch → Stairs |
Workbenches |
Arch |
Default shortcut |
S R |
Introduced in version |
0.14 |
See also |
Arch Structure, Arch Equipment |
Description
The Arch Stairs tool allows you to build automatically several types of stairs. At the moment, only straight stairs (with or without a central landing) are supported. Stairs can be built from scratch, or from a straight Draft Line, in which case the stairs follow the line. If the line is not horizontal but has a vertical inclination, the stairs will also follow its slope.
See the Stairs entry in wikipedia for a definition of the different terms used to describe parts of stairs.
Two constructed stairs, one with a massive structure and a landing, and another one with a single stringer.
Options
- Stairs share the common properties and behaviors of all Arch Components
Usage
- Press the Arch Stairs button, or press S, R keys.
- Adjust the desired properties. Some parts of the stairs, such as the structure, might not appear immediately, if any of the properties makes it impossible, such as a structure thickness of 0.
Properties
Data
Segment and Parts
- DataAbs Top (
Vector
): (read-only) The absolute top level the stairs lead to. - DataLast Segment (
Link
): Last segment (flight or landing) of an Arch Stairs connecting to this segment. The start level of the stairs will be the end level of this last segment. - DataOutline Left (
VectorList
): The left outline of the stairs. - DataOutline Left All (
VectorList
): The left outline of all segments of the stairs. - DataOutline Right (
VectorList
): The right outline of the stairs. - DataOutline Right All (
VectorList
): The right outline of all segments of the stairs. - DataRailing Height Left (
Length
): Height of the left railing of the stairs or landing. - DataRailing Height Right (
Length
): Height of the right railing of the stairs or landing. - DataRailing Left (
String
): Name of the left railing object. - DataRailing Offset Left (
Length
): Offset of the left railing from the edge of the stairs or landing. - DataRailing Offset Right (
Length
): Offset of the right railing from the edge of the stairs or landing. - DataRailing Right (
String
): Name of the right railing object.
Stairs
- DataAlign (
Enumeration
): The alignment of the stairs on the baseline. Only used if a baseline is defined. Can beLeft
,Right
orCenter
. - DataHeight (
Length
): The total height of the stairs. Only used if no baseline is defined, or if the baseline is horizontal. Ignored if DataRiser Height Enforce is non-zero. - DataLength (
Length
): The total length of the stairs if no baseline is defined. Ignored if DataTread Depth Enforce is non-zero. - DataWidth (
Length
): The width of the stairs. - DataWidth of Landing (
FloatList
): If the DataNumber Of Steps is 1, the stairs object acts as a landing. When this is the case and the baseline is multi-segment, the width of first segment of the landing follows the DataWidth, the widths of subsequent segments follow the list set here.
Steps
- DataBlondel Ratio (
Float
): (read-only) The calculated Blondel ratio. This ratio indicates comfortable stairs and should be between 62 and 64cm or 24.5 and 25.5in. - DataLanding Depth (
Length
): The depth of the landing of the flight, if enabled in DataLandings. Defaults to the DataWidth if 0. - DataNosing (
Length
): The size of the nosing. - DataNumber Of Steps (
Integer
): The numbers of steps (risers). - DataRiser Height (
Length
): (read-only) The height of the risers. If DataRiser Height Enforce is 0 it is calculated (DataHeight / DataNumber of Steps). Else it is the same as DataRiser Height Enforce. - DataRiser Height Enforce (
Length
): The enforced height of the risers. - DataRiser Thickness (
Length
): The thickness of the risers. - DataTread Depth (
Length
): (read-only) The depth of the treads. If DataTread Depth Enforce is 0 it is calculated (DataLength / DataNumber of Steps). Else it is the same as DataTread Depth Enforce. - DataTread Depth Enforce (
Length
): The enforced depth of the treads. - DataTread Thickness (
Length
): The thickness of the treads.
Structure
- DataConnection Down Start Stairs (
Enumeration
): The type of connection between the lower floor slab and the start of the stairs. Can beHorizontalCut
,VerticalCut
orHorizontalVerticalCut
. - DataConnection End Stairs Up (
Enumeration
): The type of connection between the end of the stairs and the upper floor slab. Can betoFlightThickness
ortoSlabThickness
. - DataDown Slab Thickness (
Length
): The thickness of the lower floor slab. - DataFlight (
Enumeration
): The direction of the flight after the landing. Can beStraight
,HalfTurnLeft
orHalfTurnRight
. - DataLandings (
Enumeration
): The type of landings. Can beNone
orAt center
(At each corner
not implemented yet). - DataStringer Overlap (
Length
): The overlap of the stringers above the bottom of the treads. - DataStringer Width (
Length
): The width of the stringers. - DataStructure (
Enumeration
): The structure type of the stairs. Can beNone
,Massive
,One stringer
orTwo stringers
. - DataStructure Offset (
Length
): The offset between the border of the stairs and the structure. - DataStructure Thickness (
Length
): The thickness of the structure. - DataUp Slab Thickness (
Length
): The thickness of the upper floor slab. - DataWinders (
Enumeration
): The type of winders. Not implemented.
Limitations
- Only straight stairs are available at the moment
- See the forum entry for circle stairs.
- See the forum announcement.
Scripting
See also: Arch API and FreeCAD Scripting Basics.
The Stairs tool can be used in macros and from the Python console by using the following function:
Stairs = makeStairs(baseobj=None, length=None, width=None, height=None, steps=None, name="Stairs")
- Creates a
Stairs
object from the givenbaseobj
. - If
baseobj
is not given, it will uselength
,width
,height
, andsteps
, to build a solid object.
Example:
import Arch
Stairs = Arch.makeStairs(length=5000, width=1200, height=3000, steps=14)
- Elements: Wall, Structure, Curtain Wall, Window, Roof, Space, Stairs, Equipment, Frame, Fence, Truss, Profile, Pipe, Pipe Connector
- Reinforcements: Straight Rebar, U-Shape Rebar, L-Shape Rebar, Stirrup, Bent-Shape Rebar, Helical Rebar, Column Reinforcement, Beam Reinforcement, Slab Reinforcement, Footing Reinforcement, Custom Rebar
- Panels: Panel, Panel Cut, Panel Sheet, Nest
- Materials: Material, Multi-Material
- Organization: Building Part, Project, Site, Building, Level, External reference, Section Plane, Schedule
- Axes: Axis, Axes system, Grid
- Modification: Cut with plane, Add component, Remove component, Survey
- Utilities: Component, Clone component, Split Mesh, Mesh to Shape, Select non-manifold meshes, Remove Shape from Arch, Close Holes, Merge Walls, Check, Toggle IFC Brep flag, 3 Views from mesh, Create IFC spreadsheet, Toggle Subcomponents
- Additional: Preferences, Import Export Preferences (IFC, DAE, OBJ, JSON, 3DS, SHP), IfcOpenShell, IfcPlusPlus, Arch API
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub