Difference between revisions of "VT 2"

From DIDEAS Wiki
Jump to: navigation, search
m (ucmd : send user commands to instrument)
m
Line 6: Line 6:
  
 
=Additions=
 
=Additions=
 +
  
 
==Config File==
 
==Config File==
Line 12: Line 13:
 
*selected : any variable listed in this section will be automatically selected when the config file is read.
 
*selected : any variable listed in this section will be automatically selected when the config file is read.
 
*axis_limits : a list of key=value pairs where the key is the variable name and the value is a 2 element vector that specifies that minimum and maximum y-axis.  Variables listed in this section are also selected by default.
 
*axis_limits : a list of key=value pairs where the key is the variable name and the value is a 2 element vector that specifies that minimum and maximum y-axis.  Variables listed in this section are also selected by default.
 +
  
  
Line 32: Line 34:
  
 
Note : the section names should be lower case, however case of the variables is ignored.
 
Note : the section names should be lower case, however case of the variables is ignored.
 +
 +
Support for grouping variables is forthcoming.
  
 
==ucmd : send user commands to instrument==
 
==ucmd : send user commands to instrument==
Line 45: Line 49:
 
   If an output argument is present, upon success returns 0
 
   If an output argument is present, upon success returns 0
 
   on error returns a negative value
 
   on error returns a negative value
 +
 +
 +
=Other changes / fixed issues=
 +
*Default buffer size is 60,000 samples (per field)
 +
*added support for config file (config.txt) that axis limits to be specified and pre-selects variables.  Is read automatically and when CFG button pressed.
 +
*create Matlab convenience function ucmd.m to send user command.  See help ucmd
 +
*major rewrite/expansion of pre-gui testing of Matlab - python compatibility and python setup.  (check that bits match, directory is correct, etc)
 +
*correct use of default TCP port (10000) when not specified.
 +
*update help contents for many of the Matlab files/functions
 +
*fixed crash on data_accumulator wrap
 +
*remove unused files / non-source files from repo

Revision as of 16:32, 16 April 2015

Previous release Documentation (VT1)

Preliminary documentation for VT_2, the Visualization Tool revision $Id: gui_3.m 66 2015-04-16 13:22:51Z brainfog $


Additions

Config File

The file config.txt is read at startup and can be re-read during VT operation by press the 'CFG' button. The config file format is that of an 'INI file' [1]. There are two sections from this file that are processed.

  • selected : any variable listed in this section will be automatically selected when the config file is read.
  • axis_limits : a list of key=value pairs where the key is the variable name and the value is a 2 element vector that specifies that minimum and maximum y-axis. Variables listed in this section are also selected by default.



[selected]
# these variables are selected 
Valve_in_td
Valve_in_ad
Valve_in_hs1

[axis_limits]
# specify axis limits and select the variables
Valve_in_pd=[-51,40]
Valve_in_fd=[2,5]
Valve_in_vd=[1,10];

Note : the section names should be lower case, however case of the variables is ignored.

Support for grouping variables is forthcoming.

ucmd : send user commands to instrument

 Convenience function to send commands to instrument using the global 'mc'
 object and its method send_user_command_string()
 
 example:
 ucmd('data_interval 1');
 ucmd('help');


 If an output argument is present, upon success returns 0
 on error returns a negative value


Other changes / fixed issues

  • Default buffer size is 60,000 samples (per field)
  • added support for config file (config.txt) that axis limits to be specified and pre-selects variables. Is read automatically and when CFG button pressed.
  • create Matlab convenience function ucmd.m to send user command. See help ucmd
  • major rewrite/expansion of pre-gui testing of Matlab - python compatibility and python setup. (check that bits match, directory is correct, etc)
  • correct use of default TCP port (10000) when not specified.
  • update help contents for many of the Matlab files/functions
  • fixed crash on data_accumulator wrap
  • remove unused files / non-source files from repo