Objekt · SldWorks
MotionPlotAxisFeatureData-Objekt
Die Daten einer Achse eines Diagramms in einer Bewegungsstudie: Ergebnisgröße, Komponente, gemessene Elemente und Bezugskomponente.
Beschreibung
MotionPlotAxisFeatureData gibt Zugriff auf die Daten der x- oder y-Achse eines Diagramms (Plot) in einer Bewegungsstudie. An einer y-Achse legst du fest, welche Ergebnisgröße das Diagramm zeigt, etwa Verschiebung, Geschwindigkeit oder Kraft, und für welche Elemente des Modells. Für die x-Achse nennt swMotionPlotAxisType_e dem Namen nach die Zeit und die Bildnummer. Die Daten des ganzen Diagramms sind ein MotionPlotFeatureData. Die Befehle gibt es seit SOLIDWORKS 2011.
Zugriff
CosmosMotionStudyResults.CreatePlotXAxisFeatureDataundCosmosMotionStudyResults.CreatePlotYAxisFeatureData: neue Achsendaten für ein Diagramm. Die Ergebnisse liefertMotionStudy.GetResultsmit dem Studientyp Motion-Analyse (4), die Bewegungsstudie bekommst du überModelDocExtension.GetMotionStudyManager.Feature.GetDefinition: bei einer Achse eines vorhandenen Diagramms mit dem TypnamenSimPlotXAxisFeatureoderSimPlotYAxisFeature, etwa ausMotionPlotFeatureData.GetXAxisoderMotionPlotFeatureData.GetYAxis
Beispiel
' Berechnet die Bewegungsstudie "Motion Study 1", gibt die Verschiebung der ausgewählten
' Fläche in y-Richtung über der Zeit aus und legt dafür ein Diagramm an.
' Vorbedingung: Eine Baugruppe ist offen, das Zusatzprogramm SOLIDWORKS Motion ist geladen.
' "Motion Study 1" ist eine Motion-Analyse, eine Fläche ist ausgewählt.
' Unter Extras > Verweise ist „SOLIDWORKS <Version> MotionStudy Type Library“
' ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster (Strg+G), das Diagramm steht in der Studie.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swMM As SwMotionStudy.MotionStudyManager
Dim swStudie As SwMotionStudy.MotionStudy
Dim swErgebnisse As SwMotionStudy.CosmosMotionStudyResults
Dim swAusgabe As SwMotionStudy.MotionPlotFeatureOutput
Dim swDiagramm As SldWorks.MotionPlotFeatureData
Dim swXAchse As SldWorks.MotionPlotAxisFeatureData
Dim swYAchsen(0 To 0) As SldWorks.MotionPlotAxisFeatureData
Dim swFlaechen(0 To 0) As SldWorks.Face2
Dim swFeat As SldWorks.Feature
Dim vElemente As Variant, vYAchsen As Variant, vX As Variant, vY As Variant
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelFACES Then Exit Sub
Set swFlaechen(0) = swSelMgr.GetSelectedObject6(1, -1)
Set swMM = swModel.Extension.GetMotionStudyManager
If swMM Is Nothing Then Exit Sub
Set swStudie = swMM.GetMotionStudy("Motion Study 1")
If swStudie Is Nothing Then Exit Sub
If False = swStudie.IsActive Then swStudie.Activate
If False = swStudie.Calculate Then Exit Sub
Set swErgebnisse = swStudie.GetResults(4) ' 4 = Motion-Analyse
If swErgebnisse Is Nothing Then Exit Sub
Set swDiagramm = swErgebnisse.CreatePlotFeatureData
Set swXAchse = swErgebnisse.CreatePlotXAxisFeatureData
Set swYAchsen(0) = swErgebnisse.CreatePlotYAxisFeatureData
swYAchsen(0).Type = swMotionPlotAxisType_TRANS_DISP
swYAchsen(0).Component = swMotionPlotAxisComponent_Y
vElemente = swFlaechen
swYAchsen(0).Entities = vElemente
vYAchsen = swYAchsen
Set swAusgabe = swErgebnisse.GetValues(swDiagramm, swXAchse, (vYAchsen))
vX = swAusgabe.GetXAxis
vY = swAusgabe.GetYAxis(swYAchsen(0))
If IsArray(vX) And IsArray(vY) Then
For i = 0 To UBound(vX)
Debug.Print vX(i), vY(i)
Next i
End If
Set swFeat = swErgebnisse.InsertPlotFeature(swDiagramm, swXAchse, swYAchsen(0))
If Not swFeat Is Nothing Then Debug.Print "Diagramm: " & swFeat.Name
End SubBemerkungen
Ablauf: So legst du ein Diagramm an: Bewegungsstudie berechnen und ihre Ergebnisse holen, die Daten für das Diagramm und seine x- und y-Achsen anlegen, an der y-Achse die Ergebnisgröße (MotionPlotAxisFeatureData.Type) und die Komponente (MotionPlotAxisFeatureData.Component) setzen, die Elemente zuweisen (MotionPlotAxisFeatureData.Entities), dann die Werte mit CosmosMotionStudyResults.GetValues lesen und das Diagramm mit CosmosMotionStudyResults.InsertPlotFeature einfügen. Das Beispiel folgt dem Hilfebeispiel „Create Plots and Get Values“. Dieses legt zwei Diagramme an, für die Verschiebung und für die Geschwindigkeit, und übergibt GetValues ein Array mit beiden y-Achsen.
x-Achse: Das Hilfebeispiel setzt an der x-Achse nichts. Was sie dann zeigt, sagt die Hilfe nicht, vermutlich die Zeit. In welchen Einheiten die Werte aus GetValues stehen, sagt sie ebenfalls nicht.
Bibliothek: MotionStudyManager, MotionStudy, CosmosMotionStudyResults und MotionPlotFeatureOutput stammen aus der MotionStudy Type Library, nicht aus der SldWorks-Bibliothek. Diese Seiten beschreiben sie nicht. Der Studientyp 4 heißt dort swMotionStudyTypeCosmosMotion (Motion-Analyse). Dafür brauchst du das Zusatzprogramm SOLIDWORKS Motion.
Vorhandene Diagramme: In der Tabelle der Typnamen zu Feature.GetTypeName2 haben die Achsen eines Diagramms die Typnamen SimPlotXAxisFeature und SimPlotYAxisFeature, ihre Definition ist ein MotionPlotAxisFeatureData. Ein Hilfebeispiel, das vorhandene Achsen liest oder ändert, gibt es nicht. Ob du geänderte Werte mit Feature.ModifyDefinition zurückschreibst, sagt die Hilfe nicht.
Eigenschaften und Methoden
Eigenschaften 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| Component | Liest oder setzt, welche Komponente einer vektoriellen Ergebnisgröße die Achse zeigt, etwa x, y, z oder den Betrag. |
| Entities | Liest oder setzt die Elemente, deren Bewegung die Achse misst, etwa eine Fläche einer Komponente. |
| ReferencePart | Liest oder setzt die Komponente, in deren Koordinatensystem die Komponenten eines Ergebnisvektors gelten. |
| Type | Liest oder setzt, welche Ergebnisgröße die Achse zeigt, etwa Zeit, Verschiebung, Geschwindigkeit oder Kraft. |
Siehe auch
Englisches Original: IMotionPlotAxisFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.