SolidWorksMakroprogrammierung

Objekt · SldWorks

MotionPlotAxisFeatureData-Objekt

Die Daten einer Achse eines Diagramms in einer Bewegungsstudie: Ergebnisgröße, Komponente, gemessene Elemente und Bezugskomponente.

Deklaration Dim x As SldWorks.MotionPlotAxisFeatureData · in der englischen .NET-Hilfe: IMotionPlotAxisFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
ComponentLiest oder setzt, welche Komponente einer vektoriellen Ergebnisgröße die Achse zeigt, etwa x, y, z oder den Betrag.
EntitiesLiest oder setzt die Elemente, deren Bewegung die Achse misst, etwa eine Fläche einer Komponente.
ReferencePartLiest oder setzt die Komponente, in deren Koordinatensystem die Komponenten eines Ergebnisvektors gelten.
TypeLiest 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.