Difference between revisions of "Config:ContextConfig"

From SUMOwiki
Jump to navigationJump to search
m
(AutoConfig for SUMO 6.2)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
'''Generated for SUMO toolbox version 7.0'''.
 +
''We are well aware that documentation is not always complete and possibly even out of date in some cases. We try to document everything as best we can but much is limited by available time and manpower.  We are an university research group after all. The most up to date documentation can always be found (if not here) in the default.xml configuration file and, of course, in the source files.  If something is unclear please dont hesitate to [[Reporting problems|ask]].''
 
== ContextConfig ==
 
== ContextConfig ==
 
=== OutputDirectory ===
 
=== OutputDirectory ===
 +
Specifies the directory to use to store the results, logs, ... An absolute path can be specified, if not it is relative to the project directory.
 +
<source xmlns:saxon="http://icl.com/saxon" lang="xml">
  
<source lang="xml">
+
<!--Specifies the directory to use to store the results, logs, ... An absolute path can be specified, if not it is relative to the project directory.-->
<Option key="saveModels" value="true"/>
+
  <[[Config:OutputDirectory|OutputDirectory]]>output</[[Config:OutputDirectory|OutputDirectory]]></source>
</source>
 
 
=== PlotOptions ===
 
=== PlotOptions ===
save model to disk as Matlab .mat file
+
Several options for configuring the intermediate plots can be found here
<source lang="xml">
+
<source xmlns:saxon="http://icl.com/saxon" lang="xml">
<[[Config:PlotOptions|PlotOptions]]>
+
 
  <Option key="plotModels" value="true"/>
+
<!--Several options for configuring the intermediate plots can be found here-->
  <Option key="withContour" value="true"/>
+
  <[[Config:PlotOptions|PlotOptions]]>
  <Option key="plotContour" value="false"/>
+
 
  <Option key="saveModelPlots" value="true"/>
+
      <!-- save model to disk as Matlab .mat file -->
  <Option key="outputType" value="png"/>
+
      <Option key="saveModels" value="true"/>
</[[Config:PlotOptions|PlotOptions]]>
+
 
</source>
+
      <!-- plot models model plots to disk -->
=== Path ===
+
      <Option key="plotModels" value="true"/>
Empty by default, but a user can add directories to the path as he wishes.
+
 
<source lang="xml">
+
      <!-- contours are  only available for 2 dimensions -->
<[[Config:Path|Path]]></[[Config:Path|Path]]>
+
     
</source>
+
      <!-- also show the contour lines underneath a surface plot -->
 +
      <Option key="withContour" value="true"/>
 +
      <!-- use a contour plot instead of a surface plot -->
 +
      <Option key="plotContour" value="false"/>
 +
      <!-- also plot the model uncertainty, only supported by some models types -->
 +
      <Option key="plotUncertainty" value="false"/>
 +
 
 +
      <!--
 +
      Other options to customize plotting:
 +
     
 +
      <Option key="plotPoints" value="true"/>
 +
      <Option key="lighting" value="false"/>
 +
      <Option key="slices" value="3"/>
 +
      <Option key="grayScale" value="false"/>
 +
      <Option key="meshSize" value="41"/>
 +
      <Option key="fontSize" value="14"/>
 +
      <Option key="logScale" value="false"/>
 +
      -->
 +
 
 +
      <!-- Output file format of the plot: png (default),eps,bmp,jpg,... -->
 +
      <Option key="outputType" value="png"/>
 +
  </[[Config:PlotOptions|PlotOptions]]></source>
 +
=== Custom Options ===
 +
Available options:
 +
<source xmlns:saxon="http://icl.com/saxon" lang="xml">
 +
 
 +
<!--Keep models from previous model iterations. See: http://www.sumowiki.intec.ugent.be/index.php/FAQ#I_sometimes_see_the_error_of_the_best_model_go_up.2C_shouldn.27t_it_decrease_monotonically.3F-->
 +
  <Option key="keepOldModels" value="off"/>
 +
<!--If set to on the parallelMode option will check if the Matlab Parallel Computing Toolbox is installed. If so, model construction will occur in parallel where possible, thus speeding things up. Note that this option is still somewhat experimental. If you get weird problems switch it off again.-->
 +
  <Option key="parallelMode" value="off"/></source>
 
=== Profiling ===
 
