==========================================================
Acknowledgements:

Many thanks to Steve Moshier for allowing his work to be modified
and re-issued to perform a specific task.

See http://www.moshier.net for this prolific authors work.

This program is based upon a modifed version of Steves aa-54.zip.
His current version is aa-55.zip (can never keep up! :)

===========================================================

olistgen Version 0.2 Alpha Release 02/15/2002

DOS Command prompt executable.

All rights granted to host this file, or re-distribute as desired as long as
as this README_mosaic.txt is propogated unmodified.

I have every intention to distribute the source code under the GPL after the beta tries
are completed.


Gene Nolan

==========================================================

Note: To use this program requires the cygwin1.dll available free for download.

See: http://sources.redhat.com/cygwin/ for more info on Cygwin.

Download  ftp://mirrors.rcn.net/mirrors/sources.redhat.com/cygwin/latest/bootstrap.zip for
a cygwin1.dll contained therein and place it in the same directory you unzipped this
distribution to.

==========================================================

New: Mosaic generator added 02/15/2002

The feature of generating telescope movements for capturing a mosaic
with Astrovideo has been added.

To use this feature a new 'ini' file has been added named 
mosaic.ini.

The program uses the same 'candidate' file format as before

=========================================================
File mosaic.ini is composed of:

6.0	amount to shift in RA in MINUTES of ARC (NOT TIME!)
6.0	amount to shift in DEC in minutes of arc
1	number of shifts to perform in each direction in RA
1	number of shifts to perform in each direction in DEC

The program calculates a box based upon the number of shifts required.
e.g. a 1 , 1 shift builds a box

     -1, 1	0,1	1,1
     -1, 0      0,0     1,0
     -1, -1     0,-1    1,-1


Calculations are done so the scope is commanded to move in the follwoing order

	1    4    7
        2    5    8
        3    6    9


e.g. a 2, 3 shift builds a box

       -2,  3       -1,  3       0,  3       1,  3      2,  3
       -2,  2       -1,  2       0,  2       1,  2      2,  2
       -2,  1       -1,  1       0,  1       1,  1      2,  1
       -2,  0       -1,  0       0,  0       1,  0      2,  0
       -2, -1       -1, -1       0, -1       1, -1      2, -1
       -2, -2       -1, -2       0, -2       1, -2      2, -2
       -2, -3       -1, -3       0, -3       1, -3      2, -3


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


Below are explanations of the files contained in the distribution relating
to mosaic generation.

Please pay careful attention to input files of that you generate.
There is LITTLE IF ANY ERROR checking in the program.


Sample 'run params' file tell the prog about your location,
the date and time of interest, the approximate time for an exposure cycle,
the max number of lines to process in the candidate file, the type of objects
to work on ('111' to generate a mosaic), and the file name of the object description.

See the file 'inputm.txt' in the distribution.

NOTE: COMMENTS ARE NOT ALLOWED IN THE FILE, THE FOLLOWING is for instructional value.
===================================
1998			;epoch year (1997/1998 for my lx200)
1			 ;month of observing run
22			 ;day
20			 ;hour (LST)
0			 ;minute
0 			;seconds
0.001389		 ;approx time between slews(days) 0.001389 = 2minutes
10000			 ;max number of  'candidate' entries
111			 ; Steve Moshier program type '88' for obslist, type 111 for mosaic
mosaic.txt		 ; Name of file containing the candiate objects


===================================================================
Sample line from file= "mosaic.txt" in distribution.
The column descriptions ARE NOT part of the file. Every line in the
file MUST contain 13 entries except for the end of input marker.

Name String  Type2     RA           Dec      Const  Mag     Size    String
M42   XX      S     5 35 17   -5  23  23     ORI    4.0     90x60     XX
----------------------------
----------------------------

Note:  For mosaic generation, the only fields that are used are:
	Name
	RA
	DEC
	Type2:  MUST BE EQUAL to 'S'
	All other fields are ignored but MUST be present!

Note: VERY IMPORTANT: the two lines with '-----------------' signify the end of
      input to the program!!!! If they are not included, it will seem to hang, then after a while
      ask more questions!!! (The required questions are all answered in the 'input.txt' file).

==================================================================
Sample setup file for Astrovideo = 'camera.ini' in the distribution.
Any valid Astrovideo command can be put in here.
NOTE: The prog currently places a 'closecommport:" at
the end of the output.

Note: If you interrupt Astrovideo from executing the full script, it keeps the
comm port open, so in order to re-execute the script, you must first exit Astrovideo and
re-run it to close the comm port.

opencommport:1
setframesperimage:1
settotalimages:1
setcolour:
enableextended:
setfinaletime:200
setpostexposuretime:10
nosaveimages:
setdirectory:c:\newpics

========================================================
The file='exposurem.ini' in the distribution.
Copy this file to exposure.ini.
eExposure.ini will be written in-toto 
to the output for each iteration of the mosaic.


waitfor: 4000	 	;let the scope finish the slew
startcapture:
save16fit:

=================================================
The criteria file = 'limits.ini' in the distribution

Not used for mosaic generation


================================================
Sample output for a mosaic:

See the file='sampleoutm.txt' in the distribution.


================================================
To define your location in the world, the file='aa.ini' in the distribution is used,
edit the file to match.

-75.17 ;Terrestrial east longitude of observer, degrees
40.17  ;Geodetic latitude, degrees
0.0    ;Height above sea level, meters
12.0   ;Atmospheric temperature, deg C
1010.0 ;Atmospheric pressure, millibars
1      ; 0 - TDT=UT, 1 - input=TDT, 2 - input=UT
-18000.0    ;Use this deltaT (sec) if nonzero, else compute it. -18000 seconds
            ; equals -5 hours from GMT


==================================
Caveats:

The beginiing of the output contains a series of informational and debug messages,
YOU MUST DELETE these from the output BEFORE feeding to Astrovideo.

==================================
Running the program:

Unzip all to a directory.
Download and place the cygwin1.dll vession 1.3.6 from: 
  ftp://mirrors.rcn.net/mirrors/sources.redhat.com/cygwin/latest/bootstrap.zip
  into the same directory.

Edit the file 'aa.ini' to match your location in the world.

Open a command prompt window
execute the program with the distribution defaults to try it first time:

Copy the file exposurem.ini to exposure.ini

.\olistgen <inputm.txt >firsttimem.txt

Compare the result file 'firsttimem.txt' with the file 'sampleoutm.txt' contained in the distribution.

