.. |Daten_1D_2DKonfig| image:: S:/uniplot-obj/buttons/Daten_1D_2DKonfig.png :align: top .. |Daten_Datensaetze| image:: S:/uniplot-obj/buttons/Daten_Datensaetze.png :align: top .. |Main_Command| image:: S:/uniplot-obj/buttons/Main_Command.png :align: top .. |Daten_3DKonfig| image:: S:/uniplot-obj/buttons/Daten_3DKonfig.png :align: top .. highlightlang:: us .. _examples: Examples ======== .. _2d-dataset-attributes: 2D Dataset Attributes --------------------- .. image:: S:/uniplot-obj/images/Uni_BSP1.* * Click the curve to select the dataset and then choose the **2D Curve** |Daten_1D_2DKonfig| button from the toolbar, or * Double-click the curve, or * Choose the **Dataset List** |Daten_Datensaetze| button from the toolbar, select the name of the dataset and then choose the Configuration button to open the 2D Curve dialog box. .. _diagram-with-3-overlapping-y-axes: Diagram with 3 Overlapping y-axes --------------------------------- .. image:: S:/uniplot-obj/images/Uni_BSP2.* * Choose :ref:`filenew` and select the diagram with the multiple y-axes option. In the following dialog box, choose **3 y-axes** and then click :guilabel:`OK`. A diagram with one x-axis and three y-axes will be created. * To import a dataset, select the lower diagram by clicking inside the diagram frame. The selection will be displayed by blue handles at the diagram corners. Choose :ref:`fileimport-data`, open the file :file:`VOLLAST.NC`. In the Import dialog box, choose x = ``N`` and y = ``PEFF``. Make sure the **Axes** checkbox is selected and then choose the **Load** button. * Select another diagram, specify the next dataset and click **Load**. * To create a square diagram grid, choose :ref:`diagrammore-diagram-functions` and then select **Scale Axes for Square Grid**. Click **OK** to execute the function. .. _2d-dataset---derivation-and-integration: 2D Dataset - Derivation and Integration --------------------------------------- .. image:: S:/uniplot-obj/images/Uni_BSP3.* * Import the x = ``N`` and y = ``Mom`` 2D dataset from the :file:`vollast.nc` file. * Choose :ref:`datamore-data-functions` and then select the **Create Derivation Dataset** option. A new diagram with a shifted y-axis and a hidden x-axis will be created. * To create an integral dataset from the original (N, Mom) dataset, select the dataset and then choose :ref:`dataintegral`). Again, a new diagram with a shifted y- and a hidden x-axis will be created. However the y-axis will now overlap the y-axis from derivative diagram. * To shift the axis more to the left, choose :ref:`diagramlayout` and type in 4 (cm) for the y-axis distance. * Choose data point symbols for the three datasets and then create a legend (**Diagram=>More Diagram Functions** and select **Legend for 2D datasets**, **Create Legend for all Diagrams**). * Double-click the legend. Mark ``@l{1.2, ..., 0.475}`` and copy (:kbd:`Ctrl+C`) the selection into the clipboard. Close the dialog box and double-click the Mom axis title. Position the cursor at the beginning of the text and then press :kbd:`Ctrl+V` to insert the clipboard contents. Another way to display the marker in the y-title is to insert the field function :ref:`@f{marker}`. This function displays the marker from the first dataset in the diagram. .. _diagram-with-2-curves-and-color-filling: Diagram with 2 Curves and Color Filling --------------------------------------- .. image:: S:/uniplot-obj/images/Uni_BSP4.* * Load the x = Drehzahl (rmp), y = Brennstoffenergie (fuel energy) 2D dataset from the :file:`ENERGIE.ASC` file in the :file:`UniPlot\\Samples` directory. * Choose the **1D and 2D Dataset Configuration** |Daten_1D_2DKonfig| button from the toolbar to open the 2D Dataset dialog box. Click the **Fill Color** check box and then choose the **OK** button. The area under the curve should be color filled down to the x-axis. * Load another dataset from the ENERGIE file. Load the x = ``Drehzahl``, y = ``Nutzleistung`` 2D dataset. * Choose the 2D Dataset button from the toolbar to open the dialog box. Click the **Fill Color** check box. Open the **Fill Color** dialog box and choose the color white, then click the :guilabel:`OK` button. The area under the curve should be color filled down to the x-axis. **Hatch Filling** To fill the area between two curves with a hatch do the following: * Select the two curves. Click the first curve. To select the second curve hold down the :kbd:`Shift` key while you click on the second curve. * Choose :ref:`data-more-data-functions` and select **Hatch Fill between two 2D datasets**. .. _plot-a-function-f(x): Plot a Function f(x) -------------------- .. image:: S:/uniplot-obj/images/Uni_BSP5.* To plot one of these functions: * Choose :ref:`view-command-window` or choose the UniScript |Main_Command| button in the toolbar to open the UniScript command window. * Type in the program lines from to create the plot. The :ref:`plot` function will create a new document with a diagram and the dataset. You can find more information about UniScript in the second part of this user manual. .. _contour-diagram-with-color-gradient-and-legend: Contour Diagram with Color Gradient and Legend ---------------------------------------------- .. image:: S:/uniplot-obj/images/Uni_BSP6.* * To open the :file:`map2.nc` data file from the :file:`UniPlot\\Samples` directory, choose :ref:`file-import-data`. Select the **3D** option button and then select ``N `` for the x-axis, ``PME`` for the y-axis and ``SZ`` for the z-axis. Make sure the **Isolines** and the **Axes** check boxes are marked and then choose the Load button. .. image:: S:/uniplot-obj/images/3D-Import_N_PME_SZ-en.* * Double click an isoline to open the 3D dataset dialog box. Select all the isoline values in the list box and choose the **Delete** button to remove all the isoline values. * Type 0.5, 0.2, 1.5 into the text box and then choose the Insert button to add the values 0.5, 0.7, 0.9, 1.1, 1.3 and 1.5 to the list box. Select all values including the value **min** and click the Fill Color button to specify the color gradient. * Choose white (red=255, blue=255, green=255) for Minimum and black for Maximum (the color gradient will be displayed in the left box) and then choose the OK button. * In the 3D dataset dialog box, choose the **Isoline** tab and select the **Color Filling Between Isolines** check box and then choose the **OK** button. * To create a color legend, choose :ref:`data-more-data-functions` and select the **Color Legend** option. Then click the **OK** button. .. _contour-and-3d-diagram: Contour and 3D Diagram ---------------------- .. image:: S:/uniplot-obj/images/Uni_BSP7.* .. image:: S:/uniplot-obj/images/Uni_BSP7-2.* * Open the MAP2.NC data file and import the x = N, y = PME and z = SZ 3D dataset. * To create a copy of the diagram, choose :ref:`editcopy-diagram` * To insert the clipboard contents into the document, choose :ref:`editpaste`. The pasted diagram will be inserted at the same position as the original diagram. * Select the copied diagram and move it to the lower area of the document. Choose the **3D** button from the toolbar to change the diagram to a 3D diagram. * To specify a color gradient for the surface map, choose the **3D Surface** |Daten_3DKonfig| button from the toolbar. Then choose the **3D Surface** tab and select the **Surface with Color Gradient** option. * To create a color legend, choose :ref:`datamore-data-functions`. Select the **Color Legend** option from the list box. .. _plot-a-function-f(x,y): Plot a Function f(x,y) ---------------------- .. image:: S:/uniplot-obj/images/Uni_BSP8.* .. image:: S:/uniplot-obj/images/Uni_BSP8-2.* * To create a new editor, choose :ref:`filenew`. Select the Editor option from the list box to create an empty editor. * Type in the program code above. * To execute the new program, choose :ref:`uniscript-save-execute`. If you typed in the program correctly, a new document with an isoline diagram will be created. If an error occurs during the compilation process, correct the error and choose **Save/Execute** (**F4**) again. To receive Help for a function, position the cursor on a function name and press **F1**. More information about using the program language UniScript is provided in second part of the manual. .. _contour-cross-section: Contour Cross-section --------------------- .. image:: S:/uniplot-obj/images/Uni_BSP9.* .. image:: S:/uniplot-obj/images/Uni_BSP9-2.* * Import a 3D dataset (x = N, y = EWGMOM, z = LAMAGB) (LAMABG = Lambda in Exhaust) from the :file:`KENNFELD.NC` data file. * Click one isoline to select the 3D dataset. Choose :ref:`datamore-data-functions`. Choose the function **Cross-section for y = constant** from the list box. * In the following dialog box, some cross-section values will be displayed. Delete all values except 20;60;100 in the edit field. The values must be separated by one semi-colon. No separator should be placed in front of the first and after the last value. A new document will be created with cross-section lines for the values 20, 60, and 100 Nm. In the next step, we want to create a copy of the diagram with the contour map into the document. * Choose :ref:`editcopy-diagram`. The diagram, the datasets and the legend will be copied to the clipboard. * Select the document with the contour map. Choose the name of the document from the Window menu. * Insert the diagram from the clipboard into the document. Choose :ref:`editpaste`. * Move the diagram to the lower part of the document. .. _cross-section-along-a-2d-curve: Cross-section along a 2D Curve ------------------------------ .. image:: S:/uniplot-obj/images/Uni_BSP10.* .. image:: S:/uniplot-obj/images/Uni_BSP10-2.* .. image:: S:/uniplot-obj/images/Uni_BSP10-3.* To create a cross-section along a curve in the x/y plane, a 2D dataset is necessary. For every data point, a z-value will be computed from the contour map. The z-values can be plotted as a x/z-, a y/z-curve or the z-values can be plotted over the arc length. In the example, the cross-section was computed along the driving resistance curve in a fuel consumption map. To create the cross-section, load the (:file:`UniPlot\\Samples\\Sample.ipw`) example file and repeat the steps from the previous example. :sub:`id-1530564`