.. highlightlang:: us .. _xyzcreatefrommatrix: XYZCreateFromMatrix =================== .. index:: XYZCreateFromMatrix .. us.tag XYZCreateFromMatrix GERMAN :ref:`XYZCreateFromMatrix` erzeugt einen 3D-Datensatz. .. function:: hData = XYZCreateFromMatrix(ssName, rmZ, rvRange) .. us.return **Returnwert** *hData* ist die Zugriffsnummer (Handle), mit der auf den Datensatz zugegriffen werden kann. Falls der Datensatz nicht erzeugt werden kann ist *hData* gleich 0. .. us.params **Parameter** .. uparam:: ssName *ssName* ist ein skalarer String. .. uparam:: rmZ *rmZ* ist eine Matrix mit Z-Werten. .. uparam:: rvRange *rvRange* ist ein Vektor mit 4 Elementen, die den Bereich der Z-Matrix in der x,y-Ebene bestimmen. *rvRange* hat den folgenden Aufbau: rvRange = [rsXmin, rsYmin, rsXmax, rsYmax]. rsXmin muss kleiner als rsXmax und rsYmin kleiner als rsYmax sein. .. us.comment **Kommentar** Die Matrix muss mindestens 2 ``*`` 2 Elemente haben. Die Matrix muss nicht quadratisch sein. Siehe auch XYZCreate, falls die Matrix an bestimmenten x-, y-Koordianten gemessen wurden. .. us.example **Beispiel** Das folgende Beispiel können Sie in einen Editor kopieren (:ref:`dateineu` **[Programm Editor]**) und dann den Befehl :ref:`uniscriptspeichern/ausfuhren` ausführen. :: x = linspace(-10, 6.0, 30); y = linspace(-10, 5.0, 30); = meshdom(x,y); zz = sin(sqrt(xx.*xx + yy.*yy)) + sin(xx); rvRange = [x[1], y[1], x[len(x)], y[len(y)]]; hData = XYZCreateFromMatrix("sin", zz, rvRange); hLayer = LayerCreate(); hDoc = DocCreate(); hPage = PageCreate(); DocAddPage(hDoc, hPage); PageAddLayer(hPage, hLayer); LayerAddDataset(hLayer, hData); LayerAutoScale(hLayer); PageReplot(hPage); .. seealso:: :ref:`uberblick-xyz-datensatze`, :ref:`XYZDestroy`, :ref:`XYZCreate`, :ref:`LayerAddDataset`, :ref:`XYZSetInterRange` :sub:`id-898700`