#########################################################################################

#########################################################################################
                 FF File Meteor Capture for 8 Cameras - Driver 

#########################################################################################

#########################################################################################

#########################################################################################

#########################################################################################



  FF_Capture8AndDetect can be run by double clicking on the executable, batch file command line.



     IMPORTANT NOTE:  This program is interfaced specifically to the Sensoray 812 board


  Clicking on the FF_Capture8... executable icon will go into interactive mode where 

     the user enters the parameter configuration file for the frame grabber Sensoray 

     812 unit, the archive flag to do detection and where to put candidate detection

     FF file set, the first camera number of 8 sequentially numbered cameras, the

     number of child detection processes to be spawned, the duration of the capture in 

     hours, and the drive letter/folder under which a CAMS directory and subdirectories 
     are created or already exist.S


     There are several options for the duration with early exit if the disk availability

     is limited and the maximum number of FF files has been reached. If the duration is 

     greater than zero, the capture starts immediately and stops after the designated 

     "duration" time in hours has elapsed. If the duration entered is zero, the user is

     prompted to manually start and stop the capture process. The capture will end 

     automatically if the max number of FF files is reached or 24 hours has elapsed.


     If the duration entered is negative, the program computes the period of time 

     when the sun is more than the absolute value of the duration (entered now in 

     degrees) below the local horizon. The program will wait in an idling loop until

     the sun dips low enough to the user designated angle and then starts capturing. It

     will run continuously until the user angle limit before dawn, OR the maximum 

     number of FF files is written. 


     IMPORTANT NOTE - The CameraSites.txt file will need to be in the ...\CAMS\Cal\ 

     folder and populated with the info for all eight cameras starting with the user 

     specified camera number, so that the program knows the latitude and longitude of 

     the camera's site for sun angle calculations.

     


  Various options for the command line entries:


  Executable_name  config_filename  archive_flag  camera_number  #detect_processes  duration_in_hours  drive_letter/folder:


  FF_Capture16AndDetect                             User prompted for config, archive, 1st camera num, process count, duration, main data directory

  FF_Capture16AndDetect  Sensoray812_config.txt           User prompted for archive, 1st camera num, process count, duration, main data directory

  FF_Capture16AndDetect  Sensoray812_config.txt  1          User prompted for 1st camera num, process count, duration, main data directory

  FF_Capture16AndDetect  Sensoray812_config.txt  1  23        User prompted for process count, duration, main data directory

  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  4       User prompted for duration, main data directory, 4 detection processes to be run

  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  4  0.0     User prompted for manual capture start and stop, main data directory

  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  0  9.5     User prompted for main data directory and runs for 9.5 hours, no detection processing

  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  4 -6.0     User prompted for main data directory and runs while sun is 6 deg below horizon

  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  4  7.2  D:   No user prompts and runs for 7.2 hours starting immediately, puts data in D:\CAMS\...

  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  4 -8.0  D:   No user prompts and runs while sun is 8 deg below horizon, puts data in D:\CAMS\...


  A folder is created for saving the FF files based on the date/UTtime at the start

  of the executable. The higher level directory is always user specified and the \CAMS\CapturedFiles\ 

  is appended along with the start date and time. For example, cameras 101-116 whose process starts on 

  Jan 5, 2011 3:11:05 UT and the directory specified was D:\Test would have FF*.bin files  

  placed into the folder D:\Test\CAMS\CapturedFiles\2001_01_05_03_11_05\ for cameras 101 through 116 inclusive.


  The code also looks for a Calibration directory as ...\CAMS\Cal\. So for the example the

  calibration folder is expected to be D:\Test\CAMS\Cal. If not found then the user is 

  prompted for the folder.