0 Votes

Object commands

Last modified by Claudia Bless on 2026/08/26 10:21

The available scripts differ depending on the object or details table that is selected, see the various details table groups in the general tab and the tables below.

For most object commands, a message describing the outcome of the command, is printed out in the log window after usage.

Most object commands can be used on one or many selected objects. Some object commands, for example "Merge", requires that more than one object is selected. Preferable, objects of the same type should be selected before object commands are used.

The most common commands are presented in the table below, and in the following groups based on in which details tables they can be found. It is also possible to execute scripts by right-clicking the corresponding objects in for example the floor plan tab or 3D tab.

Rename...

Available on all zones and objects.

Changes the name of the selected object.

Save to palette

Available on all palette objects.

Saves the dimensions and input data as a resource in the palette, which can be accessed at a later time. All objects with an active link to a palette object are changed along with the palette parent.

Run script on

Available on all zones and objects.

This allows code to be ran on a manual selection of objects instead of having to define or omit object in the script code. See also the IDA Simulation Environment scripts table of content

N.B scripts will not be run correctly if the code is non-compatible with the object type.

Where is it used

Available on: energy meters, wall constructions, schedules, and other common resources not placed physically in the model.

This shows the locations where a resource has been used. It is useful to quickly ensure that connections are made according to the actual design, or for energy meters to verify what components are logged by which meters.

Write to database

Available on all palette objects and resources

Allows a resource (for example a schedule, wall or window type, zone template, etc.) to be saved by ICE on your computer to be used in additional models. Otherwise, saved resources by using "save to palette" above are only available the specific project (.idm-file). 

Replace

Available on all palette objects and resources

Allows to replace an object with another while keeping user defined values, reset default values and/or keep existing objects.

Select all objects with the same value

Available for all objects in the Details table

This selects all objects with the same value (in the active column).


Details table: Zones

Merge Zones

(beta)

Available on zones

This command merges zones into one new zone. It is useful for making complex shapes such as L-shapes in the hight/z-axis.

Duplicate as building body(ies)

Available on zones and imported CAD data.

Creates new building bodies with the same geometry as selected thermal zones. Windows and openings are ignored. This can be used to create building bodies based on thermal zones created from IfcSpaces with non-prismatic geometry (currently not implemented). This may cause gaps between building bodies but due to the tolerance in IDA ICE thermal connections are often correct but it is recommended to merge adjacent building bodies when possible, to reduce the number of objects. 

Clone select zone(s)

Available on zones

This creates a new unsaved IDA ICE file with the same building body(ies) and external geometries, AHUs, etcetera but with only the choses zones. This is useful for sensitivity analysis, error checking, etcetera.

Reset zone to template...

Available on zones

Resets selected thermal zone's properties according to a chosen zone template. This is useful to quickly reset a lot of zones to new internal loads, setpoints, etcetera. The reset parameters are chosen in the form below which opens after using the script. 

. 1731489313442-854.png

Move the object to the centre of the surface

Available on objects in the "Internal gains" details table.

Moves selected objects into the centre of the floor or roof.

This is useful if these objects for some reason have ended up outside of zones.

Note: If this is used on more than one object in the zone the objects will end up in the same position. Also note that the midpoint of the floor or roof might be outside of the surface, for example for L-shaped zones. 


Details table: Surfaces

Move the object to the building body

Only available on windows and openings.

Moves the objects from the thermal zone to a the corresponding fixed position in the building body. This is useful if room layouts are changing but the window placement on the external wall is supposed to be kept. Note that this requires a building body in the same location and with the same direction. 

Move the object to the zone

Only available on windows and openings.

The reverse command from "move the object to the building body".

Update shape to geometry

Available for all surface objects.

Changes the size of an object to match the offset (measures from the surrounding borders) as chosen in the form. This command is useful for non-rectangular shaped surfaces, especially in combination with “Insert new object”- command.

1729514674604-202.png

Insert new Objects    

Only available in on Zone Surfaces and Building body faces.

