SolidWorksMakroprogrammierung

Objekt · SldWorks

MassProperty2-Objekt

Die Masseneigenschaften eines Teils, einer Baugruppe oder ausgewählter Körper und Komponenten: Masse, Volumen, Oberfläche, Dichte, Schwerpunkt und Trägheitsmomente, auf Wunsch überschrieben.

Deklaration Dim x As SldWorks.MassProperty2 · in der englischen .NET-Hilfe: IMassProperty2

Beschreibung

MassProperty2 gibt Zugriff auf die einzelnen Masseneigenschaften, wie sie im Dialog „Masseneigenschaften“ stehen. Du erzeugst das Objekt mit ModelDocExtension.CreateMassProperty2. Im Teil rechnet es mit den vorher ausgewählten Körpern, in der Baugruppe mit den ausgewählten Komponenten. Ohne Auswahl rechnet es wie im Hilfebeispiel mit dem ganzen Modell. Die Befehle gibt es seit SOLIDWORKS 2020. MassProperty2 ersetzt das ältere MassProperty, die Unterschiede stehen in den Bemerkungen.

Zugriff

Beispiel

' Gibt Masse, Volumen, Oberfläche, Dichte, Schwerpunkt, Hauptträgheitsmomente und
' Trägheitsmomente des aktiven Teils oder der Baugruppe aus, ausgeblendete Körper
' und Komponenten eingeschlossen.
' Vorbedingung: Ein Teil mit Volumenkörper oder eine Baugruppe ist offen.
' Ergebnis:     Die Werte stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swMass As SldWorks.MassProperty2
    Dim vPunkt As Variant
    Dim vHaupt As Variant
    Dim vMoment As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType = swDocDRAWING Then Exit Sub

    swModel.ClearSelection2 True                     ' ohne Auswahl gilt das ganze Modell
    Set swMass = swModel.Extension.CreateMassProperty2
    If swMass Is Nothing Then
        Debug.Print "Keine Masseneigenschaften verfügbar."
        Exit Sub
    End If

    swMass.AccuracyLevel = swMassPropertyAccuracyLevel_Higher
    swMass.IncludeHiddenBodiesOrComponents = True
    swMass.Recalculate                               ' nach IncludeHiddenBodiesOrComponents nötig

    vPunkt = swMass.CenterOfMass
    vHaupt = swMass.PrincipalMomentsOfInertia
    vMoment = swMass.GetMomentOfInertia(swMassPropertyMomentAboutCenterOfMass)

    Debug.Print "Masse:       " & Format(swMass.Mass, "0.000") & " kg"
    Debug.Print "Volumen:     " & Format(swMass.Volume * 1000000#, "0.00") & " cm³"
    Debug.Print "Oberfläche:  " & Format(swMass.SurfaceArea * 10000#, "0.00") & " cm²"
    Debug.Print "Dichte:      " & Format(swMass.Density, "0.0") & " kg/m³"
    Debug.Print "Schwerpunkt: " & Format(vPunkt(0) * 1000#, "0.00") & ", " & _
                Format(vPunkt(1) * 1000#, "0.00") & ", " & Format(vPunkt(2) * 1000#, "0.00") & " mm"
    Debug.Print "Px, Py, Pz:  " & vHaupt(0) & ", " & vHaupt(1) & ", " & vHaupt(2) & " kg·m²"
    Debug.Print "Lxx, Lyy, Lzz am Schwerpunkt: " & vMoment(0) & ", " & vMoment(4) & ", " & vMoment(8) & " kg·m²"
End Sub

Bemerkungen

MassProperty2 oder MassProperty: Das ältere MassProperty ist veraltet und durch MassProperty2 ersetzt. In Makros für SOLIDWORKS 2020 und neuer nimmst du deshalb MassProperty2. Die Unterschiede:

  • Erzeugen: MassProperty2 mit ModelDocExtension.CreateMassProperty2, MassProperty mit dem veralteten ModelDocExtension.CreateMassProperty.
  • Körper: MassProperty2 rechnet mit den ausgewählten Körpern oder Komponenten, die Liste änderst du mit MassProperty2.SelectedItems. MassProperty rechnet mit allen Volumenkörpern, außer du gibst mit seiner Methode AddBodies bestimmte Körper vor, auch temporäre.
  • Überschreiben: MassProperty2 sammelt die Werte in MassPropertyOverrideOptions und übernimmt sie mit MassProperty2.SetOverrideOptions und MassProperty2.Recalculate. MassProperty überschreibt mit eigenen Methoden, jede mit den Angaben zu den Konfigurationen.
  • Nur bei MassProperty2: Genauigkeit, ausgeblendete Körper und Komponenten, die Masse der Schweißraupen und das Neuberechnen.
  • Nur bei MassProperty: AddBodies sowie SetAssignedMassProp und UserAssigned, die ältere Art, Masse und Schwerpunkt vorzugeben.
  • Schreibweise: MassProperty2 schreibt PrincipalAxesOfInertia und PrincipalMomentsOfInertia, MassProperty schreibt PrincipleAxesOfInertia und PrincipleMomentsOfInertia.

MassProperty brauchst du noch für Makros, die auch in Versionen vor SOLIDWORKS 2020 laufen sollen. Ob MassProperty2.SelectedItems wie AddBodies temporäre Körper annimmt, sagt die Hilfe nicht.

Neu berechnen: Rufe MassProperty2.Recalculate auf, nachdem du Werte überschrieben oder MassProperty2.IncludeHiddenBodiesOrComponents geändert hast. Erst danach liefern MassProperty2.Mass, MassProperty2.CenterOfMass und die übrigen Eigenschaften die neuen Werte.

Einheiten: Ohne Zuweisung ist MassProperty2.UseSystemUnits True. Dann kommen die Werte in Systemeinheiten (Meter, Bogenmaß, Kilogramm), also Masse in kg, Längen in m, die Oberfläche in m², das Volumen in m³, die Dichte in kg/m³ und Trägheitsmomente in kg·m². Mit False gelten die Einheiten des Dokuments.

Körper in Baugruppen: Bei ModelDocExtension.CreateMassProperty2 steht: In einer Baugruppe lassen sich keine einzelnen Körper aus Mehrkörperteilen auswählen, nur Komponenten. Einen einzelnen Körper rechnest du mit Body2.GetMassProperties und einer Dichte, die du vorgibst.

Hilfebeispiel: „Get and Override Mass Properties“ öffnet die Baugruppe 98food processor.sldasm und überschreibt mit MassPropertyOverrideOptions Masse und Trägheitsmomente. Mit UseSystemUnits = False gibt es die Werte in den Einheiten des Dokuments aus, übergibt dann die Überschreibungen mit SetOverrideOptions und gibt die Werte nach Recalculate noch einmal aus.

Eigenschaften und Methoden

Eigenschaften 13, davon 13 beschrieben

NameBeschreibung
AccuracyLevelLiest oder setzt die Genauigkeit, mit der die Masseneigenschaften berechnet werden.
CenterOfMassLiefert den Schwerpunkt der ausgewählten Körper oder Komponenten.
DensityLiefert die Dichte der ausgewählten Körper oder Komponenten.
IncludeHiddenBodiesOrComponentsLiest oder setzt, ob ausgeblendete Körper und Komponenten in die Masseneigenschaften einfließen.
MassLiefert die Masse der ausgewählten Körper oder Komponenten.
PrincipalAxesOfInertiaLiefert die Richtung einer der drei Hauptträgheitsachsen.
PrincipalMomentsOfInertiaLiefert die drei Hauptträgheitsmomente.
SelectedItemsLiest oder setzt die Körper (im Teil) oder Komponenten (in der Baugruppe), deren Masseneigenschaften berechnet werden.
ShowWeldBeadMassLiest oder setzt, ob die Masse der Schweißraupen berechnet wird.
SurfaceAreaLiefert die Oberfläche der ausgewählten Körper oder Komponenten.
UseSystemUnitsLiest oder setzt, ob die Masseneigenschaften in Systemeinheiten oder in den Einheiten des Dokuments geliefert werden.
VolumeLiefert das Volumen der ausgewählten Körper oder Komponenten.
WeldBeadMassLiefert die Masse der Schweißraupen.

Methoden 5, davon 5 beschrieben

NameBeschreibung
GetMomentOfInertiaLiefert die Trägheitsmomente der ausgewählten Körper oder Komponenten, bezogen auf den Schwerpunkt oder auf das Koordinatensystem.
GetOverrideOptionsLiefert die Überschreibungen der Masseneigenschaften für die ausgewählten Körper oder Komponenten.
RecalculateBerechnet die Masseneigenschaften der ausgewählten Körper oder Komponenten neu.
SetCoordinateSystemLegt das Koordinatensystem fest, in dem die Masseneigenschaften berechnet werden.
SetOverrideOptionsÜbernimmt die Überschreibungen der Masseneigenschaften für die ausgewählten Körper oder Komponenten in bestimmten Konfigurationen.

Siehe auch

Englisches Original: IMassProperty2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.