SolidWorksMakroprogrammierung

Objekt · SldWorks

SimulationMotorFeatureData-Objekt

Die Daten eines Linear- oder Drehmotors in einer Bewegungsstudie: Bewegungsverlauf, Richtung, Ort und die Flächen oder Kanten, auf die er wirkt.

Deklaration Dim x As SldWorks.SimulationMotorFeatureData · in der englischen .NET-Hilfe: ISimulationMotorFeatureData

Beschreibung

SimulationMotorFeatureData gibt Zugriff auf die Daten eines Linear- oder Drehmotors in einer Bewegungsstudie (SOLIDWORKS Motion). Der Motor bewegt eine Komponente mit konstanter Geschwindigkeit, um einen Weg, schwingend, nach einem Ausdruck oder nach Datenpunkten. Die ersten Befehle gibt es seit SOLIDWORKS 2006, die meisten seit SOLIDWORKS 2009.

Zugriff

Beispiel

' Gibt für jeden Motor der Bewegungsstudie "Motion Study 1" Art, Bewegungsverlauf und
' Richtung aus.
' Vorbedingung: Eine Baugruppe mit dieser Bewegungsstudie ist offen, das Zusatzprogramm
'               SOLIDWORKS Motion ist geladen.
' 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 swStudienMgr As Object                   ' MotionStudyManager
    Dim swStudie As Object                       ' MotionStudy
    Dim vFeatures As Variant
    Dim swFeat As SldWorks.Feature
    Dim swMotor As SldWorks.SimulationMotorFeatureData
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swStudienMgr = swModel.Extension.GetMotionStudyManager
    If swStudienMgr Is Nothing Then Exit Sub
    Set swStudie = swStudienMgr.GetMotionStudy("Motion Study 1")
    If swStudie Is Nothing Then Exit Sub

    vFeatures = swStudie.GetMotionFeatures
    If Not IsArray(vFeatures) Then Exit Sub
    For i = 0 To UBound(vFeatures)
        Set swFeat = vFeatures(i)
        If swFeat.GetTypeName = "AEMLinearMotor" Or swFeat.GetTypeName = "AEMRotationalMotor" Then
            Set swMotor = swFeat.GetDefinition
            Debug.Print swFeat.Name & ": " & IIf(swMotor.MotorType = swSimulationRotaryMotor, "Drehmotor", "Linearmotor")
            Select Case swMotor.MotionType
                Case swSimulationMotorMotion_Constant
                    Debug.Print "  konstant, Geschwindigkeit " & swMotor.Velocity
                Case swSimulationMotorMotion_Function
                    Debug.Print "  Ausdruck " & swMotor.Expression
                Case Else
                    Debug.Print "  Bewegungsart " & swMotor.MotionType     ' swSimulationMotorMotionType_e
            End Select
            If swMotor.ReverseDirection Then Debug.Print "  Richtung umgekehrt"
        End If
    Next i
End Sub

Bemerkungen

Anlegen: Die Bewegungsstudie muss aktiv sein, wenn du die Definition mit MotionStudy.CreateDefinition erzeugst und den Motor mit MotionStudy.CreateFeature anlegst, sonst liefert CreateDefinition Nothing. Das Hilfebeispiel „Create Linear Motor Feature“ wählt eine Fläche für die Richtung aus, setzt SimulationMotorFeatureData.InterpolatedMotor und lädt Datenpunkte mit SimulationMotorFeatureData.LoadSplineData. Danach setzt es SimulationMotorFeatureData.RelativeComponent, SimulationMotorFeatureData.Location und SimulationMotorFeatureData.LoadReferences. Die Bewegungsstudie und ihr Manager stammen aus der eigenen Typbibliothek SOLIDWORKS MotionStudy. Das Beispiel oben deklariert sie deshalb als Object.

Ändern: Das Hilfebeispiel „Fire Events for External Output Time Step Changes“ holt die Definition mit Feature.GetDefinition, setzt einen Wert und ruft Feature.ModifyDefinition auf. AccessSelections gibt es bei diesem Objekt nicht.

Einheiten: Die Hilfe nennt sie nur bei den Methoden: Drehzahl in U/min, Weg in Grad, Zeiten in Sekunden, Frequenz in Hz, den Ausdruck in Dokumenteinheiten. Für SimulationMotorFeatureData.Velocity, SimulationMotorFeatureData.Magnitude und die Datenpunkte sagt sie nichts.

Typbezeichnungen: Die Typnamen AEMLinearMotor und AEMRotationalMotor stammen aus dem Hilfebeispiel, das sie mit Feature.GetTypeName abfragt.

Das Beispiel sucht die Studie mit ihrem englischen Namen „Motion Study 1“. In der deutschen Fassung heißt sie „Bewegungsstudie 1“, dann endet das Beispiel ohne Ausgabe; passe den Namen an.

Eigenschaften und Methoden

Eigenschaften 14, davon 14 beschrieben

NameBeschreibung
DirectionReferenceLiest oder setzt das Element, das die Richtung des Motors angibt, etwa eine Kreiskante, eine Fläche, eine Achse oder eine Ebene.
DriveTypeLiest oder setzt, welche Größe die Datenpunkte eines interpolierten Motors vorgeben: Weg, Geschwindigkeit oder Beschleunigung.
ExpressionLiest oder setzt den Ausdruck, nach dem sich der Motor bewegt.
ExternalStateLiest oder setzt, ob der Motor extern gesteuert wird, also ob dein Programm die Ereignisse der Bewegungsstudie zu diesem Motor empfängt und die Geschwindigkeit liefert.
InterpolationSchemeLiest oder setzt das Interpolationsverfahren für die Datenpunkte des Motors.
LoadReferencesLiest oder setzt die tragenden Flächen oder Kanten des Motors.
LocationLiest oder setzt die Fläche, den Eckpunkt oder die Kante, die den Bezugsursprung angibt, wenn sich der Motor relativ zu einer anderen Komponente bewegt.
MagnitudeLiest oder setzt den Betrag des Motors.
MotionTypeLiest oder setzt die Bewegungsart des Motors, etwa konstant, Sprung, harmonisch, Ausdruck oder Spline.
MotorTypeLiefert, ob der Motor ein Linearmotor oder ein Drehmotor ist.
RelativeComponentLiest oder setzt die Komponente, relativ zu der sich der Motor bewegt.
ReverseDirectionLiest oder setzt, ob die Richtung des Motors umgekehrt ist.
SplineDataLiest oder setzt die Datenpunkte des Motors.
VelocityLiest oder setzt die Geschwindigkeit des Motors, wenn keine andere Kraft auf ihn wirkt.

Methoden 6, davon 6 beschrieben

NameBeschreibung
ConstantSpeedMotorStellt den Motor auf eine konstante Drehzahl.
DistanceMotorStellt den Motor auf einen Weg, den er ab einer Startzeit in einer bestimmten Dauer zurücklegt.
GetInterpolatedValueLiefert den interpolierten Wert des Motors zu einer Zeit.
InterpolatedMotorStellt den Motor auf Datenpunkte und legt fest, welche Größe sie vorgeben und wie interpoliert wird.
LoadSplineDataLädt die Datenpunkte des Motors aus einer Datei.
OscillatingMotorStellt den Motor auf eine Schwingung mit Ausschlag und Frequenz.

Siehe auch

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

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