6. Überblick Automatisierung der Diagrammerstellung

Eine Beschreibung finden Sie unter Automatisierung der Diagrammerstellung.

	Allgemeine Funktionen
auto_AddToUI	Mit Hilfe der Funktion auto_AddToUI kann eine UniScript-Funktion, die eine Auswertung enthält, in die Benutzeroberfläche von UniPlot eingefügt werden. Funktionen, die mit auto_AddToUI registriert werden, werden in das Menü Auswertung in die angegebene Kategorie eingefügt.
auto_GetFileNameDialog	auto_GetFileNameDialog ruft ein Dialogfeld auf, mit dem bis zu 16 Dateinamen ausgewählt werden können. Die Funktion kann innerhalb von Automatisierungsskripten verwendet werden.
auto_ImportData	Die Funktion auto_ImportData legt die Datendatei fest, aus der Datensätze importiert werden sollen. Es können Daten aus allen von UniPlot unterstützten Datendatei-Formaten geladen werden (ASCII-, Excel-, netCDF-Dateien usw.). Bei Excel-Dateien kann zusätzlich als zweiter Parameter der Tabellenname der Excel-Datei angegeben werden.
auto_LoadDataset	auto_LoadDataset lädt aus einer Daten-Datei, die mit der Funktion auto_ImportData geöffnet wurde, einen 1D-, 2D- oder 3D-Datensatz.
auto_LoadTemplate	auto_LoadTemplate öffnet eine Vorlagendatei.
auto_ReplaceText	auto_ReplaceText ersetzt vorhandene Texte in der Vorlage durch neue Texte. Die Texte können sich in Textobjekten und Achsentiteln befinden.
auto_ReplaceTextDialog	auto_ReplaceTextDialog kann innerhalb eines Automatisierungs-Skripts verwendet werden, um ein Text-Dialogfeld anzuzeigen.
auto_SetFileNameDialogInit	auto_SetFileNameDialogInit setzt für die Funktion auto_GetFileNameDialog den Suchfilter und das Suchverzeichnis.
auto_UpdatePage	Die Funktion auto_UpdatePage sollte als letzte Funktion für die Erstellung der Seite aufgerufen werden. Die Funktion kopiert den erzeugten Legendentext in das Textobjekt mit dem Platzhaltern $LEGEND$, paßt gegebenenfalls die Größe der Legende an und aktualisiert die Seite auf dem Monitor (Neuzeichnen).

	Weitere Funktionen
auto_CloseDocument	auto_CloseDocument schließt das erzeugte Dokument. Wurde das Dokument noch nicht mit der Funktion auto_SaveDocumentAs gespeichert, wird das Dokument ohne Speicherung geschlossen.
auto_AddPage	Mit auto_AddPage können Sie mehrseitige Dokumente erzeugen. Die Funktion bewirkt, daß der nächste auto_LoadTemplate-Aufruf eine Seite zum aktiven Dokument hinzufügt.
auto_LoadStyleFile	Die Funktion auto_LoadStyleFile lädt eine Stildatei. In der Stildatei befinden sich Beschreibungen, wie die Datensätze dargestellt werden sollen. Einige Beispiel-Dateien befinden sich im Sample-Verzeichnis von UniPlot. Sie haben die Dateinamenserweiterung .sty oder .icb.
auto_PrintDocument	Die Funktion auto_PrintDocument druckt das mit der Funktion auto_LoadTemplate erzeugte Dokument auf den ausgewählten Drucker aus.
auto_PrintPage	Die Funkion auto_PrintPage druckt die mit der Funktion auto_LoadTemplate erzeugte Seite auf dem ausgewählten Drucker aus.
auto_ReadNCText	Die Funktion auto_ReadNCText liest ein Attribut aus der zuletzt mit der Funktion auto_ImportData geöffneten Datendatei.
auto_ReplaceTextFromNCFile	auto_ReplaceTextFromNCFile sucht in der angegebenen Seite nach in Dollar-Zeichen eingeschlossenen Texten und ersetzt die Texte durch Attribut-Werte aus der angegebenen netCDF (.NC) Datei. Die netCDF-Datei wird mit der Funktion auto_ImportData erzeugt.
auto_SaveDocumentAs	auto_SaveDocumentAs speichert das mit der Funktion auto_LoadTemplate erzeugte Dokument unter einem neuen Namen.
auto_ScaleAxes	auto_ScaleAxes skaliert alle Diagramme in der Seite, die mit der Funktion auto_LoadTemplate erzeugt wurde, neu, so daß alle Datensätze komplett in den Diagrammen sichtbar sind.
auto_SetDatasetStyle	auto_SetDatasetStyle setzt den Datensatzstil, den der nächste Datensatz, der mit der Funktion auto_LoadDataset erzeugt wird, erhält.
auto_SetLegendText	Die Funktion auto_SetLegendText erzeugt für 1D- und 2D-Datensätze einen Legenden-Eintrag. Wird die Funktion ohne Parameter aufgerufen, wird als Text der Dateiname, aus dem die Daten geladen wurden, verwendet.
auto_UpdateLegendSize	Die Funktion legt fest, daß die Größe der Legende, die in der Vorlage durch den Platzhalter $LEGEND$ festgelegt ist, in der Funktion auto_UpdatePage an den Text der Legende angepasst wird. Die Funktion sollte vor der Funktion auto_UpdatePage aufgerufen werden, falls die Größe angepasst werden soll.
XLSREPORT_CreateFromTemplate	XLSREPORT_CreateFromTemplate füllt ein Excel-Template mit Daten aus den angegebenen Datendateien.

	Funktionen für xy-Datensätze
