
====================  Advanced HSI Example README  ===========================

This advanced HSI example runs 2D or 3D HSI using an advanced technique which get the 
YMR measurements either directly from the connected sensor as a live connection mode or from 
a stored YMR file as a post process mode and uses a configuration file with predefined
HSI/Sensor configuration parameters, which are listed in the main HSI README file.  

HSI Example Syntax:

Syntax of commands for running this example are given below.
Input parameters listed in parentheses () are optional.

To run the HSI in 'live' mode with a connected sensor:
        ./advhsi.exe -L(S) COMPORT BAUDRATE CONFIG_FILENAME (OUTPUT_FILENAME) (YMR_FILENAME)
To run the HSI in 'post' mode with a logged YMR data-file:
        ./advhsi.exe -P(S) YMR_FILENAME CONFIG_FILENAME  (OUTPUT_FILENAME)

Option 'S': Sequential solve.  Computes HSI solution after every measurement added to kept-measurement buffer.

Examples:	

	The following example will run the HSI sequentially in live connection mode with the sensor connected to 
	comPort 25 with a baudRate 115200. It reads	the config. file and stores both the output results and the 
	YMR data to the specified file names.
	
		./advhsi.exe -LS /dev/ttyS24 115200 data/example3Dlive.config  data/output.dat data/YMRdata.dat


	The following example will run the HSI sequentially in post processing mode for a 3D YMR data. 
	It reads the 3D configuration file and stores the output results to the specified file name.
	
		./advhsi.exe -ps data/example3D.dat data/example3D.config data/example3D.out
		
	The following example will run the HSI in post processing mode for a 2D YMR data using a 2D configuration file. 
	It will only print the results to the screen and will not store the results.
	
		 ./advhsi -p data/example2D.dat data/example2D.config
		 
		 
		 
