volume_object_model_3d_relative_to_planeT_volume_object_model_3d_relative_to_planeVolumeObjectModel3dRelativeToPlaneVolumeObjectModel3dRelativeToPlane (Operator)

Name

volume_object_model_3d_relative_to_planeT_volume_object_model_3d_relative_to_planeVolumeObjectModel3dRelativeToPlaneVolumeObjectModel3dRelativeToPlane — Berechnen des Volumens eines 3D-Objektmodells.

Signatur

Beschreibung

volume_object_model_3d_relative_to_planevolume_object_model_3d_relative_to_planeVolumeObjectModel3dRelativeToPlaneVolumeObjectModel3dRelativeToPlaneVolumeObjectModel3dRelativeToPlane berechnet das Volumen unter den Flächen eines 3D-Objektmodells relativ zu einer Ebene im Raum. Die Ebene wird durch die x-y-Ebene der Pose in PlanePlanePlanePlaneplane definiert.

Für das 3D-Objektmodell ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D muss eine Triangulierung oder eine Polygonliste vorhanden sein. Falls das 3D-Objektmodell eine wasserdichte und geordnete Vermaschung besitzt, berechnet der Operator mit den Standardeinstellungen das tatsächliche Volumen. Um Fälle zu behandeln, wo das Netz nicht wasserdicht oder die Vermaschung nicht konsistent ist, kann die Berechnung des Volumens mit den Parametern ModeModeModeModemode und UseFaceOrientationUseFaceOrientationUseFaceOrientationUseFaceOrientationuseFaceOrientation beeinflusst werden.

Wie das Volumen berechnet wird:

Zuerst berechnet der Operator das Volumen der Prismen, die sich aus der Projektion der einzelnen Flächen auf die Ebene ergeben.

Die einzelnen Volumen der Prismen können positiv oder negativ sein, abhängig von der Orientierung (hin zur oder weg von der Ebene) oder der Lage (oberhalb oder unterhalb) der Fläche. Das kann mit dem Parameter UseFaceOrientationUseFaceOrientationUseFaceOrientationUseFaceOrientationuseFaceOrientation eingestellt werden.

Danach werdem die Volumen der Prismen abhängig vom Parameter ModeModeModeModemode aufsummiert.

Das in VolumeVolumeVolumeVolumevolume zurückgegebene Volumen ist der Absolutbetrag der berechneten Summe.

Einstellen der Parameter:

ModeModeModeModemode kann folgende Werte annehmen:

'signed' (default)

Die Volumen oberhalb und unterhalb der Ebene werden addiert.

'unsigned'

Das Volumen unterhalb der Ebene wird vom Volumen oberhalb der Ebene abgezogen.

'positive'

Nur Flächen oberhalb der Ebene werden berücksichtigt.

'negative'

Nur Flächen unterhalb der Ebene werden berücksichtigt.

UseFaceOrientationUseFaceOrientationUseFaceOrientationUseFaceOrientationuseFaceOrientation kann folgende Werte annehmen:

'true' (default)

Verwendet die Orientierung der Fläche relativ zur Ebene. Eine Fläche zeigt weg von der Ebene, falls die Eckpunkte von der Ebene aus betrachtet im Uhrzeigersinn angeordnet sind. Das Volumen eines Prismas ist positiv, wenn die Orientierung der Fläche weg von der Ebene zeigt. Das Volumen eines Prismas ist negativ, wenn die Orientierung der Fläche hin zu der Ebene zeigt.

'false'

Das Volumen eines Prismas is positiv, wenn die Fläche oberhalb der Ebene liegt. Das Volumen eines Prismas is negativ, wenn die Fläche unterhalb der Ebene liegt.

Zum Beispiel wird mit der Standardeinstellung (ModeModeModeModemode: 'signed'"signed""signed""signed""signed", UseFaceOrientationUseFaceOrientationUseFaceOrientationUseFaceOrientationuseFaceOrientation: 'true'"true""true""true""true") das Volumen eine geschlossenen Objektes berechnet. In diesem Fall wird die Ebene PlanePlanePlanePlaneplane zwar benötigt, hat aber keinen Einfluss auf das berechnete Endergebnis.

Achtung

Ist die Entfernung zwischen der Ebene und dem Objekt sehr groß (ca. 10000 mal größer als der Durchmesser), kann die Berechnung des Volumens numerisch instabil werden.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Beispiel (HDevelop)

gen_box_object_model_3d ([0,0,0,0,0,0,0],3,2,1, ObjectModel3D)
convex_hull_object_model_3d (ObjectModel3D, ObjectModel3DConvexHull)
volume_object_model_3d_relative_to_plane (ObjectModel3DConvexHull,\
                                          [0,0,0,0,0,0,0], 'signed',\
                                          'true', Volume)

Ergebnis

volume_object_model_3d_relative_to_planevolume_object_model_3d_relative_to_planeVolumeObjectModel3dRelativeToPlaneVolumeObjectModel3dRelativeToPlaneVolumeObjectModel3dRelativeToPlane liefert den Wert 2 (H_MSG_TRUE) wenn alle Parameter korrekt sind. Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_object_model_3dread_object_model_3dReadObjectModel3dReadObjectModel3dReadObjectModel3d, xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3dXyzToObjectModel3d, select_points_object_model_3dselect_points_object_model_3dSelectPointsObjectModel3dSelectPointsObjectModel3dSelectPointsObjectModel3d

Nachfolger

project_object_model_3dproject_object_model_3dProjectObjectModel3dProjectObjectModel3dProjectObjectModel3d, object_model_3d_to_xyzobject_model_3d_to_xyzObjectModel3dToXyzObjectModel3dToXyzObjectModel3dToXyz

Siehe auch

area_object_model_3darea_object_model_3dAreaObjectModel3dAreaObjectModel3dAreaObjectModel3d

Modul

3D Metrology