SolidWorksMakroprogrammierung

Objekt · SldWorks

SimulationForceFeatureData-Objekt

Die Definition einer Kraft oder eines Drehmoments in einer Bewegungsstudie: Angriffspunkt, Richtung, Bezugskomponente und zeitlicher Verlauf.

Deklaration Dim x As SldWorks.SimulationForceFeatureData · in der englischen .NET-Hilfe: ISimulationForceFeatureData

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.CreateDefinition mit swFmAEMLinearForce oder swFmAEMTorque: eine neue Definition, aus der MotionStudy.CreateFeature die Kraft anlegt. Die Bewegungsstudie muss dabei aktiv sein.
  • Feature.GetDefinition: bei einer Kraft oder einem Drehmoment aus MotionStudy.GetMotionFeatures. Das Hilfebeispiel erkennt sie an den Typnamen AEMLinearForce und AEMTorque aus Feature.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 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.

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

NameBeschreibung
ActionDirectionLiest oder setzt die Richtung der Kraft, etwa über eine Kante oder Ebene.
ActionLocationLiest oder setzt den Angriffspunkt einer Kraft nur mit Aktion.
ActionTypeLiest oder setzt, ob die Kraft nur als Aktion wirkt oder als Aktion und Reaktion zwischen zwei Teilen.
ExternalStateLiest oder setzt, ob dein Programm den Betrag der Kraft während der Berechnung über Ereignisse der Bewegungsstudie selbst liefert.
ForceFunctionTypeLiest oder setzt, wie sich der Betrag der Kraft über der Zeit ändert: konstant, Sprung, harmonisch, Spline oder Ausdruck.
ForceTypeLiefert, ob es eine lineare Kraft oder ein Drehmoment ist.
FunctionConstantValueLiest oder setzt den konstanten Betrag der Kraft.
FunctionExpressionLiest oder setzt den Ausdruck, der den Betrag der Kraft über der Zeit beschreibt.
FunctionInterpolatedValuesLiest oder setzt die Datenpunkte, zwischen denen der Betrag der Kraft interpoliert wird.
InterpolationSchemeLiest, wie zwischen den Datenpunkten des Spline-Verlaufs interpoliert wird.
LoadReferencesLiest oder setzt die lasttragenden Flächen oder Kanten der Kraft.
ReactionLocationLiest oder setzt den Angriffspunkt der Gegenkraft bei einer Kraft mit Aktion und Reaktion.
ReferenceComponentLiest oder setzt die Komponente, deren Koordinatensystem als Bezug für die Kraft dient.
ReverseDirectionLiest oder setzt, ob die Richtung der Kraft umgekehrt ist.

Methoden 8, davon 8 beschrieben

NameBeschreibung
GetEndPointsLiefert die beiden Endpunkte der Kraft und ihre Art.
GetFunctionHarmonicValuesLiefert Amplitude, Frequenz, Mittelwert und Phasenverschiebung eines harmonischen Verlaufs der Kraft.
GetFunctionStepValuesLiefert die Werte eines Sprungverlaufs, bei dem der Betrag der Kraft glatt von einem Wert auf einen anderen übergeht.
GetInterpolatedValueLiefert den interpolierten Betrag der Kraft zu einer Zeit.
LoadSplineDataLiest die Datenpunkte für den Spline-Verlauf der Kraft aus einer Datei.
SetEndPointsSetzt die beiden Endpunkte der Kraft.
SetFunctionHarmonicValuesSetzt Amplitude, Frequenz, Mittelwert und Phasenverschiebung eines harmonischen Verlaufs der Kraft.
SetFunctionStepValuesSetzt 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.