Model Visualization GUI - Revision history

Icouckuy: /* Actions */

2008-11-10T15:56:37Z

Actions

← Older revision		Revision as of 15:56, 10 November 2008
Line 81:		Line 81:
	* Quickly start an optimization of the current model in Matlab's optimization toolbox.		* Quickly start an optimization of the current model in Matlab's optimization toolbox.
	* Take a look at the distribution of training samples across the input dimensions. The sample distribution window shows a scatter plot of the training sample distribution for each pair of input dimensions and box plots for every input dimension separately.		* Take a look at the distribution of training samples across the input dimensions. The sample distribution window shows a scatter plot of the training sample distribution for each pair of input dimensions and box plots for every input dimension separately.
			* QQPlot: Draws a Quantile-Quantile plot, comes in two flavours:
			** Sample values versus predicted values
			** Sample values versus cross-validated predictions
	* View a [[Slice Plot]] of the current model, retaining all compatible customizations. Most importantly, bounds, labels and lighting options are taken from the console. This [[Slice Plot]] can be useful for getting an overall idea of what the model looks like. The number of slices shown can be changed through the [[#Command line options1\|command line options]].		* View a [[Slice Plot]] of the current model, retaining all compatible customizations. Most importantly, bounds, labels and lighting options are taken from the console. This [[Slice Plot]] can be useful for getting an overall idea of what the model looks like. The number of slices shown can be changed through the [[#Command line options1\|command line options]].
	* Reset all controls to their default values.		* Reset all controls to their default values.

Digipham: /* Creating a movie */ added another example movie

2008-07-18T13:11:10Z

Creating a movie: added another example movie

← Older revision		Revision as of 13:11, 18 July 2008
Line 116:		Line 116:
	=== Examples ===		=== Examples ===

	Here you can take a look at some movies created with the Create Movie GUI. The first ~~one is~~ compressed with Matlab's default AVI codec on Windows, Indeo5. The other examples are presented as QuickTime movies.		Here you can take a look at some movies created with the Create Movie GUI. The first and last ones are compressed with Matlab's default AVI codec on Windows, Indeo5. The other examples are presented as QuickTime movies.

	* The [[Media:ThreeDim1.avi\|first ~~example~~ movie]] ~~is created from~~ a surface plot that uses lighting and does not show any sample points. The movie has a high framerate and slice count to ensure a smooth transition between frames.		* The [[Media:ThreeDim1.avi\|first movie]] shows a surface plot that uses lighting and does not show any sample points. The movie has a high framerate and slice count to ensure a smooth transition between frames.
	* The [[Media:TwoDim1.mov\|second ~~example~~ movie]] illustrates the effect of scaling and filtering sample points in a plot that shows only 1 input dimension. You can see the sample points appear, enlarge, shrink and disappear again as the slice value changes. The largest sample points are the closest to the current slice.		* The [[Media:TwoDim1.mov\|second movie]] illustrates the effect of scaling and filtering sample points in a plot that shows only 1 input dimension. You can see the sample points appear, enlarge, shrink and disappear again as the slice value changes. The largest sample points are the closest to the current slice.
	* The [[Media:ThreeDim2.mov\|third ~~example~~]] is again a surface plot, but now without lighting and a lower framerate. It also shows sample points as seen in the second example.		* The [[Media:ThreeDim2.mov\|third movie]] is again a surface plot, but now without lighting and a lower framerate. It also shows sample points as seen in the second example.
			* The [[Media:Contour1.avi\|last movie]] shows a contour plot with scaled and filtered sample points.

	=== Getting started ===		=== Getting started ===

Digipham: /* Creating a movie */ added another example movie

2008-07-18T10:32:54Z

Creating a movie: added another example movie

← Older revision		Revision as of 10:32, 18 July 2008
Line 118:		Line 118:
	Here you can take a look at some movies created with the Create Movie GUI. The first one is compressed with Matlab's default AVI codec on Windows, Indeo5. The other examples are presented as QuickTime movies.		Here you can take a look at some movies created with the Create Movie GUI. The first one is compressed with Matlab's default AVI codec on Windows, Indeo5. The other examples are presented as QuickTime movies.

	The [[Media:ThreeDim1.avi\|first example movie]] is created from a surface plot that uses lighting and does not show any sample points. The movie has a high framerate and slice count to ensure a smooth transition between frames.		* The [[Media:ThreeDim1.avi\|first example movie]] is created from a surface plot that uses lighting and does not show any sample points. The movie has a high framerate and slice count to ensure a smooth transition between frames.
			* The [[Media:TwoDim1.mov\|second example movie]] illustrates the effect of scaling and filtering sample points in a plot that shows only 1 input dimension. You can see the sample points appear, enlarge, shrink and disappear again as the slice value changes. The largest sample points are the closest to the current slice.
	The [[Media:TwoDim1.mov\|second example movie]] illustrates the effect of scaling and filtering sample points in a plot that shows only 1 input dimension. You can see the sample points appear, enlarge, shrink and disappear again as the slice value changes. The largest sample points are the closest to the current slice.		* The [[Media:ThreeDim2.mov\|third example]] is again a surface plot, but now without lighting and a lower framerate. It also shows sample points as seen in the second example.

	=== Getting started ===		=== Getting started ===

Digipham: /* Creating a movie */ added another example movie

2008-07-11T10:41:36Z

Creating a movie: added another example movie

← Older revision		Revision as of 10:41, 11 July 2008
Line 116:		Line 116:
	=== Examples ===		=== Examples ===

	Here you can take a look at some movies created with the Create Movie GUI.		Here you can take a look at some movies created with the Create Movie GUI. The first one is compressed with Matlab's default AVI codec on Windows, Indeo5. The other examples are presented as QuickTime movies.

	The [[Media:ThreeDim1.avi\|first example movie]] is created from a surface plot that uses lighting and does not show any sample points. The movie has a high framerate and slice count to ensure a smooth transition between frames.		The [[Media:ThreeDim1.avi\|first example movie]] is created from a surface plot that uses lighting and does not show any sample points. The movie has a high framerate and slice count to ensure a smooth transition between frames.

			The [[Media:TwoDim1.mov\|second example movie]] illustrates the effect of scaling and filtering sample points in a plot that shows only 1 input dimension. You can see the sample points appear, enlarge, shrink and disappear again as the slice value changes. The largest sample points are the closest to the current slice.

	=== Getting started ===		=== Getting started ===

Digipham: /* Creating a movie */ added a movie example

2008-07-08T22:42:43Z

Creating a movie: added a movie example

← Older revision		Revision as of 22:42, 8 July 2008
Line 112:		Line 112:
	== Creating a movie ==		== Creating a movie ==

	The '''Create Movie GUI''' allows you to bring your model to life by varying over (a part of) the domain of a single input parameter. That way, you get an overview of its influence on the model's output. You can create a ~~fluid~~ movie by generating many slices and setting a high frame rate. With a lower frame rate you can create a more explicit succession of slices.		The '''Create Movie GUI''' allows you to bring your model to life by varying over (a part of) the domain of a single input parameter. That way, you get an overview of its influence on the model's output. You can create a smooth movie by generating many slices and setting a high frame rate. With a lower frame rate you can create a more explicit succession of slices.

	=== Examples ===		=== Examples ===

	Here you can take a look at some movies created with the Create Movie GUI. ~~<!-- TODO -->~~		Here you can take a look at some movies created with the Create Movie GUI.

			The [[Media:ThreeDim1.avi\|first example movie]] is created from a surface plot that uses lighting and does not show any sample points. The movie has a high framerate and slice count to ensure a smooth transition between frames.

	=== Getting started ===		=== Getting started ===

Digipham: /* Visualizing a model */ added examples

2008-06-29T22:30:31Z

Visualizing a model: added examples

← Older revision		Revision as of 22:30, 29 June 2008
Line 6:		Line 6:

	== Visualizing a model ==		== Visualizing a model ==

	The main component of the Model Visualization GUI is the '''Visualization Console''', a console for interactively browsing a model's input and output domain. You can search and study areas of interest, find interesting relations between input parameters and study their effects on the model's outputs. The GUI allows you to create fully customized screenshots, which can be used in presentations, on your website or elsewhere.		The main component of the Model Visualization GUI is the '''Visualization Console''', a console for interactively browsing a model's input and output domain. You can search and study areas of interest, find interesting relations between input parameters and study their effects on the model's outputs. The GUI allows you to create fully customized screenshots, which can be used in presentations, on your website or elsewhere.

	=== Examples ===		=== Examples ===
			[[Image:TwoDim1.png\|thumb\|400px\|1D plot with scaled sample points]]
			[[Image:TwoDim2.png\|thumb\|400px\|1D plot with scaled sample points]]
			[[Image:ThreeDim1.png\|thumb\|400px\|2D plot with lighting, contour lines and unscaled sample points]]
			[[Image:ThreeDim2.png\|thumb\|400px\|2D plot with scaled sample points and contour lines]]
			[[Image:ThreeDim3.png\|thumb\|400px\|2D plot with scaled sample points and contour lines]]
			[[Image:Contour1.png\|thumb\|400px\|Contour plot with scaled sample points]]

	~~Let us first~~ take a look at screenshots of some plots created using the Model ~~visualization~~ GUI. ~~<!-- TODO -->~~		On the right, you can take a look at screenshots of some plots created using the Model Visualization GUI. All plot types are presented. Click on an images to enlarge it.

	=== Getting started ===		=== Getting started ===

Digipham: /* Viewing model information */ minor improvements

2008-06-28T10:57:19Z

Viewing model information: minor improvements

Show changes

Digipham: /* Creating a movie */ small improvements

2008-06-28T10:11:32Z

Creating a movie: small improvements

Digipham: many readability improvements

2008-06-27T15:53:38Z

many readability improvements

Show changes

Digipham: /* Viewing model information */ about ignoring infinite relative errors

2008-06-27T13:26:54Z

Viewing model information: about ignoring infinite relative errors

← Older revision		Revision as of 10:11, 28 June 2008
Line 115:		Line 115:
	=== Getting started ===		=== Getting started ===

	You can access the Create Movie GUI from the [[#Visualizing a model\|Visualization Console]], using the ''Create movie'' button at the bottom or in the [[#Actions1\|Actions]] menu. All customizations applied in the console will be used for the movie. The Create Movie GUI can also be accessed from [[#Command line options2\|command line]]. You won't be able to use any other Matlab GUI component while using the Create Movie GUI. E.g. if you want to further customize the plot in the Visualization Console, press cancel in the Create Movie GUI to return to it.		You can access the Create Movie GUI from the [[#Visualizing a model\|Visualization Console]], using the ''Create movie'' button at the bottom or in the [[#Actions1\|Actions]] menu. All customizations applied in the console will be used for the movie. The Create Movie GUI can also be accessed from [[#Command line options2\|command line]]. You won't be able to use any other Matlab GUI component while using the Create Movie GUI. E.g. if you want to further customize the plot with the Visualization Console, press cancel in the Create Movie GUI to return to it.

	The screenshot of the Create Movie GUI shown below, gives an overview of the available options.		The screenshot of the Create Movie GUI shown below, gives an overview of the available options.
Line 123:		Line 123:
	=== Movie controls ===		=== Movie controls ===

	* You can select which input to vary over time with the topmost popup box. All inputs that are not set to be plotted are available. The slices (frames) will be generated over the entire range of the selected input, as specified in the Visualization Console, command line input settings or model defaults. The first slice will have the value of the lower bound, the last one will be equal to the upper bound.		* You can select which input to vary over time with the topmost popup box. All inputs that are not set to be plotted are available. The slices (frames) will be generated over the entire range of the selected input, as specified in the Visualization Console, command line input settings or model defaults. The first slice will have the value of the lower bound; the last one's value will be equal to the upper bound.
	* On the second line you can see two checkboxes. The first one specifies if the output axis should be clipped to the maximum and minimum output values found in all slices. Keep this checkbox selected if you want to prevent that the axis scale changes during the movie, which causes irregular jumps in the ~~consecutive~~ plots. However, enabling this option also means creating the movie will take longer, because the correct bounds can only be known after all slices have been generated. The slices will be reloaded from disk and modified to the custom ~~output~~ bounds. To avoid this second pass ''and'' prevent the output axis scale from changing during the movie, you can enable output clipping in advance. Using the Visualization Console, you can explore the model to get an idea of a good set of bounds to use. Enable the '''Clip to'' checkbox found at the bottom left of the Visualization Console to clip the output.		* On the second line you can see two checkboxes. The first one specifies if the output axis should be clipped to the maximum and minimum output values found in all slices. Keep this checkbox selected if you want to prevent that the axis scale changes during the movie, which causes irregular jumps in the successive plots. However, enabling this option also means creating the movie will take longer, because the correct clipping bounds can only be known after all slices have been generated. The slices will be reloaded from disk and modified to the custom bounds. To avoid this second pass ''and'' prevent the output axis scale from changing during the movie, you can enable output clipping in advance. Using the Visualization Console, you can explore the model to get an idea of a good set of bounds to use. Enable the '''Clip to'' checkbox found at the bottom left of the Visualization Console to clip the output.
	* By default, the title of each slice plot in the movie ~~holds~~ the current slice value of the input varying over time. This option can be ~~controlled~~ with the '''Show slice in title''' checkbox.		* By default, the title of each slice plot in the movie shows the current slice value of the input varying over time. This option can be toggled with the '''Show slice in title''' checkbox.
	* Specify how many slices should be generated in the '''Slice count ''' field.		* Specify how many slices should be generated in the '''Slice count ''' field.
	* To the right of the slices field you can enter the number of frames per second to be shown in the movie. Fractions can be used, ~~e.g.~~ <code>0.2 fps</code> means each slice will be shown for five seconds. You can enter a number yourself or select one from the popup box.		* To the right of the slices field you can enter the number of frames per second to be shown in the movie. Fractions can be used. For example, <code>0.2 fps</code> means each slice will be shown for five seconds. You can enter a number yourself or select one from the popup box.
	* Movies are created using the default Matlab codec by default. On Linux platforms, this is an uncompressed AVI format. On other platforms, the default Matlab codec does support compression. ~~The~~ compression quality can be set using the popup/edit box to the right of the compression popup box. If you have the Java Media Framework installed and in ~~your~~ Matlab class path, you can also create QuickTime movies, but that codec does not allow you to specify a compression quality.		* Movies are created using the default Matlab codec by default. On Linux platforms, this is an uncompressed AVI format. On other platforms, the default Matlab codec does support compression. When compression is supported, the compression quality can be set using the popup/edit box to the right of the compression popup box. If you have the Java Media Framework installed and in Matlab's Java class path, you can also create QuickTime movies, but that codec does not allow you to specify a compression quality.
	* The '''Output file''' field shows the path to the file where the movie shall be created. You can enter a file path manually or use the browse button. The correct file extension for the selected codec is automatically appended to the file path.		* The '''Output file''' field shows the path to the file where the movie shall be created. You can enter a file path manually or use the browse button. The correct file extension for the selected codec is automatically appended to the file path.
	* At the bottom of the window 3 buttons ~~are located~~. The ~~first one~~ resets all fields in the window to their default value. The middle button starts the movie generation process. ~~The rightmost button closes~~ the window. Upon pressing the '''Create movie''' button, the current settings (except for the selected input dimension) are stored in memory, for the duration of ~~the~~ current Matlab session. The next time you open the Create Movie GUI, the saved settings will be restored. This is a handy feature if you want to create several movies using the same settings.		* At the bottom of the window there are 3 buttons. The button on the left resets all fields in the window to their default value. The button on the right closes the window. The middle button starts the movie generation process. During the generation process, the plot window will be made visible above all other Matlab windows. Some progress information will be printed at the Matlab command line.
			* Upon pressing the '''Create movie''' button, the current settings (except for the selected input dimension) are stored in memory, for the duration of your current Matlab session. The next time you open the Create Movie GUI, the saved settings will be restored. This is a handy feature if you want to create several movies using the same settings.

	=== Command line options ===		=== Command line options ===

	Instead of starting the Create Movie GUI through the Visualization Console, you can also start it directly from command line using the Matlab command <code>guiCreateMovie</code>. Without parameters, a ''load from file'' dialog will appear so you can select a model stored on disk. Below are the optional parameters to the command, in order of appearance:		Instead of starting the Create Movie GUI through the Visualization Console, you can also start it directly from command line using the Matlab command <code>guiCreateMovie</code>. Without parameters, a ''load from file'' dialog will appear so you can select a model stored on disk. Below are the optional parameters to the command, in order of appearance.
	# The first parameter is the model to be plotted in the figure window. If you already loaded the model in memory, or simply don't have it saved on disk, you can pass it as a parameter.		# The first parameter is the model to be plotted in the figure window. If you already loaded the model in memory, or simply don't have it saved on disk, you can pass it as a parameter.
	# The second parameter represents the index of the output to plot.		# The second parameter represents the index of the output to plot.
	# The third parameter is a structure containing input settings: bounds and values for each input and indices of the inputs to plot. The defaults can be retrieved using <code>settings = defaultInputSettings(model)</code>.		# The third parameter is a structure containing input settings: bounds and values for each input and indices of the inputs to plot. The defaults can be retrieved using <code>settings = defaultInputSettings(model)</code>.
	# A structure containing the plot customization options can be passed as the fourth parameter. Retrieve the defaults using <code>[dummy1 dummy2 options] = quickPlotModel</code>. You don't have to specify all fields when using this parameter. Fields that you don't provide will be set to their default value.		# A structure containing the plot customization options can be passed as the fourth parameter. Retrieve the defaults using <code>[dummy1 dummy2 options] = quickPlotModel</code>. You don't have to specify all fields when using this parameter. Fields that you don't provide will be set to their default value.
	# If you want to plot the slices of the movie in a specific figure ~~handle~~, pass ~~the~~ handle as the fifth parameter. Otherwise the current figure will be used.		# If you want to plot the slices of the movie in a specific figure window, pass its handle as the fifth parameter. Otherwise the current figure will be used.
	The first four parameters are in the same order as used to start the Visualization Console from command line. As with the Visualization Console, the command <code>help guiCreateMovie</code> will provide a brief description of the function and its parameters, in the correct order.		The first four parameters are in the same order as used to start the Visualization Console from command line. As with the Visualization Console, the command <code>help guiCreateMovie</code> will provide a brief description of the function and its parameters, in the correct order.

	=== Reusing the generated slices ===		=== Reusing the generated slices ===

	Next to the actual movie file, a subdirectory <code>slices</code> shall be created containing all slices used in the movie, in ''png'' format. If you enabled the '''Fix output axis''' option, every ''png'' ~~file will also have a corresponding Matlab figure~~. The slices subdirectory will be erased when starting a new movie generation process in the same directory.		Next to the actual movie file, a subdirectory <code>slices</code> shall be created containing all slices used in the movie, in ''png'' format. If you enabled the '''Fix output axis''' option, you will also find a Matlab figure file for every slice in that directory. The '''Fix output axis''' option is only applied to the ''png'' files. The slices subdirectory will be erased when starting a new movie generation process in the same directory.

	You might want to create several movies with different output formats or frame rates. This process can be speeded up by using the Matlab command <code>images2movie</code>. It allows you to create a movie from an existing directory of images. These are the parameters to the function:		You might want to create several movies from the same slices, but with different output formats or frame rates. This process can be speeded up by using the Matlab command <code>images2movie</code>. It allows you to create a movie from an existing directory of images. These are the parameters to the function:
	# path to the directory containing the images;		# path to the directory containing the images;
	# file path to the location where the movie should be saved (file extension defines the video codec);		# file path to the location where the movie should be saved (the file extension defines the video codec);
	# file extension of the images, in this case ''png'';		# file extension of the images, in this case ''png'';
	# number of frames per second;		# number of frames per second;

← Older revision		Revision as of 13:26, 27 June 2008
Line 158:		Line 158:
	== Viewing model information ==		== Viewing model information ==

	The '''Model Information GUI''' gives you a quick overview of a model. It shows error statistics, scores, description, dimensions and more. Some information fields are specific to the selected output, others are specific to the model only. You can select which output's information you want to see. Additionally, you can specify ~~a custom~~ validation set or function to compute error statistics. You can compare your ~~custom~~ statistics to the training error statistics.		The '''Model Information GUI''' gives you a quick overview of a model. It shows error statistics, scores, description, dimensions and more. Some information fields are specific to the selected output, others are specific to the model only. You can select which output's information you want to see. Additionally, you can specify an external validation set or function to compute error statistics. You can compare your customized statistics to the training error statistics.

	All information fields contain selectable text, so you can easily copy the information you want to the clipboard.		All information fields contain selectable text, so you can easily copy the information you want to the clipboard.
Line 179:		Line 179:

	* You can select which output's error statistics, error plots and expression must be shown using a popup box.		* You can select which output's error statistics, error plots and expression must be shown using a popup box.
	* External validation data can be selected from another popup box. All matrices of doubles and function handles in the workspace are listed. You must select a valid matrix or function handle. If the variable selected is invalid, an error message will be shown in a dialog box. Select the empty matrix, <code>[]</code>, to disable external validation. Validation data provided at [[#Command line options3\|command line]] is listed as <code>~~cmd~~ line</code>. See [[#Using external validation data]] for more information.		* External validation data can be selected from another popup box. All matrices of doubles and function handles in the workspace are listed. You must select a valid matrix or function handle. If the variable selected is invalid, an error message will be shown in a dialog box. Select the empty matrix, <code>[]</code>, to disable external validation. Validation data provided at [[#Command line options3\|command line]] is listed as <code>command line</code>. See [[#Using external validation data]] for more information.
	* When using a function handle for external validation, an evaluation grid will be constructed for you. The maximum number of points to use in the evaluation grid can be specified. The points will be linearly spaced along the model's input dimension ranges.		* When using a function handle for external validation, an evaluation grid will be constructed for you. The maximum number of points to use in the evaluation grid can be specified. The points will be linearly spaced along the model's input dimension ranges.
	* Finally, a checkbox allows you to use logarithmic scaling for the Y axis in the error plots.		* Finally, a checkbox allows you to use logarithmic scaling for the Y axis in the error plots.
Line 197:		Line 197:
	=== Error plots ===		=== Error plots ===

	A screenshot showing error plots for both training samples and using ~~a custom~~ validation matrix.		A screenshot showing error plots for both training samples and using an external validation matrix.

	[[Image:ModelInfoErrorPlots.png]]		[[Image:ModelInfoErrorPlots.png]]
Line 203:		Line 203:
	On the left side of the Model Information GUI, plots representing the error statistics for the currently selected output are presented. The top four plots represent the error in the training samples. If you have specified valid validation data, another four plots will be shown, representing the error using the validation data.		On the left side of the Model Information GUI, plots representing the error statistics for the currently selected output are presented. The top four plots represent the error in the training samples. If you have specified valid validation data, another four plots will be shown, representing the error using the validation data.

	Both absolute and relative errors are shown. The plots on the left show the absolute error, the plots on the right show the relative error. Two plot types are used for showing the errors: a plot showing the highest validation error against the number of points that remain below this error and a histogram.		Both absolute and relative errors are shown. The plots on the left show the absolute error, the plots on the right show the relative error. Two plot types are used for showing the errors: a plot showing the highest validation error against the number of points that remain below this error and a histogram. The relative error histograms don't include any samples with an infinite relative error, because they would cripple the entire histogram and render it useless.

	=== Information fields ===		=== Information fields ===
Line 215:		Line 215:
	* A general model description is presented in the Description field.		* A general model description is presented in the Description field.

	* The middle fields contain error statistics for the current output. At the left the statistics measured against the training data are shown. The right field shows statistics for the ~~custom~~ validation set or function you can specify. If no ~~custom~~ validation data is set, this field will be empty. <!-- TODO explanation of shorthand MSE... -->		* The middle fields contain error statistics for the current output. At the left the statistics measured against the training data are shown. The right field shows statistics for the external validation set or function you can specify. If no external validation data is set, this field will be empty. <!-- TODO explanation of shorthand MSE... -->

	* The field at the bottom left contains the list of scores used while generating the model, for every output. Next to it you can see the expression used inside the model for calculating the value of the current output. This expression can become quite large for difficult models, so you will have to use the scroll bar attached to the field for seeing it completely.		* The field at the bottom left contains the list of scores used while generating the model, for every output. Next to it you can see the expression used inside the model for calculating the value of the current output. This expression can become quite large for difficult models, so you will have to use the scroll bar attached to the field for seeing it completely.
Line 227:		Line 227:
	# The model whose information you want to view. If you already loaded the model in memory, or simply don't have it saved on disk, you can pass it as a parameter.		# The model whose information you want to view. If you already loaded the model in memory, or simply don't have it saved on disk, you can pass it as a parameter.
	# The second parameter is the index of the output of which output specific information must be shown.		# The second parameter is the index of the output of which output specific information must be shown.
	# You can pass validation data directly as the third command line parameter. You can always return to the validation data specified at command line by selecting <code>~~cmd~~ line</code> in the validation popup box. See [[#Using external validation data]] for more information.		# You can pass validation data directly as the third command line parameter. You can always return to the validation data specified at command line by selecting <code>command line</code> in the validation popup box. See [[#Using external validation data]] for more information.
	# Specify the path to the file containing the model to be able to reload it, even when you passed it as a command line parameter. Leave this parameter empty if you don't have a file containing the model on disk.		# Specify the path to the file containing the model to be able to reload it, even when you passed it as a command line parameter. Leave this parameter empty if you don't have a file containing the model on disk.
	# The last parameter is a small options structure. The defaults can be retrieved using <code>[dummy options] = guiPlotModelErrors</code>. You don't have to specify all fields when using this parameter. Fields that you don't provide will be set to their default value.		# The last parameter is a small options structure. The defaults can be retrieved using <code>[dummy options] = guiPlotModelErrors</code>. You don't have to specify all fields when using this parameter. Fields that you don't provide will be set to their default value.
	The first two parameters are in the same order as used to start the Visualization Console from command line. ~~As with the Visualization Console, the~~ command <code>help guiModelInfo</code> will provide a brief description of the function and its parameters, in the correct order.		The first two parameters are in the same order as used to start the Visualization Console from command line. The command <code>help guiModelInfo</code> will provide a brief description of the function and its parameters, in the correct order.

	== Loading a model from disk ==		== Loading a model from disk ==

	The GUI comes with an easy to use command for loading a model from disk into the Matlab workspace: <code>guiLoadModel</code>. It provides the ''load from file'' dialogs for the three GUI components explained above, but you can also use it separately. You can specify a starting path for the dialog as an optional parameter. The function returns the loaded model as the first return parameter, and the name of the file containing the model as the second return parameter. Run <code>help guiLoadModel</code> to get a short description of the function and its parameters at command line.		The GUI comes with an easy to use command for loading a model from disk into the Matlab workspace: <code>guiLoadModel</code>. It provides the ''load from file'' dialogs for the three GUI components explained above, but you can also use it separately. You can specify a starting path for the dialog as an optional parameter. The function returns the loaded model as the first return parameter, and the name of the file containing the model as the second return parameter. Run <code>help guiLoadModel</code> to get a short description of the function and its parameters at command line.