Objekt · SldWorks
Simulation3DContactFeatureData-Objekt
Die Definition eines 3D-Kontakts in einer Bewegungsstudie: beteiligte Komponenten, Material oder Steifigkeit, Stoß und Reibung.
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.CreateDefinitionmitswFmAEM3DContact: eine neue Definition, aus derMotionStudy.CreateFeatureden Kontakt anlegt. Die Bewegungsstudie muss dabei aktiv sein.Feature.GetDefinition: bei einem 3D-Kontakt, etwa ausMotionStudy.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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ContactComponents | Liest oder setzt die Komponenten, die der 3D-Kontakt auf Berührung prüft. |
| DynamicFrictionCoefficient | Liest oder setzt den Koeffizienten der dynamischen Reibung des 3D-Kontakts. |
| DynamicFrictionVelocity | Liest oder setzt die Geschwindigkeit für die dynamische Reibung des 3D-Kontakts. |
| Exponent | Liest oder setzt den Exponenten, mit dem die Stoßkraft des 3D-Kontakts berechnet wird. |
| FrictionOption | Liest oder setzt, ob der 3D-Kontakt ohne Reibung, mit voller (statischer) oder mit dynamischer Reibung rechnet. |
| MaterialID | Liest oder setzt das Material einer Komponente des 3D-Kontakts. |
| MaxDamping | Liest oder setzt die größte Dämpfung an der Kontaktgrenze des 3D-Kontakts. |
| Penetration | Liest oder setzt die Eindringtiefe, bei der die größte Dämpfung wirkt. |
| RestitutionCoefficient | Liest oder setzt den Restitutionskoeffizienten (Stoßzahl) des 3D-Kontakts. |
| SpecifyMaterial | Liest oder setzt, ob der 3D-Kontakt mit Materialien rechnet. |
| StaticFrictionCoefficient | Liest oder setzt den Koeffizienten der statischen Reibung des 3D-Kontakts. |
| StaticFrictionVelocity | Liest oder setzt die Geschwindigkeit für die statische Reibung des 3D-Kontakts. |
| Stiffness | Liest oder setzt die Steifigkeit an der Kontaktgrenze zwischen den beiden Teilen des 3D-Kontakts. |
| UseRestitutionCoefficient | Liest 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.