SolidWorksMakroprogrammierung

Objekt · SldWorks

Simulation3DContactFeatureData-Objekt

Die Definition eines 3D-Kontakts in einer Bewegungsstudie: beteiligte Komponenten, Material oder Steifigkeit, Stoß und Reibung.

Deklaration Dim x As SldWorks.Simulation3DContactFeatureData · in der englischen .NET-Hilfe: ISimulation3DContactFeatureData

Beschreibung

Simulation3DContactFeatureData gibt Zugriff auf einen 3D-Kontakt (3D Contact) in einer Bewegungsstudie von SOLIDWORKS Motion. Das Verhalten beim Aufprall der angegebenen Komponenten legst du entweder über Materialien, über einen Restitutionskoeffizienten (Stoßzahl) oder über eine Stoßkraft mit Steifigkeit, Exponent, Dämpfung und Eindringtiefe fest. Dazu kommt die Reibung. Die Befehle mit eigener Hilfeseite gibt es seit SOLIDWORKS 2009.

Zugriff

  • MotionStudy.CreateDefinition mit swFmAEM3DContact: eine neue Definition, aus der MotionStudy.CreateFeature den Kontakt anlegt. Die Bewegungsstudie muss dabei aktiv sein.
  • Feature.GetDefinition: bei einem 3D-Kontakt, etwa aus MotionStudy.GetMotionFeatures

Die Bewegungsstudien holst du mit ModelDocExtension.GetMotionStudyManager.

Beispiel

' Gibt für jeden 3D-Kontakt der ersten Bewegungsstudie die Zahl der Komponenten,
' die Art des Stoßes und die Reibung aus.
' Vorbedingung: Eine Baugruppe mit einer Bewegungsstudie mit 3D-Kontakt ist offen.
'               Unter Extras > Verweise ist „SOLIDWORKS <Version> MotionStudy Type Library“ ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, die Baugruppe bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swMM As SwMotionStudy.MotionStudyManager
    Dim swStudie As SwMotionStudy.MotionStudy
    Dim swFeat As SldWorks.Feature
    Dim swDef As Object
    Dim swDaten As SldWorks.Simulation3DContactFeatureData
    Dim vNamen As Variant, vFeatures As Variant, vKomp As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swMM = swModel.Extension.GetMotionStudyManager
    If swMM Is Nothing Then Exit Sub
    If swMM.GetMotionStudyCount = 0 Then Exit Sub
    vNamen = swMM.GetMotionStudyNames
    Set swStudie = swMM.GetMotionStudy(vNamen(0))
    If False = swStudie.IsActive Then swStudie.Activate

    vFeatures = swStudie.GetMotionFeatures
    If Not IsArray(vFeatures) Then Exit Sub
    For i = 0 To UBound(vFeatures)
        Set swFeat = vFeatures(i)
        Set swDef = swFeat.GetDefinition
        If TypeOf swDef Is SldWorks.Simulation3DContactFeatureData Then
            Set swDaten = swDef
            vKomp = swDaten.ContactComponents
            If IsArray(vKomp) Then Debug.Print swFeat.Name & ": " & UBound(vKomp) + 1 & " Elemente"
            If swDaten.SpecifyMaterial Then
                Debug.Print "  Material " & swDaten.MaterialID(0) & " gegen " & swDaten.MaterialID(1)
            ElseIf swDaten.UseRestitutionCoefficient Then
                Debug.Print "  Stoßzahl " & swDaten.RestitutionCoefficient
            Else
                Debug.Print "  Steifigkeit " & swDaten.Stiffness & ", Exponent " & swDaten.Exponent
            End If
            Debug.Print "  Reibung " & swDaten.FrictionOption                ' swMotionContactFrictionType_e
        End If
    Next i
End Sub

Bemerkungen

Bewegungsstudien: MotionStudyManager und MotionStudy stammen aus einer eigenen Typbibliothek, der MotionStudy Type Library. Diese Seiten beschreiben sie nicht. Die Bewegungsstudie muss aktiv sein, sonst liefert MotionStudy.CreateDefinition Nothing.

Ändern: Eine Methode AccessSelections hat das Objekt nicht. Das Hilfebeispiel „Fire Events for External Output Time Step Changes“ setzt bei Kräften und Motoren die Werte und ruft dann Feature.ModifyDefinition mit der Baugruppe und Nothing auf. Vermutlich gilt das auch hier.

Was wann gilt: Steifigkeit, Exponent, Dämpfung und Eindringtiefe gelten nur, wenn Simulation3DContactFeatureData.UseRestitutionCoefficient und Simulation3DContactFeatureData.SpecifyMaterial beide False sind. Simulation3DContactFeatureData.MaterialID gilt nur, wenn SpecifyMaterial True ist.

Lücken in der Hilfe: Sechs Eigenschaften haben in der .NET-Hilfe keine eigene Seite, nur einen Satz in der Liste der Befehle: die vier für die Reibung, RestitutionCoefficient und UseRestitutionCoefficient. Was auf ihren Seiten steht, stützt sich zusätzlich auf das Hilfebeispiel „Create 3D Contact Feature“.

Einheiten: Für die Eindringtiefe nennt die Hilfe die Längeneinheit des Mechanismus, vermutlich die Längeneinheit der Baugruppe. Für die übrigen Werte nennt sie keine Einheit.

Eigenschaften und Methoden

Eigenschaften 14, davon 14 beschrieben

NameBeschreibung
ContactComponentsLiest oder setzt die Komponenten, die der 3D-Kontakt auf Berührung prüft.
DynamicFrictionCoefficientLiest oder setzt den Koeffizienten der dynamischen Reibung des 3D-Kontakts.
DynamicFrictionVelocityLiest oder setzt die Geschwindigkeit für die dynamische Reibung des 3D-Kontakts.
ExponentLiest oder setzt den Exponenten, mit dem die Stoßkraft des 3D-Kontakts berechnet wird.
FrictionOptionLiest oder setzt, ob der 3D-Kontakt ohne Reibung, mit voller (statischer) oder mit dynamischer Reibung rechnet.
MaterialIDLiest oder setzt das Material einer Komponente des 3D-Kontakts.
MaxDampingLiest oder setzt die größte Dämpfung an der Kontaktgrenze des 3D-Kontakts.
PenetrationLiest oder setzt die Eindringtiefe, bei der die größte Dämpfung wirkt.
RestitutionCoefficientLiest oder setzt den Restitutionskoeffizienten (Stoßzahl) des 3D-Kontakts.
SpecifyMaterialLiest oder setzt, ob der 3D-Kontakt mit Materialien rechnet.
StaticFrictionCoefficientLiest oder setzt den Koeffizienten der statischen Reibung des 3D-Kontakts.
StaticFrictionVelocityLiest oder setzt die Geschwindigkeit für die statische Reibung des 3D-Kontakts.
StiffnessLiest oder setzt die Steifigkeit an der Kontaktgrenze zwischen den beiden Teilen des 3D-Kontakts.
UseRestitutionCoefficientLiest oder setzt, ob der 3D-Kontakt mit der Stoßzahl statt mit der Stoßkraft rechnet.

Siehe auch

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

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