
<section id='NMPlot_WorkingWithPlots_id'
webfilename='workingwithplots'>
    <title>
        Working With Plots
    </title>
    <section id='NMPlot_MouseLocationDisplayOnStatusBar_id'>
        <title>
            Mouse Location Displayed On Status Bar
        </title>
        <para>
            To determine the geographic coordinates of a location on a plot,
            point to that location with the mouse. The coordinates are displayed
            on the <link target='#WCF_ApplicationMainStatusBar_id'>status
            bar</link>. You can change the coordinate system used to display
            the location: see <iref
            target='NMPlot_ApplicationOptions_MouseLocationDisplayCoordinates_id'/>.
        </para>
        <exhibit>
            <img src='NMPlot_ScreenCap_StatusBar_MouseLocation.png'/>
        </exhibit>
        <para>
            If the location is within the primary grid's <link
            target='#NMPlot_GridDefinedAreaPolygon_id'> defined area polygon</link>,
            the <link target='#NMPlot_DataValue_Term_id'>data value</link>
            of the grid at that location is also displayed. If the location
            is between grid data points, two-dimensional interpolation is
            used to compute the data value.
        </para>
        <para>
            If the location is outside the primary grid's <link
            target='#NMPlot_GridDefinedAreaPolygon_id'>defined area polygon</link>,
            dashes ---- are displayed for the data value.
        </para>
        <para>
            The coordinates and the data value are automatically updated as
            the mouse is moved.
        </para>
    </section>
    <section>
        <title>
            Mouse Tools
        </title>
        <para>
            NMPlot provides a number of tools for working with plots. For
            example, the <link target='#NMPlot_MouseToolMeasurement_id'>Measurement
            tool</link> allows you to measure the distance between two points
            on a plot.
        </para>
        <para>
            To use a tool, you must first <termtext>activate</termtext> it
            by pressing its button on the toolbar. When the mouse cursor is
            over a plot, the cursor changes shape to indicate which tool is
            active.
        </para>
        <para>
            The tools are described in detail in this chapter.
        </para>
    </section>
    <section>
        <title>
            Zooming and Panning
        </title>
        <para>
            <termtext>Zooming</termtext> refers to increasing or decreasing
            the magnification level at which a plot is displayed.
        </para>
        <exhibit>
            <img src='NMPlot_Figure_Zooming.png' standard_colors='true'/>
        </exhibit>
        <para>
            <termtext>Panning</termtext> refers to moving a plot horizontally
            or vertically, so that previously hidden portions of the plot
            become visible.
        </para>
        <exhibit>
            <img src='NMPlot_Figure_Panning.png' standard_colors='true'/>
        </exhibit>
        <section id='NMPlot_MouseToolZoom_id'>
            <title>
                The Zoom Mouse Tool
            </title>
            <para>
                Activate the Zoom mouse tool by pressing its button <img
                src='intres:WCF_MagnifyingGlassToolbarButtonBitmap'/> on the toolbar.
                When the Zoom tool is active, you can:
            </para>
            <unorderedlist>
                <listitem>
                    <para>
                        Zoom in by clicking on a plot with the left mouse button.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        Zoom out by clicking on a plot with the right mouse button.
                    </para>
                </listitem>
            </unorderedlist>
            <para>
                When the Zoom tool is active, you can drag a rectangular area
                using the left mouse button. The plot is zoomed and panned so
                that this area fills the plot window.
            </para>
        </section>
        <section id='NMPlot_MouseToolPan_id'>
            <title>
                The Pan Mouse Tool
            </title>
            <para>
                Activate the Pan mouse tool by pressing its button <img
                src='intres:WCPICxWCF_PanTool_ToolbarButton'/> on the toolbar.
                When the Pan tool is active, you can drag with the left mouse
                button to pan the map.
            </para>
        </section>
        <section>
            <title>
                Using the Mouse Wheel
            </title>
            <para>
                If your mouse has a wheel button, you can use it to zoom and pan
                the plot.
            </para>
            <para>
                Roll the wheel forward to zoom in. Roll the wheel backward to
                zoom out. Hold down the <keytext>Ctrl</keytext> key while rolling
                the wheel to zoom in finer increments.
            </para>
            <para>
                Pan by pressing and holding the wheel button. A small marker <img
                src='intres:WCF_ScrollOriginBitmap'/> appears at the point where
                you press the button. While holding the button down, move the
                mouse cursor away from the marker. The plot pans in the direction
                that you move the mouse. The farther the mouse is from the marker,
                the faster the plot pans. Release the mouse button to stop panning.
            </para>
            <para>
                Alternatively, click and release the wheel button. NMPlot enters
                panning mode. Move the mouse to pan the plot. Exit panning mode
                by clicking the wheel button a second time.
            </para>
            <note type='tip'>
                <para>
                    You can zoom and pan using the mouse wheel regardless of which
                    mouse tool is active. This provides you with a convenient way
                    to zoom and pan while using the other mouse tools.
                </para>
            </note>
        </section>
        <section>
            <title>
                Keyboard Shortcuts
            </title>
            <para>
                The following keyboard shortcuts allow you to pan and zoom a plot
                regardless of which mouse tool is active.
            </para>
            <exhibit>
                <table>
                    <tableheader>
                        <tablecolumnheader horzjust='center'>
                            Key
                        </tablecolumnheader>
                        <tablecolumnheader horzjust='left'>
                            Action
                        </tablecolumnheader>
                    </tableheader>
                    <tablerow>
                        <tablecell>
                            &uparrowkey;
                        </tablecell>
                        <tablecell>
                            Pan up
                        </tablecell>
                    </tablerow>
                    <tablerow>
                        <tablecell>
                            <keytext>Ctrl +</keytext> &uparrowkey;
                        </tablecell>
                        <tablecell>
                            Pan up faster
                        </tablecell>
                    </tablerow>
                    <tablerow>
                        <tablecell>
                            &downarrowkey;
                        </tablecell>
                        <tablecell>
                            Pan down
                        </tablecell>
                    </tablerow>
                    <tablerow>
                        <tablecell>
                            <keytext>Ctrl +</keytext> &downarrowkey;
                        </tablecell>
                        <tablecell>
                            Pan down faster
                        </tablecell>
                    </tablerow>
                    <tablerow>
                        <tablecell>
                            &leftarrowkey;
                        </tablecell>
                        <tablecell>
                            Pan left
                        </tablecell>
                    </tablerow>
                    <tablerow>
                        <tablecell>
                            <keytext>Ctrl +</keytext> &leftarrowkey;
                        </tablecell>
                        <tablecell>
                            Pan left faster
                        </tablecell>
                    </tablerow>
                    <tablerow>
                        <tablecell>
                            &rightarrowkey;
                        </tablecell>
                        <tablecell>
                            Pan right
                        </tablecell>
                    </tablerow>
                    <tablerow>
                        <tablecell>
                            <keytext>Ctrl +</keytext> &rightarrowkey;
                        </tablecell>
                        <tablecell>
                            Pan right faster
                        </tablecell>
                    </tablerow>
                    <tablerow>
                        <tablecell>
                            <keytext>+</keytext>
                        </tablecell>
                        <tablecell>
                            Zoom in
                        </tablecell>
                    </tablerow>
                    <tablerow>
                        <tablecell>
                            <keytext>-</keytext>
                        </tablecell>
                        <tablecell>
                            Zoom out
                        </tablecell>
                    </tablerow>
                </table>
            </exhibit>
        </section>
    </section>
    <section id='WCGISxWCF_HomeView_id'>
        <title>
            The Home View
        </title>
        <para>
            When a plot is first displayed, it is automatically zoomed and
            panned so that the "interesting" features of the plot (the contours,
            the geographic annotations, etc.) fill the <link
            target='#NMPlot_PlotDocument_id'>plot window</link>. This is called
            the <termtext> home view</termtext>.
        </para>
        <para>
            If, after scrolling and zooming, you wish to return to the home
            view, you can:
        </para>
        <unorderedlist>
            <listitem>
                <para>
                    Press the Home View button <img
                    src='intres:WCPICxWCF_HomeView_ToolbarButton'/> on the toolbar
                </para>
            </listitem>
            <listitem>
                <para>
                    Press the <keytext>Home</keytext> key
                </para>
            </listitem>
        </unorderedlist>
        <para>
            To change the home view of a plot, follow these steps.
        </para>
        <orderedlist>
            <listitem>
                <para>
                    Display the Home View page of the <link
                    target='#NMPlot_PlotOptionsDialogBox_id'>Plot Options dialog box</link>.
                </para>
                <exhibit>
                    <img src='NMPlot_PlotOptions_HomeView.png'/>
                </exhibit>
            </listitem>
            <listitem>
                <para>
                    Select the method for computing the home view. You have two choices.
                </para>
                <unorderedlist>
                    <listitem>
                        <para>
                            <italic>Specified Plot Elements</italic> - The home view fills
                            the plot window with the selected parts of the plot. You may choose
                            any combination of the following parts.
                        </para>
                        <unorderedlist>
                            <listitem>
                                <para>
                                    The contours
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    The <link target='#NMPlot_PrimaryGrid_id'>primary grid</link>'s
                                    <link target='#NMPlot_GridDataPoints_id'>data points</link>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    The <link target='#NMPlot_PrimaryGrid_id'>primary grid</link>'s
                                    <link target='#NMPlot_GridDefinedAreaPolygon_id'>defined area
                                    polygon</link>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    The <link target='#NMPlot_PrimaryGrid_id'>primary grid</link>'s
                                    <link target='#NMPlot_GridGeographicAnnotations_id'>geographic
                                    annotations</link>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    The <link target='#WCGIS_MapBackground_Layers_id'>background map
                                    layers</link>
                                </para>
                            </listitem>
                        </unorderedlist>
                    </listitem>
                    <listitem>
                        <para>
                            <italic>Manually Specified Area</italic> - The home view fills
                            the plot window with a rectangular portion of the plot defined
                            by two points that you specify. Enter the coordinates of two points
                            that define opposite corners of this rectangle. Select the coordinate
                            system used to specify these points. You have two choices.
                        </para>
                        <unorderedlist>
                            <listitem>
                                <para>
                                    The <link target='#NMPlot_PrimaryGrid_id'>primary grid</link>'s
                                    <link target='#NMPlot_GridCoordinateSystem_id'>coordinate system</link>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    Longitude and latitude, specified in decimal degrees east and
                                    north. Note that west longitudes are negative
                                </para>
                            </listitem>
                        </unorderedlist>
                    </listitem>
                </unorderedlist>
            </listitem>
        </orderedlist>
    </section>
    <section id='NMPlot_PlotOrientation_id'>
        <title>
            Plot Orientation
        </title>
        <para>
            Following mapping conventions, plots are typically displayed with
            north at the top. However, NMPlot allows you to display plots
            at any orientation. To set the orientation of a plot, follow these
            steps.
        </para>
        <orderedlist>
            <listitem>
                <para>
                    Display the Orientation page of the <link
                    target='#NMPlot_PlotOptionsDialogBox_id'>Plot Options dialog box</link>.
                </para>
                <exhibit>
                    <img src='NMPlot_PlotOptions_Orientation.png'/>
                </exhibit>
            </listitem>
            <listitem>
                <para>
                    Select the direction of north. If you select <italic>At an angle
                    of</italic>, type the direction of north, in degrees clockwise
                    from the top of the plot.
                </para>
            </listitem>
        </orderedlist>
        <para>
            The <link target='#WCGISxWCF_NorthArrowGlyph_id'>north indicator</link>
            at the bottom of the dialog box page displays the direction of
            north that you have selected.
        </para>
        <note type='note'>
            <para>
                If you set a plot's orientation so that the direction of north
                is not towards the top of the plot, <link
                target='#WCGIS_MapFormat_GeoreferencedBitmap_id'>georeferenced
                bitmap background maps</link> will not be displayed. NMPlot does
                not currently support the rotating of bitmap background maps.
            </para>
        </note>
    </section>
    <section id='NMPlot_MouseToolDisplayProperties_id'>
        <title>
            The Display Properties Mouse Tool
        </title>
        <para>
            Use the Display Properties tool to display information about objects
            in a plot. Activate the tool by pressing its button <img
            src='intres:WCPICxWCF_DisplayPropertiesTool_ToolbarButton'/> on
            the toolbar. Click on an object in a plot to display the Properties
            of Selected Object dialog box, which shows information about the
            object.
        </para>
        <exhibit>
            <img src='NMPlot_ScreenCap_DisplayProperties.png'/>
        </exhibit>
        <para>
            To copy the information to the clipboard, press the Copy to Clipboard
            button. To copy only a portion of the text, select it (by dragging
            over it with the mouse) before pressing the button.
        </para>
        <note type='tip'>
            <para>
                If you click upon a contour, NMPlot displays the area inside the
                contour. You can change the units used to display the area: see
                <iref target='WCPUxWCF_ApplicationOptions_PhysicalUnits_id'/>.
            </para>
        </note>
        <note type='note'>
            <para>
                NMPlot cannot display information about objects in <link
                target='#WCGIS_MapBackground_Layers_id'>background layers</link>.
            </para>
        </note>
    </section>
    <section id='NMPlot_MouseToolMeasurement_id'>
        <title>
            The Measurement Mouse Tool
        </title>
        <para>
            Use the Measurement tool to measure the distance and angle between
            two points on a plot. Activate the tool by pressing its button
            <img src='intres: NMPlot_MeasureTool_ToolbarButton'/> on the toolbar.
            To measure the distance between two points, press and hold the
            left mouse button over the first point, then move the mouse to
            the second point. The <link
            target='#WCF_ApplicationMainStatusBar_id'> status bar</link> displays
            the coordinates of the two points, the distance between them,
            and the directional heading from the first point to the second.
        </para>
        <exhibit>
            <img src='NMPlot_ScreenCap_StatusBar_MeasureTool.png'/>
        </exhibit>
        <para>
            You can change the coordinate system used to display the location
            of the two points: see <iref
            target='NMPlot_ApplicationOptions_MouseLocationDisplayCoordinates_id'/>.
        </para>
        <para>
            You can change the units used to display the distance between
            the two points: see <iref
            target='WCPUxWCF_ApplicationOptions_PhysicalUnits_id'/>.
        </para>
        <para>
            The heading is the direction of the second point as seen from
            the first point, measured in degrees east of true north.
        </para>
    </section>
    <section id='NMPlot_MouseToolPointOfInterestComputation_id'>
        <title>
            The Point Of Interest Computation Mouse Tool
        </title>
        <para>
            Use the Point of Interest Computation tool to perform a detailed
            analysis of the conditions at a specific location on a plot. In
            order to use this tool, the plot's <link
            target='#NMPlot_PrimaryGrid_id'>primary grid</link> must have
            been created by using BaseOps to run one or more third-party numerical
            model(s) supported by a <link
            target='#NMPlot_ApplicationOptions_ClientSpecificExtensions_id'>
            client-specific extension</link> to NMPlot. Point of Interest
            extensions have been developed for the following models.
        </para>
        <unorderedlist>
            <listitem>
                <para>
                    <link
                    target='#NMPlot_ApplicationOptions_ClientSpecificExtensions_Noisemap_id'>NOISEMAP
                    aircraft noise model suite</link>
                </para>
            </listitem>
        </unorderedlist>
        <para>
            To use the Point of Interest Computation tool, follow these steps.
        </para>
        <orderedlist>
            <listitem>
                <para>
                    Activate the tool by pressing its button <img
                    src='intres:NMPlot_Extension_NOISEMAP_PointOfInterestTool_ToolbarButton'/>
                    on the toolbar.
                </para>
            </listitem>
            <listitem>
                <para>
                    Using the left mouse button, click on a plot at the location where
                    you want to perform the point of interest analysis.
                </para>
            </listitem>
            <!-- <listitem>
                <para>
                    A client-specific dialog box may appear, asking you for additional
                    information. Enter the requested information, then press the OK
                    button. See <iref
                    target='NMPlot_ApplicationOptions_ClientSpecificExtensions_id'/>
                    for more information.
                </para>
            </listitem> -->
            <listitem>
                <para>
                    NMPlot runs the appropriate third-party numerical model(s), instructing
                    them to perform a detailed point of interest analysis at the indicated
                    location.
                </para>
            </listitem>
            <listitem>
                <para>
                    The results of the analysis are displayed in the New Point of
                    Interest dialog box.
                </para>
            </listitem>
            <listitem>
                <para>
                    The results of the analysis are added to the plot's <link
                    target='#NMPlot_PrimaryGrid_id'>primary grid</link> as a point
                    <link target='#NMPlot_GridGeographicAnnotations_id'>geographic
                    annotation</link>. When you close the plot, you are given a chance
                    to save the modified primary grid in a file.
                </para>
            </listitem>
        </orderedlist>
        <para>
            See <iref
            target='NMPlot_ApplicationOptions_ClientSpecificExtensions_id'/>
            for more information about client-specific extensions to NMPlot.
            See <iref
            target='NMPlot_ApplicationOptions_ClientSpecificExtensions_Noisemap_id'/>
            for more information about the NOISEMAP client-specific extensions.
        </para>
    </section>
    <section id='NMPlot_MouseToolGridComputation_id'>
        <title>
            The Grid Computation Mouse Tool
        </title>
        <para>
            Use the Grid Computation tool to increase the resolution of a
            grid by merging additional data points into it. In order to use
            this tool, the plot's <link target='#NMPlot_PrimaryGrid_id'>primary
            grid</link> must have been created by using BaseOps to run one
            or more third-party numerical model(s) supported by a <link
            target='#NMPlot_ApplicationOptions_ClientSpecificExtensions_id'>
            client-specific extension</link> to NMPlot. Grid Computation extensions
            have been developed for the following models.
        </para>
        <unorderedlist>
            <listitem>
                <para>
                    <link
                    target='#NMPlot_ApplicationOptions_ClientSpecificExtensions_Noisemap_id'>NOISEMAP
                    aircraft noise model suite</link>
                </para>
            </listitem>
        </unorderedlist>
        <para>
            To use the Grid Computation tool, follow these steps.
        </para>
        <orderedlist>
            <listitem>
                <para>
                    Activate the tool by pressing its button <img
                    src='intres:NMPlot_Extension_NOISEMAP_GridTool_ToolbarButton'/>
                    on the toolbar.
                </para>
            </listitem>
            <listitem>
                <para>
                    Using the left mouse button, drag a rectangular area on a plot
                    where you want to increase the resolution of the plot's <link
                    target='#NMPlot_PrimaryGrid_id'>primary grid</link> . That is,
                    move the mouse to one corner of the rectangular area, press and
                    hold the left mouse button, move the mouse to the opposite corner
                    of the rectangular area, and release the mouse button.
                </para>
            </listitem>
            <!--  <listitem>
                <para>
                    A client-specific dialog box may appear, asking you for additional
                    information. Enter the requested information, then press the OK
                    button. See <iref
                    target='NMPlot_ApplicationOptions_ClientSpecificExtensions_id'/>
                    for more information.
                </para>
            </listitem> -->
            <listitem>
                <para>
                    The Run New Grid dialog box appears.
                </para>
                <exhibit>
                    <img src='NMPlot_ScreenCap_RunNewGrid.png'/>
                </exhibit>
                <para>
                    Type the resolution of the data points (i.e., the distance between
                    adjacent data points) you want to merge into the primary grid.
                </para>
            </listitem>
            <listitem>
                <para>
                    Press the OK button. NMPlot runs the appropriate third-party numerical
                    model, instructing it to create a new grid with data points distributed
                    on a two-dimensional rectangular grid of locations. The area covered
                    by this new grid will be the rectangular area that you specified
                    using the mouse. The distance between adjacent data points will
                    be the resolution you specified in the Run New Grid dialog box.
                </para>
                <para>
                    The new grid is automatically <link
                    target='#NMPlot_MergingGrids_id'>merged</link> into the primary
                    grid, and the plot is updated.
                </para>
            </listitem>
            <listitem>
                <para>
                    When you close the plot, you are given a chance to save the modified
                    primary grid in a file.
                </para>
            </listitem>
        </orderedlist>
        <para>
            See <iref
            target='NMPlot_ApplicationOptions_ClientSpecificExtensions_id'/>
            for more information about client-specific extensions to NMPlot.
            See <iref
            target='NMPlot_ApplicationOptions_ClientSpecificExtensions_Noisemap_id'/>
            for more information about the NOISEMAP client-specific extensions.
        </para>
        <note type='tip'>
            <para>
                Use the Grid Computation tool to increase a grid's resolution
                in areas where a contour plot of the grid appears ragged, or where
                the contours break up into unconnected islands. This will often
                improve the appearance of the contours.
            </para>
        </note>
    </section>
</section>
