Objekt · SldWorks
SimulationForceFeatureData-Objekt
Die Definition einer Kraft oder eines Drehmoments in einer Bewegungsstudie: Angriffspunkt, Richtung, Bezugskomponente und zeitlicher Verlauf.
Beschreibung
SimulationForceFeatureData gibt Zugriff auf eine Kraft oder ein Drehmoment in einer Bewegungsstudie von SOLIDWORKS Motion. Eine Kraft wirkt nur auf ein Teil (nur Aktion) oder als Kraft und Gegenkraft zwischen zwei Teilen (Aktion und Reaktion). Ihren Betrag über der Zeit beschreibt eine Funktion: konstant, Sprung, harmonisch, Spline aus Datenpunkten oder ein Ausdruck. Die meisten Befehle gibt es seit SOLIDWORKS 2009, ExternalState seit 2008 SP01.
Zugriff
MotionStudy.CreateDefinitionmitswFmAEMLinearForceoderswFmAEMTorque: eine neue Definition, aus derMotionStudy.CreateFeaturedie Kraft anlegt. Die Bewegungsstudie muss dabei aktiv sein.Feature.GetDefinition: bei einer Kraft oder einem Drehmoment ausMotionStudy.GetMotionFeatures. Das Hilfebeispiel erkennt sie an den TypnamenAEMLinearForceundAEMTorqueausFeature.GetTypeName.
Die Bewegungsstudien holst du mit ModelDocExtension.GetMotionStudyManager.
Beispiel
' Gibt für jede Kraft und jedes Drehmoment der ersten Bewegungsstudie Art und Verlauf
' aus und verdoppelt konstante Beträge.
' Vorbedingung: Eine Baugruppe mit einer Bewegungsstudie mit Kraft ist offen.
' Unter Extras > Verweise ist „SOLIDWORKS <Version> MotionStudy Type Library“ ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, konstante Kräfte sind doppelt so groß.
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.SimulationForceFeatureData
Dim vNamen As Variant, vFeatures 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.SimulationForceFeatureData Then
Set swDaten = swDef
Debug.Print swFeat.Name & ": " & IIf(swDaten.ForceType = swSimulationForce_Torque, "Drehmoment", "Kraft") & _
IIf(swDaten.ActionType = swSimulationForceAction_ActionOnly, ", nur Aktion", ", Aktion und Reaktion")
If swDaten.ForceFunctionType = swSimulationForceFunction_Constant Then
Debug.Print " konstant " & swDaten.FunctionConstantValue
swDaten.FunctionConstantValue = 2 * swDaten.FunctionConstantValue
swFeat.ModifyDefinition swDaten, swModel, Nothing
Else
Debug.Print " Verlauf " & swDaten.ForceFunctionType ' swSimulationForceFunctionType_e
End If
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.
Anlegen: Das Hilfebeispiel „Create Force Feature“ setzt bei einer neuen Definition SimulationForceFeatureData.ActionType auf swSimulationForceAction_ActionOnly, weist SimulationForceFeatureData.ActionLocation eine ausgewählte Fläche und SimulationForceFeatureData.ReferenceComponent deren Komponente zu und ruft dann MotionStudy.CreateFeature auf.
Ändern: Eine Methode AccessSelections hat das Objekt nicht. Das Hilfebeispiel „Fire Events for External Output Time Step Changes“ setzt SimulationForceFeatureData.ExternalState und ruft dann Feature.ModifyDefinition mit der Baugruppe und Nothing auf.
Lücken in der Hilfe: FunctionInterpolatedValues, GetFunctionHarmonicValues und SetFunctionHarmonicValues haben in der .NET-Hilfe keine eigene Seite, nur einen Satz in der Liste der Befehle.
Einheiten: Nach Angabe der Hilfe steht der Ausdruck in SimulationForceFeatureData.FunctionExpression in den Einheiten des Dokuments. Für die übrigen Beträge und Zeiten nennt die Hilfe keine Einheit.
Eigenschaften und Methoden
Eigenschaften 14, davon 14 beschrieben
| Name | Beschreibung |
|---|---|
| ActionDirection | Liest oder setzt die Richtung der Kraft, etwa über eine Kante oder Ebene. |
| ActionLocation | Liest oder setzt den Angriffspunkt einer Kraft nur mit Aktion. |
| ActionType | Liest oder setzt, ob die Kraft nur als Aktion wirkt oder als Aktion und Reaktion zwischen zwei Teilen. |
| ExternalState | Liest oder setzt, ob dein Programm den Betrag der Kraft während der Berechnung über Ereignisse der Bewegungsstudie selbst liefert. |
| ForceFunctionType | Liest oder setzt, wie sich der Betrag der Kraft über der Zeit ändert: konstant, Sprung, harmonisch, Spline oder Ausdruck. |
| ForceType | Liefert, ob es eine lineare Kraft oder ein Drehmoment ist. |
| FunctionConstantValue | Liest oder setzt den konstanten Betrag der Kraft. |
| FunctionExpression | Liest oder setzt den Ausdruck, der den Betrag der Kraft über der Zeit beschreibt. |
| FunctionInterpolatedValues | Liest oder setzt die Datenpunkte, zwischen denen der Betrag der Kraft interpoliert wird. |
| InterpolationScheme | Liest, wie zwischen den Datenpunkten des Spline-Verlaufs interpoliert wird. |
| LoadReferences | Liest oder setzt die lasttragenden Flächen oder Kanten der Kraft. |
| ReactionLocation | Liest oder setzt den Angriffspunkt der Gegenkraft bei einer Kraft mit Aktion und Reaktion. |
| ReferenceComponent | Liest oder setzt die Komponente, deren Koordinatensystem als Bezug für die Kraft dient. |
| ReverseDirection | Liest oder setzt, ob die Richtung der Kraft umgekehrt ist. |
Methoden 8, davon 8 beschrieben
| Name | Beschreibung |
|---|---|
| GetEndPoints | Liefert die beiden Endpunkte der Kraft und ihre Art. |
| GetFunctionHarmonicValues | Liefert Amplitude, Frequenz, Mittelwert und Phasenverschiebung eines harmonischen Verlaufs der Kraft. |
| GetFunctionStepValues | Liefert die Werte eines Sprungverlaufs, bei dem der Betrag der Kraft glatt von einem Wert auf einen anderen übergeht. |
| GetInterpolatedValue | Liefert den interpolierten Betrag der Kraft zu einer Zeit. |
| LoadSplineData | Liest die Datenpunkte für den Spline-Verlauf der Kraft aus einer Datei. |
| SetEndPoints | Setzt die beiden Endpunkte der Kraft. |
| SetFunctionHarmonicValues | Setzt Amplitude, Frequenz, Mittelwert und Phasenverschiebung eines harmonischen Verlaufs der Kraft. |
| SetFunctionStepValues | Setzt einen Sprungverlauf, bei dem der Betrag der Kraft glatt von einem Wert auf einen anderen übergeht. |
Siehe auch
Englisches Original: ISimulationForceFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.