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.
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
Feature.GetDefinition: bei einem Motor-Feature mit dem TypnamenAEMLinearMotoroderAEMRotationalMotorMotionStudy.CreateDefinitionmitswFmAEMLinearMotoroderswFmAEMRotationalMotorausswFeatureNameID_e: eine neue Definition fürMotionStudy.CreateFeature. Die Bewegungsstudie bekommst du überModelDocExtension.GetMotionStudyManager.
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| DirectionReference | Liest oder setzt das Element, das die Richtung des Motors angibt, etwa eine Kreiskante, eine Fläche, eine Achse oder eine Ebene. |
| DriveType | Liest oder setzt, welche Größe die Datenpunkte eines interpolierten Motors vorgeben: Weg, Geschwindigkeit oder Beschleunigung. |
| Expression | Liest oder setzt den Ausdruck, nach dem sich der Motor bewegt. |
| ExternalState | Liest 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. |
| InterpolationScheme | Liest oder setzt das Interpolationsverfahren für die Datenpunkte des Motors. |
| LoadReferences | Liest oder setzt die tragenden Flächen oder Kanten des Motors. |
| Location | Liest oder setzt die Fläche, den Eckpunkt oder die Kante, die den Bezugsursprung angibt, wenn sich der Motor relativ zu einer anderen Komponente bewegt. |
| Magnitude | Liest oder setzt den Betrag des Motors. |
| MotionType | Liest oder setzt die Bewegungsart des Motors, etwa konstant, Sprung, harmonisch, Ausdruck oder Spline. |
| MotorType | Liefert, ob der Motor ein Linearmotor oder ein Drehmotor ist. |
| RelativeComponent | Liest oder setzt die Komponente, relativ zu der sich der Motor bewegt. |
| ReverseDirection | Liest oder setzt, ob die Richtung des Motors umgekehrt ist. |
| SplineData | Liest oder setzt die Datenpunkte des Motors. |
| Velocity | Liest oder setzt die Geschwindigkeit des Motors, wenn keine andere Kraft auf ihn wirkt. |
Methoden 6, davon 6 beschrieben
| Name | Beschreibung |
|---|---|
| ConstantSpeedMotor | Stellt den Motor auf eine konstante Drehzahl. |
| DistanceMotor | Stellt den Motor auf einen Weg, den er ab einer Startzeit in einer bestimmten Dauer zurücklegt. |
| GetInterpolatedValue | Liefert den interpolierten Wert des Motors zu einer Zeit. |
| InterpolatedMotor | Stellt den Motor auf Datenpunkte und legt fest, welche Größe sie vorgeben und wie interpoliert wird. |
| LoadSplineData | Lädt die Datenpunkte des Motors aus einer Datei. |
| OscillatingMotor | Stellt 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.