cuboidType

complexType · extension complexBaseType · all

Cuboid

The cuboid is defined in its own coordinate system, with the origin at a corner of its lower face. The lower face spans x = 0 to <lengthX> and y = 0 to <depthY> in the plane z = 0; the upper face lies in the plane z = <heightZ>.

Without the upperFace values, the upper face equals the lower face and the cuboid is a rectangular box. <upperFaceXmin>, <upperFaceXmax>, <upperFaceYmin> and <upperFaceYmax> give the upper face a different extent, e.g. for a tapered or sheared body. Where a minimum equals the corresponding maximum, the upper face degenerates into an edge and the body is a wedge.

Cuboid with a smaller upper face: (a) oblique view with the origin at a corner of the lower face and lengthX, depthY and heightZ; (b) top view with the lower face and, inside it, the upper face, whose upperFaceXmin, upperFaceXmax, upperFaceYmin and upperFaceYmax are measured from the axes through the origin

Figure (a) shows a cuboid whose upper face is smaller than its lower face, figure (b) the same cuboid from above. The four upperFace values are coordinates in the coordinate system of the cuboid, measured from its origin like the lower face, not distances from the edges of the lower face.

The cuboid of the figure as an element of a library, with a density from which its mass follows:

<genericElement uID="element_taperedBox">
    <name>Tapered box</name>
    <geometry>
        <cuboids>
            <cuboid>
                <lengthX>1.2</lengthX>
                <depthY>0.8</depthY>
                <heightZ>0.6</heightZ>
                <upperFaceXmin>0.3</upperFaceXmin>
                <upperFaceXmax>1</upperFaceXmax>
                <upperFaceYmin>0.15</upperFaceYmin>
                <upperFaceYmax>0.65</upperFaceYmax>
            </cuboid>
        </cuboids>
    </geometry>
    <mass>
        <density>600</density>
    </mass>
</genericElement>
Cuboid with a smaller upper face

The battery of the fuel cell propulsion unit (see systemElementsType), a rectangular box that the transformation of its cuboid moves so that its center lies at the origin of the element:

<battery uID="battery">
    <name>Battery, 30 kWh</name>
    <geometry>
        <cuboids>
            <cuboid>
                <lengthX>0.8</lengthX>
                <depthY>0.45</depthY>
                <heightZ>0.3</heightZ>
                <transformation>
                    <translation>
                        <x>-0.4</x>
                        <y>-0.225</y>
                        <z>-0.15</z>
                    </translation>
                </transformation>
            </cuboid>
        </cuboids>
    </geometry>
    <mass>
        <mass>150</mass>
    </mass>
</battery>
Cuboid placed by its center

Attributes

NameTypeConstraintsUseDefaultDescription
@externalDataDirectoryxsd:stringoptionalDirectory of the external file the element was read from, as URI
@externalDataNodePathxsd:stringoptionalPath of the parent element in the merged dataset, at which the element was inserted from an external file
@externalFileNamexsd:stringoptionalName of the external file the element was read from

Child elements

NameTypeConstraintsOccurrenceHow often the element may appear at this place. The schema writes it as minOccurs and maxOccurs on the declaration.DefaultDescription
allThe children below may appear in any order. Each may appear at most once.
lengthXdoubleBaseType[1..1] requiredLength in x-direction of the lower face [m]
depthYdoubleBaseType[1..1] requiredDepth in y-direction of the lower face [m]
heightZdoubleBaseType[1..1] requiredHeight in z-direction [m]
upperFaceXmindoubleBaseType[0..1] optionalMinimum x-coordinate of the upper face (if not defined: equals 0) [m]
upperFaceXmaxdoubleBaseType[0..1] optionalMaximum x-coordinate of the upper face (if not defined: equals lengthX) [m]
upperFaceYmindoubleBaseType[0..1] optionalMinimum y-coordinate of the upper face (if not defined: equals 0) [m]
upperFaceYmaxdoubleBaseType[0..1] optionalMaximum y-coordinate of the upper face (if not defined: equals depthY) [m]
transformationtransformationSE3Type[0..1] optionalRotation and translation that place the primitive in the element coordinate system

Used by

In a dataset · 160 paths

In the schema · 1 declaration

TypeName
cuboidsTypecuboid