abapys.ausgabe

ausgabe.py   v1.4 (2023-02)

 
Functions
       
BauteileEinfaerben(viewport, zuweisungen, standardfarbe='#000000', odb=True)
Faerbt das im uebergebenen viewport dargestellte Modell nach Instanzen ein. Mit zuweisungen
wird eine Liste erwartet mit [[Instanzname, Farbe], [...]] wobei, die Farbe im Hexadezimal-Format
zu geben ist (bspw. ist rot '#FF0000'). Alle Instanzen, die nicht in der zuweisung gelistet sind,
werden mit standardfarbe eingefaerbt. Um die korrekte Zuweisung zu ermoeglichen, muss  mit dem
Flag odb angegeben werden, ob es sich um eine odb oder mdb (odb=False) handelt.
BildSpeichern(dateiname, session, dateityp='png', bildgroesse=[], hintergrund=False)
Speichern die Darstellung des aktiven Viewports aus session als Bilddatei mit dem Namen
dateiname. Optional kann der dateityp ('png' oder 'eps') und die bildgroesse (als Vektor mit
Bildbreite und Bildhoehe in Pixeln) angepasst werden.
DehnungsInvarianteAlsFieldOutput(name, session, odbname, beschreibung='Dehungsinvariante')
Fuege einen neuen FieldOutput namens name zur Ausgabedatei odbname der session mit der
Dehnungsinvariante hinzu. Optional kann die Beschreibung angepasst werden.
FieldOutputSpeichern(dateiname, session, odbname, fieldOutput, step, frame)
Ermittle die Ausgabevariable fieldOutput im angeforderten step und frame
(beides Zahlenwerte) der Datei odbname aus der aktuellen session. Speichere
das Ergebnis unter dateiname.erg.
FieldOutputVorbereiten(session, odbname, var, varposition)
Extrahiere die XY-Daten eines Field-Outputs aus odb namens odbname aus session mit dem Namen
var=[Variablenname, Komponente] und varposition=(Instanzname, [Label(s)]).
 
Wenn mit varposition mehr als ein Label in der Liste uebergeben wird, stimmt die Reihenfolge der
erzeugten Daten im Allgemeinen nicht mit der Reihenfolge der Labels in der Liste uebereinstimmen.
HistoryOutputVorbereiten(session, odbname, var, varname)
Extrahiere die XY-Daten eines History-Outputs aus einer odb namens odbname aus session mit dem
exakten Namen var oder var=[Instanzname, Ausgabevariable]. Im letzten Fall wird der Name des
dazugehoerigen Outputs automatisch bestimmt. Falls Ausgaben fuer das ganze Modell ohne komplette
Namensnennung erforderlich sind, kann Instanzname auch leer bleiben (bspw. ['', 'ETOTAL']).
Speichere die Daten intern unter dem Namen varname.
LetzterOutputStepUndFrame(session, odbname)
Ermittle aus der Ausgabedatei odbname in der aktuellen session den letzten Step und
darin den letzten Frame, in dem Outputs geschrieben worden sind.
Modellansicht(session, ansicht='', rechts=1, oben=2)
Aendere die Ansicht des aktiven Viewports der session entweder durch die interne ansicht
(d.h. 'Front', 'Back', 'Top', 'Bottom', 'Left' oder 'Right') oder durch Angabe der Achsen rechts
und oben (x = +/-1, y = +/-2, z = +/-3).
 
       y                        y                  +-- x                    z          
Front  |              Back      |            Top   |                Bottom  |         
       +-- x                x --+                  z                        +-- x     
(rechts=1, oben=2)    (rechts=-1, oben=2)    (rechts=1, oben=-3)    (rechts=1, oben=3) 
 
 
      y                          y                  y
Left  |               Right      |           Iso    |
      +-- z                  z --+                z   x