auto_xy_Add	Erzeugt einen neuen Datensatz aus der Summe der y-Koordinaten der angegebenen 2D-Datensätze.
auto_xy_Correlate	Erzeugt einen neuen Datensatz, wobei die y-Koordinaten des ersten Datensates die x-Koordinaten und die y-Koordinaten des zweiten Datensatzes die y-Koordinaten des neuen Datensatzes bilden.
auto_xy_CorrelationCoefficient	auto_xy_CorrelationCoefficient berechnet den Korrelations-Koeffizienten des gegebenen 2D-Datensatzes.
auto_xy_CreateDataset	auto_xy_CreateDataset erzeugt einen neuen Datensatz mit den angegebenen x- und y-Koordinaten.
auto_xy_CreateErrorDataset	auto_xy_CreateErrorDataset erzeugt einen neuen 2D-Datensatz mit Fehlerbalken.
auto_xy_CreateRegion	auto_xy_CreateRegion erzeugt aus zwei aufsteigend sortierten Datensatzen einen Datensatz. Der zweite Datensatz wird dazu in umgekehrter Reihenfolge an den ersten Datensatz angehängt.
auto_xy_Derivative	Diese Funktion ist veraltet. Neue Scripte sollten die Funktion XYSetFilterFunctions verwenden.
auto_xy_Div	Erzeugt einen neuen Datensatz aus der Division der y-Koordinaten der angegebenen 2D-Datensätze.
auto_xy_Envelope	auto_xy_Envelope berechnet eine obere oder untere Hüllkurve. Die x-Koordinaten des Datensatzes müssen aufsteigend sortiert sein.
auto_xy_ExtractRange	auto_xy_ExtractRange
auto_xy_GetParentHandle	auto_xy_GetParentHandle liefert die Zugriffsnummern des Diagramms hLayer, der Seite hPage und des Dokuments hDoc, in dem sich der Datensatz befindet
auto_xy_Integral	Diese Funktion ist veraltet. Neue Scripte sollten die Funktion XYSetFilterFunctions verwenden.
auto_xy_IntegralValue	auto_xy_IntegralValue liefert einen Text mit dem Inegral-Wert eines Datensatzes.
auto_xy_Interpolate	Erzeugt für alle gegebenen 2D-Datensätze jeweils einen neuen Datensatz, der die Stützstellen aller Datensätze enthält.
auto_xy_LabelDataPoints	Die Funktion auto_xy_LabelDataPoints beschriftet die Datenpunkte eines 1D- oder 2D-Datensatzes mit den Y-Koordinaten. Falls der Datensatz mehr als 50 Datenpunkte enthält, werden 50 Beschriftungen auf die Datenpunkte verteilt.
auto_xy_LabelDataPoints_SetOptions	auto_xy_LabelDataPoints_SetOptions
auto_xy_LabelDataset	auto_xy_LabelDataset beschriftet den letzten Datenspunkt eines 1D- oder 2D-Datensatzes mit dem Namen des Datensatzes.
auto_xy_LinearInterpolation	auto_xy_LinearInterpolation berechnet durch lineare Interpolation neue Datenpunkte für eine gegeben Kurve. Die x-Daten müssen aufsteigend sortiert sein.
auto_xy_Max	Erzeugt einen neuen Datensatz aus dem Maximum der y-Koordinaten der angegebenen 2D-Datensätze.
auto_xy_Mean	Erzeugt einen neuen Datensatz aus dem arithmetischen Mittelwert der y-Koordinaten der angegebenen 2D-Datensätze.
auto_xy_Min	Erzeugt einen neuen Datensatz aus dem Minimum der y-Koordinaten der angegebenen 2D-Datensätze.
auto_xy_MinMaxValue	auto_xy_MinMaxValue liefert einen Text mit dem Minimal- und Maximalwert eines Datensatzes.
auto_xy_Mult	Erzeugt einen neuen Datensatz durch Multiplikation der y-Koordinaten der angegebenen 2D-Datensätze.
auto_xy_OneDown	Die Funktion auto_xy_OneDown ändert die Ausgabereihenfolge der Datensätze innerhalb eines Diagramms. Die Funktion verschiebt den angegebenen Datensatz um eine Ebene nach hinten.
auto_xy_OneUp	Die Funktion auto_xy_OneUp ändert die Zeichenreihenfolge der Datensätze innerhalb eines Diagramms. Die Funktion verschiebt den angegebenen Datensatz um eine Ebene nach vorne.
auto_xy_Peaks	Erzeugt für den gegebenen 2D-Datensatz einen Datensatz mit den lokalen Minima und Maxima (Peaks). Siehe detect_peaks.
auto_xy_RemoveDoublePoints	Diese Funktion ist veraltet. Neue Scripte sollten die Funktion XYSetFilterFunctions verwenden.
auto_xy_Scale	Diese Funktion ist veraltet. Neue Scripte sollten die Funktion XYSetFilterFunctions verwenden.
auto_xy_SetStyleAttribs	Die Funktion setzt für eine Kurve die Linien- und Marker- Darstellung. Die Funktion greift nicht auf die Stildatei zu.
auto_xy_Smooth	Diese Funktion ist veraltet. Neue Scripte sollten die Funktion XYSetFilterFunctions verwenden.
auto_xy_SortX	Diese Funktion ist veraltet. Neue Scripte sollten die Funktion XYSetFilterFunctions verwenden.
auto_xy_Spline	Diese Funktion ist veraltet. Neue Scripte sollten die Funktion XYSetFilterFunctions verwenden.
auto_xy_Statistic	auto_xy_Statistic berechnet einige statistische Kennzahlen eines 2D-Datensatzes.
auto_xy_Step	Diese Funktion ist veraltet. Neue Scripte sollten die Funktion XYSetFilterFunctions verwenden.
auto_xy_Sub	Erzeugt einen neuen Datensatz aus der Differenz der y-Koordinaten der angegebenen 2D-Datensätze.
auto_xy_histogram	Erzeugt für den gegebenen 2D-Datensatz ein Histogramm. Dazu werden die y-Koordinaten klassiert.

	Funktionen für xyz-Datensätze