=== Profiling ===
Within a profiler block, one or more &lt;Output type="type"/&gt; specifiers should be present. Possible types are toFile, toPanel, Docked, and toImage. When using the toPanel, Docked, and toImage output specifiers, an extra `chartType' option can be used. See the types present in the Docked view to see which types are available.
+
Configuration options for the profilers. Profilers allow you to track the modeling process and understand what happens. Within a profiler block, one or more &lt;Output type="type"/&gt; specifiers should be present. Possible types are toFile, toPanel, toTable, and toImage.
<source lang="xml">
+
<source xmlns:saxon="http://icl.com/saxon" lang="xml">
<[[Config:Profiling|Profiling]]>
+
 
  <[[Config:Profiler|Profiler]] name="LevelPlotProfiler.*" enabled="false">
+
<!--Configuration options for the profilers. Profilers allow you to track the modeling process and understand what happens. Within a profiler block, one or more <[[Config:Output|Output]] type="[[Output#type|type]]"/> specifiers should be present. Possible types are toFile, toPanel, toTable, and toImage.-->
      <[[Config:Output|Output]] type="Docked">
+
  <[[Config:Profiling|Profiling]]>
        <Option key="chartType" value="level"/>
+
      <!--
      </[[Config:Output|Output]]>
+
       You can restrict the available profilers to use by specifying a wildcard to disable the docked output if you dont want a window containing all the profilers.
      <[[Config:Output|Output]] type="toImage">
+
       To select all profilers, simply put ".*"
        <Option key="chartType" value="level"/>
+
      -->
       </[[Config:Output|Output]]>
+
      <[[Config:Profiler|Profiler]] name=".*SampleMinimum.*|.*Measure.*|.*BestModel.*|.*ElapsedTime.*|.*MemoryUse.*" enabled="true">
       <[[Config:Output|Output]] type="toFile"/>
+
        <!-- note that the toImage/toPanel handlers are quite expensive to use, removing them will speed things up -->
  </[[Config:Profiler|Profiler]]>
+
        <[[Config:Output|Output]] type="[[Output#toPanel|toPanel]]"/>
  <[[Config:Profiler|Profiler]] name=".*Measure.*|.*BestModel.*|.*ElapsedTime.*|.*Resources.*" enabled="true">
+
        <[[Config:Output|Output]] type="[[Output#toImage|toImage]]"/>
      <[[Config:Output|Output]] type="Docked"/>
+
        <[[Config:Output|Output]] type="[[Output#toTable|toTable]]"/>
      <[[Config:Output|Output]] type="toImage"/>
+
        <[[Config:Output|Output]] type="[[Output#toFile|toFile]]"/>
      <[[Config:Output|Output]] type="toFile"/>
+
      </[[Config:Profiler|Profiler]]>    
  </[[Config:Profiler|Profiler]]>
+
  </[[Config:Profiling|Profiling]]></source>
</[[Config:Profiling|Profiling]]>
 
</source>
 

Latest revision as of 12:36, 25 March 2010

Generated for SUMO toolbox version 7.0. We are well aware that documentation is not always complete and possibly even out of date in some cases. We try to document everything as best we can but much is limited by available time and manpower. We are an university research group after all. The most up to date documentation can always be found (if not here) in the default.xml configuration file and, of course, in the source files. If something is unclear please dont hesitate to ask.

ContextConfig

OutputDirectory

Specifies the directory to use to store the results, logs, ... An absolute path can be specified, if not it is relative to the project directory.

<!--Specifies the directory to use to store the results, logs, ... An absolute path can be specified, if not it is relative to the project directory.-->
   <[[Config:OutputDirectory|OutputDirectory]]>output</[[Config:OutputDirectory|OutputDirectory]]>

PlotOptions

Several options for configuring the intermediate plots can be found here

<!--Several options for configuring the intermediate plots can be found here-->
   <[[Config:PlotOptions|PlotOptions]]>

      <!-- save model to disk as Matlab .mat file -->
      <Option key="saveModels" value="true"/>

      <!-- plot models model plots to disk -->
      <Option key="plotModels" value="true"/>

      <!-- contours are  only available for 2 dimensions -->
      
      <!-- also show the contour lines underneath a surface plot -->
      <Option key="withContour" value="true"/>
      <!-- use a contour plot instead of a surface plot -->
      <Option key="plotContour" value="false"/>
      <!-- also plot the model uncertainty, only supported by some models types -->
      <Option key="plotUncertainty" value="false"/>

      <!--
      Other options to customize plotting:
      
      <Option key="plotPoints" value="true"/>
      <Option key="lighting" value="false"/>
      <Option key="slices" value="3"/>
      <Option key="grayScale" value="false"/>
      <Option key="meshSize" value="41"/>
      <Option key="fontSize" value="14"/>
      <Option key="logScale" value="false"/>
      -->

      <!-- Output file format of the plot: png (default),eps,bmp,jpg,... -->
      <Option key="outputType" value="png"/>
   </[[Config:PlotOptions|PlotOptions]]>

Custom Options

Available options:

<!--Keep models from previous model iterations. See: http://www.sumowiki.intec.ugent.be/index.php/FAQ#I_sometimes_see_the_error_of_the_best_model_go_up.2C_shouldn.27t_it_decrease_monotonically.3F-->
   <Option key="keepOldModels" value="off"/>
<!--If set to on the parallelMode option will check if the Matlab Parallel Computing Toolbox is installed. If so, model construction will occur in parallel where possible, thus speeding things up. Note that this option is still somewhat experimental. If you get weird problems switch it off again.-->
   <Option key="parallelMode" value="off"/>

Profiling

Configuration options for the profilers. Profilers allow you to track the modeling process and understand what happens. Within a profiler block, one or more <Output type="type"/> specifiers should be present. Possible types are toFile, toPanel, toTable, and toImage.

<!--Configuration options for the profilers. Profilers allow you to track the modeling process and understand what happens. Within a profiler block, one or more <[[Config:Output|Output]] type="[[Output#type|type]]"/> specifiers should be present. Possible types are toFile, toPanel, toTable, and toImage.-->
   <[[Config:Profiling|Profiling]]>
      <!--
      You can restrict the available profilers to use by specifying a wildcard to disable the docked output if you dont want a window containing all the profilers.
      To select all profilers, simply put ".*"
      -->
      <[[Config:Profiler|Profiler]] name=".*SampleMinimum.*|.*Measure.*|.*BestModel.*|.*ElapsedTime.*|.*MemoryUse.*" enabled="true">
         <!-- note that the toImage/toPanel handlers are quite expensive to use, removing them will speed things up -->
         <[[Config:Output|Output]] type="[[Output#toPanel|toPanel]]"/>
         <[[Config:Output|Output]] type="[[Output#toImage|toImage]]"/>
         <[[Config:Output|Output]] type="[[Output#toTable|toTable]]"/>
         <[[Config:Output|Output]] type="[[Output#toFile|toFile]]"/>
      </[[Config:Profiler|Profiler]]>      
   </[[Config:Profiling|Profiling]]>