(rechts=3, oben=2)    (rechts=-3, oben=2)    --nicht ohne zusaetzliche Drehung---
MultiBildSpeichern(dateiname, session, anordnung=[1, 1], zeitstempel=None, zeitstempelkanal=0, legendenkanal=0, mehrfachmodus=False, autozoom=False)
Speichere Dateien mit dem Titel dateiname aus dem aktiven Viewport der Session session und odb
namens odbname. Optional kann statt einem Bild mehrere Teilbilder nach der Anordnung anordnung
ausgegeben werden. Falls SINGLE und OVERLAY-Modus gespeichert werden sollen, kann mehrfachmodus
aktiviert werden.
Optional kann mit autozoom der Zoom innerhalb der Funktion abhaengig vom uebergebenen sichtbaren
Bereich und der Aufteilung in anordnung durchgefuehrt werden.
MultiVideobilderSpeichern(dateiname, session, odbname, anordnung=[1, 1], zeitstempel=None, zeitstempelkanal=0, legendenkanal=0, mehrfachmodus=False, autozoom=False)
Speichere Dateien mit dem Basisnamen dateiname aus der Ausgabedatei odbname, die im aktiven
Viewport der session dargestellt ist. Optional koennen statt einem Bild mehrere Teilbilder in der
gegebenen anordnung (Teilbilder horizontal und vertikal) ausgegeben werden. Optional kann
ausserdem ein zeitstempel uebergeben werden, der nur im Teilbild zeitstempelkanal angezeigt wird.
Auch eine moeglicherweise sichtbare Legende wird nur im legendenkanal dargestellt. Dabei hat das
linke obere Teilbild den Wert 0 und nimmt zeilenweise von links nach rechts zu. Falls
mehrfachmodus aktiviert ist, werden Bilder im SINGLE- und OVERLAY-Modus gespeichert.
Optional kann mit autozoom der Zoom innerhalb der Funktion abhaengig vom uebergebenen sichtbaren
Bereich und der Aufteilung in anordnung durchgefuert werden.
PlotFormatieren(xyplot, chart, titel='', xlabel='', ylabel='', xlim=[], ylim=[])
Plot xyplot und Darstellung chart verschoenern und an typisches Format anpassen. Optional
koennen titel, xlabel und ylabel als Text definiert werden. Ausserdem kann der
Darstellungsbereich der beiden Achsen durch einen Vektor mit Minimal- und Maximalwert beschraenkt
werden (ohne Angabe erfolgt Autoskalierung).
PlotLegendeFormatieren(session, chart, curvedata, legendeneintraege, zuerstFarbenwechseln=True, kurvenFarben=[], kurvenStile=[])
Die Legende von chart aus session mit den Kurven curvedata wird mit den Werten aus
legendeneintraege geschrieben. Optional koennen auch kurvenFarben und kurvenStile, sowie deren
Abfolge mit zuerstFarbenwechseln geaendert werden.
PlotOutput(session, odbname, yvar, yvarposition=[], ylabel='', ylimit=[], posydir=True, xvar=[], xvarposition=[], xlabel='', xlimit=[], posxdir=True, titel='', legendeneintraege=[], plothinzufuegen=False)
Plotte die angegebenen yvar der Auswahl yvarposition ueber xvar an xvarposition der odb namens
odbname aus session. Falls xvar nicht definiert ist, wird diese Achse zur Zeitachse. Es koennen
mehrere Daten (bspw. mehrere Elemente) fuer die y-Richtung uebergeben werden, aber fuer die
x-Richtung darf es nur ein einziger Datensatz sein.
 
Optional koennen auch xlabel und ylabel zur Achsenbeschriftung sowie xlimit und ylimit zur
Beschraenkung der Zeichenebene uebergeben werden. Die Richtung der Werte kann optional ueber
posxdir oder posydir invertiert werden. Optional kann ausserdem ein titel fuer den Plot und die
Bezeichnung der legendeneintraege uebergeben werden. Falls bereits ein Plot existiert, steuert
plothinzufuegen, ob er ueberschrieben oder ergaenzt wird.
 
Erwartet wird bei FieldOuptut-Variablen ein Vektor var=(Variablenname, Komponente) und entweder
die Variablenposition mit yvarposition=(odb-Setname) oder (Instanzname, [Label(s)]).
 
