View source for GMS:Plot Wizard

{{Infobox Calibration}}
Plots are useful for many purposes, such as extracting data from two or three dimensional objects and model verification. Plots are created through the ''Plot Wizard''.

==Plot Wizard Steps==
The Plot Wizard (''Display'' | '''Plot Wizard''') is used to create 2D plots.  The plot wizard is composed of two steps described below.  In addition, the types of plots that can be created are described and illustrated below.

===Step 1===

In the first step, the plot type is selected. The types include:

:* Computed vs. Observed Data
:* Computed vs. Observed Data (Weighted)
:* Residual vs. Observed Data
:* Residual vs. Observed Data (Weighted)
:* Parameter Sensitivities
:* Error vs. Simulation
:* Error vs. Time Step
:* Error Summary
:* Time Series
:* Active Dataset Time Series Plot
:* S/S Flow vs. Time
:* Flow Budget vs. Time
:* Gage Package Value vs. Time

A sample and explanation are displayed for each plot type. The '''Next >''' button is undimmed if the necessary data for the selected plot type exists in the current project.  If the '''Next >''' button is disabled, a help text explaining the problem is displayed below the ''Plot Type'' box.

===Step 2===
In the second step, the attributes of each plot are set. The attributes associated with each plot type are explained below and can be located quickly by clicking on the desired plot type listed above.  The options depend on the plot type and will be described below.