Insert object(s) on selected surfaces with the same settings. The objects are inserted in a selectable number of rows and columns to create an imaginary on a rectangular grid with the same orientation as the coordinate system of the surfaces. For objects with width and height, for example radiators, wall parts and measuring planes the percentage of this imaginary grid can also be set. Note that this command can create objects outside of the surfaces if the surface is not rectangular and that objects with a given size, for example resources can overlap. This command is useful to create single objects on many surfaces, for example one window on each external wall to the north (by selecting these surfaces), create patterns of objects, for example fill a floor with wall parts or place a number of sensors or supply terminals. Note that occupants, equipment and light cannot be inserted with this command since they do not belong to surfaces. 

1729514718958-332.png


Details table: Geometry and systems

Duplicate as zone(s)

Available on building bodies. 

This script duplicates a building body into a zone. This is useful for if an IFC file did not contain spaces, but the building body could be imported.

Merge building bodies 

(beta)  

Available when right-clicking more than one building body.

This will merge multiple building bodies into one building body. 

Split building body horizontally

(beta)

Available on building bodies. 

This script creates a horizontal plane which divides a building body in two. Enter the desired height for the cut in the form.

1731502330599-348.png

Duplicate as an imported CAD object

Available on building bodies (and CAD objects and IFC geometries)

This script duplicates an object into one single CAD object.

This is useful for if you want to group many geometrical objects to for example adjust shading objects on one single object.

Crop building body(ies) against the selected

(beta) 

Available on building bodies. 

This command selects one building body and removes all areas where it overlaps with other building bodies.

This is useful for creating building bodies with complex geometries which can otherwise only be created by importing external geometries. See examples below, if the command is ran on the red building body the right-hand building is produced.

1731503484304-643.png       1731503884662-415.png

Note that this command could create single building bodies consisting of separated closed volumes.

Note that this command can be destructive and therefore it is recommended to use the command with caution.

Edit roofAvailable on roof faces in the "facades and roofs" details table. Opens the roof editor. 

Details table: Measuring

Extrude as building body(ies)

Available for measuring planes.

Enter the extension length difference for the new building body. This script will extrude the geometry perpendicular to the object(s) - N.B not necessarily vertically.

1729517358707-556.png

Extrude down as building body(ies)

Available for measuring planes (and IFC geometries).

See below Tables:IFC


Details table: IFC

Duplicate as face window(s)

Available on IFC geometries and IFC windows

Creates a face object on the building body according to the mapping form below. Select the resource the IFC object(s) should be converted into and press OK.

See also IFC import for more information on the IFC mapping forms.

1731504256310-943.png

Duplicate as face openings(s)

Available on IFC geometries and IFC windows.

Same as above, but creates openings (closed or open doors/holes).

Extrude down as building body(ies)

Available on IFC geometries

Enter the z-value for the flat base of the new building body. The selected geometry will extrude straight down vertically to the z-value defined in the form, potentially creating angled top surfaces.

1729517381358-846.png

See example in the images below. The IFC geometry marked in red turns into the following image when extruded with this command. (Two additional generated building bodies below the soffits has been deleted)

1731505958171-430.png

1731506069223-396.png

Duplicate as imported CAD object(s)

Available on more than one marked IFC geometry or CAD geometry.

Creates a CAD object copy for each chosen object. Not that this creates many CAD objects. See above Geometry and systems for general purpose.

Duplicate as an imported CAD object

Available on CAD objects and IFC geometries (and building bodies )

See above Geometry and systems.

Duplicate as building bodies 

Available on IFC geometries

See above tables:Zones.


Floor plan

These scripts are available in the floor plan tab.
Several of the scripts described above are available on the same type of object(s). Addtionally, the following scripts can be found.

Adjust to IFC

Available on Zones

This adjusts all surrounding faces in the selected zone(s) to snap to IFC Walls.

It is useful to ensure right angles and to avoid errors which may produce intersecting walls. See image examples before and after.

1731576152583-681.png          1731576169989-561.png

Split zone with a wall

(beta)

Available on Zones

This function allows you to draw lines which can split existing zones according to the default internal wall thickness. The walls have to start and stop outside a zone. This is useful to subdivide a big zone according to the lines in a CAD or IFC drawing.

Split zone with a slab

(beta)

Available on Zones

This function allows you to define a height which splits an existing zone vertically according to the default interior slab height.