Bei HistoryOutput-Variablen wird nur ein Vektor var=([Instanzname, Ausgabevariable]) oder
var=(Ausgabenname) erwartet (varposition entfaellt). Im Fall var=([Instanzname, Ausgabevariable])
wird der Name des dazugehoerigen Outputs automatisch bestimmt. Falls Ausgaben fuer das ganze
Modell ohne komplette Namensnennung erforderlich sind, kann Instanzname auch leer bleiben
(bspw. ['', 'ETOTAL']).
PlotXYDaten(session, xyListe, ylimit=[], ylabel='', xlimit=[], xlabel='', titel='', legendeneintraege=[], plothinzufuegen=False)
Plotte die in der xyListe angegebenen XYDaten. Optional koennen xlabel und ylabel zur
Achsenbeschriftung sowie xlimit und ylimit zur Beschraenkung der Zeichenebene uebergeben werden.
Optional kann ausserdem ein titel fuer den Plot und die Bezeichnung der legendeneintraege
uebergeben werden. Falls bereits ein Plot existiert, steuert plothinzufuegen, ob er
ueberschrieben oder ergaenzt wird.
SkalarenFieldOutputErstellen(name, session, odbname, referenzAusgabe, beschreibung='', bedingung='data11')
Fuege einen neuen FieldOutput name zur Ausgabedatei odbname der session mit Daten aus
referenzAusgabe hinzu. Die Daten im FieldOutput referenzAusgabe koennen skalare Werte oder
Tensoren sein. Optional kann die Beschreibung angepasst werden. Optional kann ausserdem mit
bedingung ein Kommando zur Kombination der Eintraege ausgefuehrt werden. Fuer einen Ausdruck in
bedingung entsprechen [data11, data22, data33, data12, data13, data23] den sechs Eintraegen
eines Tensorfeldes. Bei einem Skalar entspricht data11 dem Zahlenwert.
 
Fuer mathematische Zusammenhaenge stehen die Funktionen sqrt, sin, cos, tan, asin, acos, atan
zur Verfuegung.
SpannungsSpurAlsFieldOutput(name, session, odbname, spannungstyp='SVAVG', beschreibung='Spur des Spannungstensors')
Fuege einen neuen FieldOutput namens name zur Ausgabedatei odbname der session mit der
Spur des Spannungstensors hinzu. Als spannungstyp kann zwischen 'S' und 'SVAVG'
unterschieden werden. Optional kann ausserdem die Beschreibung angepasst werden.
StandardFarben()
Gebe den Vektor mit den Standardfarben und deren Reihenfolge in Abaqus aus.
Ueberlagerung(session, ebenen, versteckteSets=[], versteckteInstances=[], verschiebung=0.0)
Erstelle mehrere Darstellungsebenen im aktiven Viewport der session mit den Bezeichnungen
ebenen. Basierend auf der Anzeige beim Aufruf der Funktion koennen zusaetzliche Sets (mit vollem
Instance-Pfad) oder/und Instances je Ebene versteckt werden. Optional kann eine globale
Verschiebung der Ebenen zueinander definiert werden.
VideobilderSpeichern(dateiname, session, odbname, dateityp='png', numzahlen=3, zeitstempel=None, startstep=0, startframe=0, stopstep=-1, stopframe=-1, erstedateinummer=None)
Gebe im aktiven viewport von session alle frames aus allen steps als Bilddaten mit dem
Basisnamen name im Format dateityp aus. Bildbreite und Bildhoehe wird von der aktuellen
Einstellung uebernommen.
 
Um nur eine Unterauswahl an Bildern zu speichern kann ein Intervall mit startstep/startframe
sowie stopstep/stopframe definiert werden. Vorallem dann kann es sich auch anbieten, die
Dateiausgabe nicht bei ihrem natuerlichen Start, sondern bei 0 starten zu lassen, indem
erstedateinummer=0 gesetzt wird.
ViewportBemassung(db, viewport, bezeichnung, punkt1, punkt2, offset, groesse=180)
Bemasse eine Laenge eines Bauteils einer odb (db=odb.userData) oder mdb (db=mdb) im viewport
zwischen punkt1 und punkt2. Die Bemassung benoetigt ein offset zur Bemassungslinie und bekommt
intern die angegebene bezeichnung zugewiesen. Optional kann die groesse der Schrift der Bemassung
angepasst werden. Gibt die Namen der vier erzeugten Annotationen zurueck.
XYDatenAnElementen(session, odbname, odbinstname, labelliste, zeitpunkt, var, name, beschreibung='')
Erstelle xyDaten namens name (mit beschreibung) aus Daten der in der aktuellen session
geoeffneten odb namens odbname. Die xyDaten werden aus dem FieldOutput der Variable
var=[Variablenname, Komponente] fuer den uebergebenen zeitpunkt aus odbinstname erstellt.
Abhaengig davon, ob var an Elementen oder Knoten definiert ist, wird in labelliste auch eine
Auflistung von Knotenlabels oder Elementlabels erwartet, fuer die die xyDaten erstellt werden
sollen.
XYDatenSpeichern(dateiname, session, xydatenname, nachkommastellen=4)
Speichert den Datensatz xydatenname des aktiven Viewports von session als csv-Datei dateiname.
Optional kann die Anzahl an nachkommastellen angepasst werden.