# Insertion

The basis for insertion is the coordinate systems as described in the chapter 'Basic Technologies - Coordinate Systems'.

### Composite elements - Insertion - Positioning point

When inserting the composite element, a positioning point can be queried automatically. The insertion coordinate system is then located at this point, and all further operations refer to it. The elevation, that is, the Z coordinate of the insertion coordinate system, can be determined automatically in various ways via 'Insertion point height'.

Positioning point - Selection

* When inserting in plan, an angle can be specified. The insertion coordinate system is rotated by this angle.
* When inserting in plan, the positioning point can be selected on a preview of the composite element. The enclosing rectangle and the center point are offered. In addition, the composite element can be rotated in 90° increments with the right mouse button.
* When inserting along a wall or frame edge and in a wall or frame view, the composite element is offered in various positions relative to the insertion point along the X direction: left edge flush, right edge flush, center flush, and position as defined in the composite element, if different from the 3 standard positions.

Positioning point - direct insertion point

* Insertion takes place directly at the insertion point, as defined in the composite element.
* The orientation of the insertion coordinate system is then parallel to the respective base coordinate system. See also chapter 'Coordinate Systems'.

Positioning point - No query

* This setting is often useful when query points are used. In that case, insertion also takes place at those points, and the further query of a positioning point or orientation is unnecessary.
* If no insertion coordinate system is defined subsequently, the base coordinate system is used as the insertion coordinate system.
* In this case, no 'Insertion point height' can be determined either; this selection is then locked.

### Composite elements - Insertion - - Insertion point height

The elevation, that is, the Z coordinate of the insertion coordinate system, can be determined automatically in various ways via 'Insertion point height'.

* Various options are offered for determining the Z position (height) of the insertion coordinate system.
* This input is locked for composite element type = door, window
* This input is locked for positioning point = No query.

Insertion point height - according to composite element type

* Z = 0 of the respective base coordinate system is used.

Insertion point height - query

* When inserting the composite element, the Z position of the insertion coordinate system can be specified during variable query by combining 3 values.
* The 'Lower edge floor US height' is the absolute height of the lower edge of the current floor. If no floor is currently active or available, global 0 is offered here.
* In 'Top edge of slab to lower edge floor DS' the distance from the lower edge of the floor to the top edge of the slab, that is, the floor buildup, can be specified. This is added to the Z position relative to the lower edge of the floor.\
  If slab fields are present, a suggested value is determined: from all slab fields whose top edge lies within the range lower edge of current floor plus/minus 1.00 m, the lowest slab is selected. The distance from its top edge to the lower edge of the floor is calculated and entered. All slab fields in this range are included, regardless of which floor they belong to.
* Finally, in 'Insertion point height above top edge slab ED' the distance from the insertion point to the top edge of the floor buildup defined above is specified. This is also added for the final Z position of the insertion point.

Insertion point height - Auto top edge slab

* When inserting the composite element, the insertion point is automatically placed on the top edge of the detected slab.
* For this purpose, the corresponding slab field is searched according to specific rules at the point determined by the mouse. For insertion in plan, this is directly at the mouse cursor. For insertions in wall or frame, the search is performed at a small distance before or after the building element. If input is made on the front side of the wall, a slab field ending at the rear side or within the wall is ignored.
* Model areas plan, wall construction, roof, frame: If slab fields are present, the slab field is determined as follows: from the slab fields found at the insertion point whose top edge lies within the range lower edge of current floor plus/minus 1.00 m, the highest slab is selected. All slab fields in this range are included, regardless of which floor they belong to. If no suitable slab field can be found, the lower edge of the current floor is used automatically.
* Model area ceiling construction: The current slab field is taken into account automatically.

Insertion point height - Auto lower edge floor

* The insertion coordinate system is automatically placed at the height of the lower edge of the current floor.
* -If no floor is currently active or available, global 0 is used here.

Insertion point height - Auto lower edge wall, frame

* The insertion coordinate system is automatically placed at the height of the lower edge of the current wall or current frame.
* This option can sensibly be used only for composite element types 'Insertion in wall', '.. wall view', '.. frame' or '.. frame view'.

Insertion point height - global 0.0

* The insertion coordinate system is automatically placed at global height 0.

### Composite elements - Insertion - insertion coordinate system

In the base coordinate system, an insertion coordinate system is defined by 3 points. The coordinates of the points are calculated using formulas; these coordinates refer to the base coordinate system. All further coordinate specifications in the composite element refer to the insertion coordinate system.

The insertion coordinate system is described by 3 points:\\

1. Origin\\
2. Point in the direction of the X-axis\\
3. Point in the positive ZoX plane.

If an insertion coordinate system is defined via query points, the variables P1X, P1Y, etc. are used here. At this moment, they still refer to the base coordinate system. They are then converted to the insertion coordinate system. If the variable P1X is used further on in the composite element, the value refers to the coordinate in the insertion coordinate system.

### Composite elements - Insertion - for door, window

In the lower area of the dialog are the entries that are used only for 'composite element type = door, window'. Here, the insertion coordinate system is determined automatically at the door or window opening. Initially, the insertion coordinate system is the same as that of the wall (base coordinate system) and is then shifted and rotated using the following parameters.

The same principles are used here as when inserting library elements at door and window openings in the HRB system.

additional text for the window description:

* This text is appended to the window description. In the list output, it also appears in the description.

Position, Y offset

* The insertion coordinates are moved to this position and then additionally shifted by the offset in the Y direction. With a positive offset, the shift is inward to the position.
* Positions -8 to +8 are used. -8 and +8 each mean on the surface of the wall.

Reference edge, offset

* First, the reference edge for the Z position of the insertion coordinate system is set. The upper and lower wall edge as well as the upper and lower opening edge are available.
* Then the shift is performed with the offset in the Z direction. The principles are opposite to the HRB system: a positive offset increases the opening area. This results in the following shifts:

| Reference edge      | negative offset | positive offset |
| ------------------- | --------------- | --------------- |
| top wall edge       | upward (+Z)     | downward (-Z)   |
| bottom wall edge    | downward (-Z)   | upward (+Z)     |
| top opening edge    | downward (-Z)   | upward (+Z)     |
| bottom opening edge | upward (+Z)     | downward (-Z)   |

Installation on opening side, X offset

* The insertion coordinate system is optionally set to the left or right opening edge.
* Then the shift is performed with the X offset in the X direction. The principles are opposite to the HRB system: a positive offset increases the opening area. This results in the following shifts:

| Reference edge     | negative offset   | positive offset   |
| ------------------ | ----------------- | ----------------- |
| left opening side  | to the right (+X) | to the left (-X)  |
| right opening side | to the left (-X)  | to the right (+X) |

Rotation angle about Z

* The insertion coordinate system is rotated about its Z-axis.
* Unlike in HRB, any angle may be specified, not only in 90° increments.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dietrichs.com/dietrichs-intelligent-documentation/docs-de-en/combined-elements/create-edit-combined-elements/insertion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
