Arch Add

Previous: Cut with plane

Next: Remove component

Arch

Arch Add
Menu location
Arch → Add
Workbenches
Arch
Default shortcut
None
Introduced in version
-
See also
Arch Remove

Description

The Add tool allows you to do 4 kinds of operations:

• Add shape-based objects to an Arch component, such as a wall or structure. These objects make then part of the Arch component, and allow you to modify its shape but keeping its base properties such as width and height
• Add Arch components, such as a Arch Walls or Arch Structures, to a group-based arch object such as Arch Floors.
• Add Axis systems to structural objects
• Add objects to section planes

The counterpart of this tool is the Arch Remove tool.

A box added to a wall as a component.

Usage

1. Select the objects to be added together. The last object selected will be the host Arch object.
2. Press the button, or use Arch → Add from the top menu.

Scripting

See also: Arch API and FreeCAD Scripting Basics.

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

addComponents(objectsList, host)

The above code snippet adds the given objects in objectsList to the given host object.

Note: objectsList can be a single object or a list of objects.

Example:

import FreeCAD, Arch, Draft, Part

p1 = FreeCAD.Vector(0, 0, 0)
p2 = FreeCAD.Vector(2000, 2000, 0)

Line = Draft.makeWire([p1, p2])
Wall = Arch.makeWall(Line, width=150, height=2000)

p3 = FreeCAD.Vector(0, 2000, 0)
p4 = FreeCAD.Vector(3000, 0, 0)

Line2 = Draft.makeWire([p3, p4])
Wall2 = Arch.makeWall(Line2, width=150, height=2000)
FreeCAD.ActiveDocument.recompute()

Arch.addComponents(Wall2, Wall)
FreeCAD.ActiveDocument.recompute()

Previous: Cut with plane

Next: Remove component

Arch

Arch

• Elements: Wall, Structure, Roof, Window, Door, Stairs, Space, Frame, Equipment; Pipe, Pipe Connector; Schedule
• Reinforcements: Rebar; Straight Rebar, UShape Rebar, LShape Rebar, Bent Shape Rebar, Stirrup Rebar, Helical Rebar
• Panels: Panel, Panel Cut, Panel Sheet, Nest
• Materials: Material, Multi-Material
• Organization: Site, Reference, Building, Floor, Building Part, Section Plane
• 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-solid meshes, Remove Shape, Close Holes, Merge Walls, Check, Ifc Explorer, Toggle IFC Brep flag, 3 Views from mesh, Create IFC spreadsheet, Toggle Subcomponents
• Additional: Preferences, Import Export Preferences (IFC, DAE, OBJ, JSON, 3DS), IfcOpenShell, IfcPlusPlus; Arch API

User documentation

• 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, Draft, FEM, Image, Inspection, Mesh, OpenSCAD, Part, PartDesign, Path, Points, Raytracing, Reverse Engineering, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
• Deprecated or unmaintained workbenches: Complete, Drawing, Robot

---

• Addons: Addon Manager, External workbenches, Scripting and macros

---

• Hubs: User hub, Power users hub, Developer hub