Get element
get_elementOne object by GlobalId - element, storey, space, opening, type object, IfcGrid (axes), IfcAnnotation (annotation), IfcStructuralItem (representation: its topology). Sections by include, named as in IFC: attributes, psets (effective values with from: type|occurrence; a predefined Set.Prop another class or set shares: Set[Class].Prop, several of one class Set[Class#n].Prop in entity id order), qtos, relations (inverse attributes: IsTypedBy, ContainedInStructure, Decomposes, HasOpenings, FillsVoids ...), material (hatching as fill_styles; dash pattern, line width, PatternStart not read), representation (RepresentationType; body_gap there: a body not stored, not no body; a type object: RepresentationMaps with mapped_by, a Body map is what like places; prism at a tessellated segment, beam, column: length, axis, sections measured, diameter only an assumption), placement; and frame (own axes s/t/h), faces, snap_points; mesh (points + faces as create_elements.mesh takes them, face_colours from a colour map; move_points true: each point is a from of edit_mesh move_points; n_faces_not_polygonal > 0: curved faces left out; capped: no lists; defects of a file mesh (closed, kinds, examples; world m) - a boundary_edge point is an at for edit_mesh close_hole; measured bodies: defects_not_read); appearance (an element: colour, style with transparency 0..1, layers); terrain (an IfcGeographicElement moddl derives: its entries with ids, current or stale). The range values in frame and faces (s_range, range) are metres from the origin of their block along its axis (s/t/h or dir), not world coordinates. IfcProject reads attributes, psets, relations; site, building, storey and space those and qtos, placement (space also outline); a group or other root attributes, psets, qtos, relations; opening, port, system and zone fewer: the rest answers not_read or is refused; analysis model loads and supports in SI, results counted only. Read-only.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_element"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guid | No | GlobalId of the object; in a catalog also the entry by GlobalId | |
| name | No | With library only: the entry by Name, e.g. HEA 200 | |
| class | No | With library and name only: just the type for this class (IfcColumn or IfcColumnType) | |
| points | No | IfcAlignment only: world points [x,y,z] in m; a row each with station_m, offset_m, offset_vertical_m, height_above_axis_m, source, or the reason (never clamped) | |
| columns | No | IfcGeomodel, its strata or a layered terrain: plan points [x,y] or [x,y,z] in world m; per point each layer top/bottom with source and rule, groundwater, nearest borehole; with z the layer it lies in | |
| include | No | Sections; default attributes, psets, relations, at an IfcGrid also axes (each axis: tag, from/to in world m and grid m, curve; origin, ref_direction), at an IfcAnnotation also annotation (curves as points, arcs as chords; texts with anchor, text_height_m from its IfcTextStyle or the reason none, direction, extent; AssignedToProduct); outline at an IfcSpace: its footprint; alignment at an IfcAlignment (IFC4X3): horizontal and vertical segments with world ends, start station, station_equations, referents, length, warnings where layout and curve disagree | |
| library | No | Read in this catalog instead of the model (names from get_model_summary): a row per Name with its section in m and its type objects by class (types); target.n counts types. Catalog or model per call | |
| stations | No | IfcAlignment only: stations in m; a row each with world point, direction_deg, gradient, radius_m (+ left, null straight), cant (rail heads, roll_deg about the axis point, lift_m; null: no cant layout) and source, or the reason there is none; in an overlap a row per run, in a gap station_in_gap |