===== Computed vs. Observed =====
:A Computed vs. Observed plot is used to display how well the entire set of observed values match a model solution.  A 45<sup>o</sup> line is drawn on this plot,  which represents a perfect correspondence between observed data and solution values. One symbol is drawn for each observation point at the intersection of the observed and computed values for the point. This plot can show the trend of the solution values with regard to matching the [[GMS:Observations#Point Observations|observed data]]. Only those points whose value is specified as observed for the selected data type will be shown in the plot. These plots are created in the ''Plot Wizard'' by setting the ''Plot Type'' to "Computed vs. Observed". A sample plot is shown in the figure.

[[Image:comp_v_obs_plot.gif|frame|center|300px]]

===== Computed vs. Observed Plot Options =====
:The second step contains the following options.

:''Coverage and Measurements''
::The observation coverage and measurements can be selected for each plot.  If only one observation coverage and measurement exist these are used by default.

:''Use current solution'' 
::This option causes the plot to compare the observed values with the values of the current solution and time step for each observation point. When the active solution changes, the plot is recomputed and updated. If only one solution is in memory then this option is defaulted.

:''Use selected solutions''
::This option causes the plot to compare the observed values with the values of the specified solution for each observation point. Changing the active solution does not affect the plot.

:''Use time step'' 
::Because the plot shows only values from a specific time step, The Active Times Step is used by default.

===== Computed vs. Observed (Weighted) =====
:A Computed vs. Observed Weighted plot is used to display how well the entire set of weighted observed values match a model solution. These weights are set by selecting the [[GMS:Observations#Observations Dialog|'''Observation''']] item in the ''MODFLOW'' menu.  A 45<sup>o</sup> line is drawn on this plot,  which represents a perfect correspondence between observed data and solution values.  One symbol is drawn for each observation point at the intersection of the weighted observed and computed values for the point. This plot can show the trend of the solution values with regard to matching the weighted observed data. Only those points whose value is specified as observed for the selected data type will be shown in the plot. This plot is not available with transient data. These plots are created in the ''Plot Wizard'' by setting the ''Plot Type'' to "Computed vs. Observed (Weighted)". A sample plot is shown in the figure.

[[Image:comp_v_obs_wt_plot.gif|frame|center|300px]]

===== Computed vs. Observed Weighted Plot Options =====
:After the plot type is set in the First Page of the ''Plot Wizard'', the '''Next''' button is clicked to open the ''Computed vs. Observed Weighted Plot Options'' wizard page. This page contains the following:

:''Coverage and Measurements''
::The observation coverage and measurements can be selected for each plot.  If only one observation coverage and measurement exist these are used by default.

:''Use current solution''
::This option causes the plot to compare the weighted observed values with the values of the current solution and time step for each observation point. When the active solution changes, the plot is recomputed and updated. If only one solution is in memory then this option is defaulted.

:''Use selected solutions''
::This option causes the plot to compare the weighted observed values with the values of the specified solution for each observation point. Changing the active solution does not affect the plot.

:''Use time step''
::Because the plot shows only values from a specific time step, The Active Times Step is used by default.

===== Residual vs. Observed =====
:A Residual vs. Observed plot is used to display how well the entire set of observed values match a model solution. On this plot is drawn a horizontal line along an error of zero, representing what would be a perfect correspondence between observed data and solution values. Then, one symbol is drawn for each observation point at the intersection of the observed and residual (computed-observed) values for the point. This plot can show the trend of the solution values with regards to matching the [[GMS:Observations#Point Observations|observed data]]. Only those points whose value is specified as observed for the selected data type will be shown in the plot. These plots are created in the ''Plot Wizard'' by setting the ''Plot Type'' to "Residual vs. Observed". A sample plot is shown in the figure.

[[Image:res_v_obs_plot.gif|frame|center|300px]]

===== Residual vs. Observed Plot Options =====
:After the plot type is set in the First Page of the Plot Wizard, the '''Next''' button is clicked to open the Residual vs. Observed Plot Options wizard page. This page contains the following:

:''Coverage and Measurements''
::The observation coverage and measurements can be selected for each plot.  If only one observation coverage and measurement exist these are used by default.

:''Use current solution''
::This option causes the plot to compare the observed values with the residual values of the current solution and time step for each observation point. When the active solution changes, the plot is recomputed and updated. If only one solution is in memory then this option is defaulted.

:''Use selected solutions''
::This option causes the plot to compare the observed values with the residual values of the specified solution for each observation point. Changing the active solution does not affect the plot.

:''Use time step''
::Because the plot shows only values from a specific time step, The Active Times Step is used by default.

===== Residual vs. Observed (Weighted) =====
:A Residual vs. Observed (Weighted) plot is used to display how well the entire set of weighted observed values match a model solution. On this plot is drawn a horizontal line along an error of zero, representing what would be a perfect correspondence between weighted observed data and solution values. One symbol is drawn for each observation point at the intersection of the weighted observed and residual (computed-observed) values for the point. This plot can show the trend of the solution values with regards to matching the [[GMS:Observations#Point Observations|weighted observed data]]. Only those points whose value is specified as observed for the selected data type will be shown in the plot.  This plot is not available with transient data. These plots are created in the ''Plot Wizard'' by setting the ''Plot Type'' to "Residual vs. Observed (Weighted)". A sample plot is shown in the figure.

[[Image:res_v_obs_wt_plot.gif|frame|center|300px]]

===== Residual vs. Observed Weighted Plot Options =====
:After the plot type is set in the First Page of the ''Plot Wizard'', the '''Next''' button is clicked to open the ''Residual vs. Observed (Weighted)  Plot Options'' wizard page. This page contains the following:

:''Coverage and Measurements''
::The observation coverage and measurements can be selected for each plot.  If only one observation coverage and measurement exist these are used by default.

:''Use current solution''
::This option causes the plot to compare the weighted observed values with the residual values of the current solution and time step for each observation point. When the active solution changes, the plot is recomputed and updated. If only one solution is in memory then this option is defaulted.

:''Use selected solutions''
::This option causes the plot to compare the weighted observed values with the residual values of the specified solution for each observation point. Changing the active solution does not affect the plot.

:''Use time step''
::Because the plot shows only values from a specific time step, The Active Times Step is used by default.

===== Parameter Sensitivity =====
:A Parameter Sensitivity plot is used to display the sensitivity of the MODFLOW parameters. These plots are created in the ''Plot Wizard'' by setting the ''Plot Type'' to "Paramater Sensitivity". A sample plot is shown in the figure.

[[Image:par_sen_plot.gif|frame|center|300px]]

===== Parameter Sensitivity Plot Options =====
:After the plot type is set in the First Page of the ''Plot Wizard'', the '''Next''' button is clicked to open the ''Parameter Sensitivity Plot Options'' wizard page. This page contains the following:

:''Parameter Type''
::This option changes the parameter type displayed.

:''Use current solution''
::This option causes the plot to compare Parameter Sensitivities of the current solution. When the active solution changes, the plot is recomputed and updated. If only one solution is in memory then this option is defaulted.

:''Use selected solutions''
::This option causes the plot to compare Parameter Sensitivities of the specified solution. Changing the active solution does not affect the plot.

===== Error vs. Simulation =====
:An Error vs. Simulation plot is generally used with steady-state simulations and measurement types.  It may be used in transient simulations. This plot can display the mean error, mean absolute error, and root mean squared error  between successive solutions and [[GMS:Observations#Point Observations|observed data]]. Various simulations would be run after changing model parameters, such as hydraulic conductivity or recharge. The plot will show trends in the solution to see if model parameter changes are causing better calibration with measured field data. Error vs. Simulation plots are created in the ''Plot Wizard'' by setting the ''Plot Type'' to "Error vs. Simulation". A sample plot is shown in the figure.

[[Image:error_v_sim_plot.gif|frame|center|300px]]

===== Error vs. Simulation Plot Options =====

:After the plot type is set in the First Page of the ''Plot Wizard'', the '''Next''' button is clicked to open the ''Error vs. Simulation Plot Options ''wizard page. This page contains the following:

:''Solutions'' 
::This lists all available solutions.

:''Move Up/Move Down''
::GMS initially shows the solutions in the order they were opened. However, this is not necessarily the order in which they were run. To change the order, highlight a solution and move it up or down to rearrange their order. 

:''Observed''
::This lists all available measurement types that were set up in the ''Observation Coverage Options'' dialog, both constant and transient. This plot is generally performed using constant solutions and measurement types, although transient data is allowed. You should select in the combo box the measurement type that you are comparing.

:''Check Box Options''
::There are three options that can be turned on or off. They determine whether the mean error, mean absolute error, and root mean squared error plots should be shown. Because these values are an average of all observation points, their line and symbol styles are not linked to any one observation point, but can be defined by clicking on the appropriate canvas window in the dialog.

===== Error vs. Time Step =====
:An Error vs. Time Step plot is used with transient simulations to display the mean error, mean absolute error, and root mean squared error between a solution and observed data as a function of time. This plot applies to a single Dataset in a model solution.  Transient measurement types will show the average errors at each time step of the dataset. Error vs. Time Step plots are created in the ''Plot Wizard'' by setting the ''Plot Type' to "Error vs. Time Step". A sample plot is shown in the figure.
:Beginning with version 8.0, this plot can no longer be used with MODFLOW.

[[Image:error_v_time_plot.gif|frame|center|300px]]

===== Error vs. Time Step Plot Options =====

:After the plot type is set in the First Page of the Plot Wizard, the '''Next''' button is clicked to open the Error vs. Time Step Plot Options wizard page. This page contains the following:

:''Use current solution''
::This option causes the plot to compare Parameter Sensitivities of the current solution. When the active solution changes, the plot is recomputed and updated. If only one solution is in memory then this option is defaulted.

:''Use selected solutions''
::This option causes the plot to compare Parameter Sensitivities of the specified solution. Changing the active solution does not affect the plot.

:''Observed''
::This lists all available measurement types that were set up in the ''Observation Coverage Options'' dialog, both constant and transient. A constant measurement should be used for solutions with only one time step, while a transient measurement should be used for transient solutions. You should select the measurement type in the combo box that you are comparing.  If only one exists then it is used by default.

:''Check Box Options''
::There are three options that can be turned on or off. They determine whether the mean error, mean absolute error, and root mean squared error plots should be shown. Because these values are an average of all observation points, their line and symbol styles are not linked to any one observation point, but can be defined by clicking on the appropriate canvas window in the dialog.

===== Error Summary =====
:See the [[GMS:Error Summary Plot|Error Summary Plot]] page for more details. An Error Summary plot is used to display the mean error, mean absolute error, and root mean squared error for a Solution.  Error Summary plots are created in the Plot Wizard by setting the Plot Type to Error Summary. A sample plot is shown in the figure.
:Beginning with version 8.0, this plot can no longer be used with MODFLOW. This information can be found by right-clicking on the MODFLOW solution in the Project Explorer.

[[Image:err_summary_plot.gif|frame|center|300px]]

===== Error Summary Plot Options =====
:After the plot type is set in the First Page of the Plot Wizard, the '''Next''' button is clicked to open the Error Summary Plot Options wizard page. This page contains the following:

:''Use active solution''
::This option causes the plot to show a summary of mean error between the set of observed values with the values of the active solution for each observation point. When the active solution changes, the plot is recomputed and updated. This option is always on by default at this time

:''All time steps''
::This option shows the mean error for all time steps instead of only at the current or specified time step value.

:''Observed''
::This section shows the available list of observed values that were set up in the ''Observation Coverage Options'' dialog. Both constant and transient observed values should be available in this dialog.

===== Time Series =====
:A Time Series plot is used to display the time variation of one or more scalar Datasets associated to a given point inside a model solution. In addition, if transient calibration data has been defined, a band can be shown which represents a time variant [[GMS:Calibration Targets|Calibration Target]]. Only transient datasets may be used in these plots. Time Series plots are created in the Plot Wizard by setting the Plot Type to Time Series. A sample plot is shown in the figure.
:Beginning with version 8.0, these plots have been changed to show observation targets instead of a "band" around the observed data.

[[Image:time_series_plot.gif|frame|center|300px]]

===== Time Series Plot Options =====
:After the plot type is set in the First Page of the Plot Wizard, the Next button is clicked to open the Time Series Plot Options wizard page. This page contains the following:

:''Coverage and Measurements''
::The observation coverage and measurements can be selected for each plot.  If only one observation coverage and measurement exist these are used by default. All Measurements can also be selected to plot all of the different measurements on one plot.

:''Use current solution''
::This option causes the plot to display the values of the active Solution for each observation point being plotted. When the active solution changes, the plot is recomputed and updated. If only one solution is in memory then this option is defaulted.

:''Use selected solutions''
::This option causes the plot to display the values of one or more specified Solutions for each point being plotted.  Changing the active solution does not affect the plot.

:''Selected Points''
::Each of the observation points are shown in a spreadsheet. The show toggle determines which Observation Points will be displayed in a Time Series Plot in the Plot Window. This way, only certain points are plotted in each individual time series plot. All the points can either be turned on or off by selecting the corresponding buttons below the spreadsheet.

:''Calibration Target''
::Turn this on to display a band in the plot to define the valid calibration range. If this is turned off, only the calibration curve will be drawn.

:''Time interval''
::A starting time and an ending time of observations can be specified by two combo boxes. Only the interval chosen will be shown on the time series plot. 

===== Active Dataset Time Series =====
:A Time Series plot is used to display the time variation of one or more scalar Datasets associated to a given point selected in a model solution. Time Series plots are created in the Plot Wizard by setting the Plot Type to Active Dataset Time Series. A sample plot is shown in the figure.

[[Image:active_data_time_series_plot.gif|frame|center|300px]]

===== Active Dataset Time Series Plot Options =====
:After the plot type is set in the First Page of the Plot Wizard, the '''Finish''' button is clicked to create the active time series plot.  For 2D and 3D grids select a grid cell and for 2D and 3D meshes select a node to display the scalar values of the dataset at that location over time.  You can select up to five locations to be plotted on one plot.

===== S/S Flow vs. Time =====
:A Flow vs. Time plot is used to display the flow or water over time for a selected feature object or grid cell. Flow vs. Time plots are created in the Plot Wizard by setting the Plot Type to Flow vs. Time. A sample plot is shown in the figure.

===== S/S Flow vs. Time Plot Options =====
:After the plot type is set in the First Page of the Plot Wizard, the '''Finish''' button is clicked to create the flow vs time plot. This plot will report the flow either by selecting a feature object defined as a MODFLOW source/sink in the map module or by selecting a group of cells in the 3D Grid.  To change the plot options for the Flow vs Time Plot right-click on the plot and select the '''''Plot Data''''' command.  The ''Plot Data'' dialog contains the following:

:''Feature Objects flow''
::This option allows you to select what data to plot when a Source/Sink feature object is selected in the Map module. By default the computed flow is plotted. If observed values exist for the feature object than those values can also be plotted along with calibration target ranges.

:''Grid Cell Flow''
::This option allows you to select what Source/Sink flows to be plotted when Grid Cells are selected in the 3D grid module. The options are: Storage, Constant Head, Drains, General Heads, Rivers, Streams, Recharge, Evapotranspiration, and Total Source/Sink flow in and out of the cells.

===== Flow Budget  vs. Time =====
:A Flow Budget vs. Time plot is used to display the flow or water over time for selected grid cell or for [[GMS:Zone Budget|zone budget ids]]. Flow Budget vs. Time plots are created in the Plot Wizard by setting the Plot Type to Flow Budget vs. Time. A sample plot is shown in the figure.

[[Image:flowbudgetplot.gif|frame|center|300px]]

===== Flow Budget vs. Time Plot Options =====
:After the plot type is set in the First Page of the Plot Wizard, the '''Next''' button is clicked to open the Flow Budget Plot Options wizard page. The options on this page are discussed below. The '''Finish''' button is clicked to create the flow budget vs time plot. This plot will report the flow either by selecting a group of cells in the 3D Grid or by using the [[GMS:Zone Budget|zone budget ids]]. 

:''Display using''
::This option allows you to determined the data to plot. The Flow budget will be computed either from the selected 3D grid cells or from the selected [[GMS:Zone Budget|zone budget ids]] in the spreadsheet.

:''Grid Cell Flow''
::This option allows you to select what Source/Sink flows to be plotted. The options are: Storage, Constant Head, Drains, General Heads, Rivers, Streams, Recharge, Evapotranspiration, and Total Source/Sink flow in and out of the cells.

===== Gage Package Value vs. Time =====
:This plot shows a time series for a single gage package column. After the plot type is set in the First Page of the Plot Wizard, the Next button is clicked to open the Gage Package Time Series wizard page. To generate a gage plot the gage file needs to be selected from the list on the left, and the data column from the list on the right.  If GMS is unable to properly read the data from the gage file, an error is shown in the wizard page to the right of the data column list.

===== Finish =====
:When the Finish button is selected, a window is opened with the plot. Plot windows are created each time the Plot Wizard is run. See the 2D Plots discussion for information on editing plots that have been created.

== Right-Click Menu Commands ==
Once the plot has been created, the appearance and data of the plot can be altered with commands accessed by right-clicking on the plot window.  The commands available through the right-click menu are described below.

:'''''Plot Data''''' &ndash; The plot data command brings up the second step of the plot wizard where the attributes of each plot are set. The plot data can be updated based upon the type of plot.  For Histogram plots it brings up a dialog used to edit the precision displayed on the plot.

:'''''Display Options''''' &ndash; The Display Options command allows you to change general display attributes of the plot (Border Style, Precision, Axis type, Fonts, Colors, etc.).    

:'''''Axis Titles''''' &ndash; The axis titles menu is used to change the x and y axis titles.

:'''''Set As Display Defaults''''' &ndash; To save the plots current settings as the default settings, select the Save Settings menu item.

:'''''Legends''''' &ndash; The legend can be turned on by right clicking on the plot and selecting a location from the Legend submenu.  The maximum number of points included in the legend depends upon the size of the plot window.

:'''''Export/Print''''' &ndash; By selecting on the Export/Print menu item, a dialog is displayed showing options for printing or exporting the plots values.

:'''''Default Display''''' &ndash; To save the plots current settings as the default settings, select the Save Settings menu item.

:'''''View Values''''' &ndash; To view the values of the plot in a spreadsheet format, select the View Values menu.  A spreadsheet containing the data points associated with the current plot appear.

==See also==

*[[GMS:Display Options|Display Options]]
*[[GMS:Model Calibration|Model Calibration]]


{{Navbox GMS}}
[[Category:Calibration]]
[[Category:GMS Dialogs|P]]