auto_xyz_Add	auto_xyz_Add addiert zwei 3D-Datensätze (Kennfelder).
auto_xyz_CreateColorLegend	auto_xyz_CreateColorLegend erzeugt für einen 3D-Datensatz eine Farblegende.
auto_xyz_CreateHull	auto_xyz_CreateHull berechnet für den gegebenen 3D Datensatz eine Hüllkurve (Volllastlinie, Schleppkurve, Gesamthülle), wenn die Messdaten bei quasi konstanten x- (z. B. Drehzahlschnitte) bzw. quasi konstanten y-Koordinaten gemessen wurden.
auto_xyz_CreateIsolines	auto_xyz_CreateIsolines erzeugt für den angegebenen 3D-Datensatz Isolinien.
auto_xyz_CreatePowermap	auto_xyz_CreatePowermap erzeugt ein Leistungskennfeld (Leistungshyperbeln).
auto_xyz_CrossSectionXY	auto_xyz_CrossSectionXY berechnet einen Kennfeldschnitt entlang einer gegebenen 2D-Kurve.
auto_xyz_Div	auto_xyz_Div dividiert zwei 3D-Datensätze (Kennfelder).
auto_xyz_Interpolate	auto_xyz_Interpolate berechnet eine neue Interpolationsmatrix für den angegebenen 3D-Datensatz.
auto_xyz_Mean	auto_xyz_Mean berechnet den Mittelwert zweier 3D-Datensätze (Kennfelder).
auto_xyz_Mult	auto_xyz_Mult multipliziert zwei 3D-Datensätze (Kennfelder).
auto_xyz_RelDiv	auto_xyz_RelDiv berechnet die Abweichung zweier 3D-Datensätze (Kennfelder).
auto_xyz_SetIsolineStyle	Die Funktion setzt für einen 3D-Datensatz die Linien-Darstellung für die Isolinien. Die Funktion greift nicht auf die Stildatei zu.
auto_xyz_Statistic	auto_xyz_Statistic berechnet einige statistische Kennzahlen.
auto_xyz_Sub	auto_xyz_Sub subtrahiert zwei 3D-Datensätze (Kennfelder).

Siehe auch

UniScript-Funktionen-Überblick

_id-1891577