Arch Axis/en: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
Line 1: Line 1:
{{GuiCommand/en|Name=Arch Axis|Workbenches=[[Arch Module|Arch]]|MenuLocation=Arch -> Axis|Shortcut=A X}}
{{GuiCommand|Name=Arch Axis|Workbenches=[[Arch Module|Arch]]|MenuLocation=Arch Axis|Shortcut=A X|SeeAlso=[[Arch AxisSystem|Axis System]]}}


==Description==
==Description==


The Axis tool allows you to places an axes system in the current document. The distance and the angle between axes is customizable, as well as the numbering style. The axes serve mainly as references to snap objects onto, but can also be used together with [[Arch Structure|structures]] to create parametric arrays of beams or columns.
The Axis tool allows you to places a series of axes in the current document. The distance and the angle between axes is customizable, as well as the numbering style. The axes serve mainly as references to snap objects onto, but can also be used together with [[Arch AxisSystem|Axes Systems]], and can also be referenced by other Arch objects to create parametric arrays, for example of beams or columns.


[[Image:Arch Axis example.jpg|600px]]
[[Image:Arch Axis example.jpg|600px]]

The image above shows two different axis objects positioned perpendicularly to each other


==How to use==
==How to use==
Line 15: Line 17:
==Options==
==Options==


* Each axis in an axes system has its own distance and angle in relation to the previous axis. This allows to do very complex systems such as non-orthogonal systems, polar systems or any kind of non-uniform system.
* Each axis in the series has its own distance and angle in relation to the previous axis. This allows to do very complex systems such as non-orthogonal systems, polar systems or any kind of non-uniform system
* Double-clicking the axis in the tree view allows to edit the distances, angles and labels of each axis
* Axes length, size of the bubbles and numbering styles are customizable directly via the axes system's properties
* Axes length, size of the bubbles and numbering styles are customizable directly via the axes system's properties
* Each axis can also display a label, also editable via the task panel dialog

==Structural systems==

The main use of axes systems is simply to give you reference lines to snap to, but they can also be used to automatically build structural arrays, such as columns grids and beam layouts:

[[Image:Arch Axis example2.jpg|600px]]

To obtain that result, one or more axes systems must be added to a [[Arch Structure|structural element]], turning it into an array. If one axes system is added, the element is copied once on each line of the system, like the beams on the image above. If two systems are added, the element is copied once on each intersection of the two systems, like the columns on the image above. The same axes systems can of course be used in several structural objects.

# Create an [[Arch Structure]] object
# Create one or more [[Arch Axis|axes systems]]
# Select one or more axes systems, then the structure object
# Press the {{KEY|[[Image:Arch Add.png|16px]] [[Arch Add]]}} button
# By entering the edit mode of the structure object (double-clicking it in the tree view), you can add or remove axes systems from it.


==Properties==
==Properties==
Line 37: Line 27:
* {{PropertyView|Bubble Size}}: The size of the axis bubbles
* {{PropertyView|Bubble Size}}: The size of the axis bubbles
* {{PropertyView|Numeration style}}: How the axes are numbered: 1,2,3, A,B,C, etc...
* {{PropertyView|Numeration style}}: How the axes are numbered: 1,2,3, A,B,C, etc...
* {{PropertyView|Bubble Position}}: Where the bubble is placed on the axis: At start point, endpoint, both or none.
* {{PropertyView|Font Name}}: A font to draw the bubble number and/or labels
* {{PropertyView|Font Size}}: The size of the label text only (bubble text is controlled by the bubble size)
* {{PropertyView|Show Labels}}: Turns the display of the label texts on/off


==Scripting==
==Scripting==
Line 44: Line 38:
makeAxis ([number],[interval])
makeAxis ([number],[interval])
}}
}}
:makes an Axis System based on the given number of axes and interval distance
:makes an axes series based on the given number of axes and interval distance


Example:
Example:

Revision as of 19:55, 14 March 2018

Arch Axis

Menu location
Arch → Axis
Workbenches
Arch
Default shortcut
A X
Introduced in version
-
See also
Axis System

Description

The Axis tool allows you to places a series of axes in the current document. The distance and the angle between axes is customizable, as well as the numbering style. The axes serve mainly as references to snap objects onto, but can also be used together with Axes Systems, and can also be referenced by other Arch objects to create parametric arrays, for example of beams or columns.

The image above shows two different axis objects positioned perpendicularly to each other

How to use

  1. Press the Arch Axis button, or press A then X keys
  2. Move/rotate the axes system to the desired position
  3. Enter edit mode by double-clicking the axes system in the tree view to adjust its settings like number of axes, distances and angles between axes.

Options

  • Each axis in the series has its own distance and angle in relation to the previous axis. This allows to do very complex systems such as non-orthogonal systems, polar systems or any kind of non-uniform system
  • Double-clicking the axis in the tree view allows to edit the distances, angles and labels of each axis
  • Axes length, size of the bubbles and numbering styles are customizable directly via the axes system's properties
  • Each axis can also display a label, also editable via the task panel dialog

Properties

  • DataLength: The length of the axes
  • ViewBubble Size: The size of the axis bubbles
  • ViewNumeration style: How the axes are numbered: 1,2,3, A,B,C, etc...
  • ViewBubble Position: Where the bubble is placed on the axis: At start point, endpoint, both or none.
  • ViewFont Name: A font to draw the bubble number and/or labels
  • ViewFont Size: The size of the label text only (bubble text is controlled by the bubble size)
  • ViewShow Labels: Turns the display of the label texts on/off

Scripting

The Axis tool can by used in macros and from the python console by using the following function:

makeAxis ([number],[interval])
makes an axes series based on the given number of axes and interval distance

Example:

import Arch
Arch.makeAxis(5,2)