
Date: Thu, 22 Feb 2001 12:10:49 +0100 (MET)
From: Stefan Larsson <stefan@astro.su.se>
Subject: parameters
To: peter.kretschmar@obs.unige.ch, allan@dsri.dk, njw@dsri.dk, smaisala@astro.helsinki.fi, oxborrow@dsri.dk
Cc: stefan@des.astro.su.se
MIME-Version: 1.0
Content-MD5: CSGu5kZQQiwQwThOF/dogQ==

Look an AI response! (Late? yes, but just a little).

------------------------------------------------------------------------------		
V2_rev1.6       SL      15/2/01 Circulate email of suggestions for new input
OPEN                    parameters for binning executables. Everyone else to
                        read and comment on emails
------------------------------------------------------------------------------		

Here is an overview of my suggested time specification parameters for
the case of source extracted spectra.

When you have contemplated all of it, I would like your help to
"straighten out" the ?-marks on data formats. OBTime-format can
not be read through par-files as far as I understand(?). 
When defining timeZero some months ago we did not specify its format.

If timeZero & timeEnd are given as par-file reals
(in seconds) with respect to the start of the Science Window 
(OBTSTART in JMX1-FULL-PRP and JMX1-REST-PRP) can that create
problems? My executables only work on one SW but what about Peter
and NJW who also use timeZero (or anyone else)?

timeStep is fine becouse its value is small and I (or actually Peter)
set it to be read as double real and then transformed to OBTime.
So, can I do the same for timeZero & timeEnd?

Stefan


1)  timeZeroSet, timeZero	As before, starting time of first bin.

2)  timeEndSet, timeEnd		Similar to timeZero, but end point
				(no data used after this point!)

3)  timeStepSet, timeStep	timeStep now also has a Set-parameter.
				(Default: timeStep = integration time
						     for spectra).

4)  nPhaseBins, phaseBins	Only used for cyclic folding in phase bins
				of unequal length.
				
				
1) is as before. 2) is just a generalization of 1)
3) Is used to get time resolved or phase folded spectra.
4) Is used to specify phase folding bin of unequal sizes. (Implemented later).

------------------------------------------------------------------------------		
				

*  timeZeroSet  int *           Output  If 0 (false) dont read timeZero,
*                                       set timeZero = beginning of SW.
*                                       Otherwise (true) read timeZero. 
*  timeZero     ?	        Output  Time at beginning of (first) spectrum
*  timeEndSet   int *           Output  If 0 (false) dont read timeEnd,
*                                       set timeEnd = end of SW.
*                                       Otherwise (true) read timeEnd. 
*  timeEnd      ? 	                Output  End time for data extraction.
*  timeStepSet  int *           Output  If < 0: Only one spectrum per source.
*                                       If =  0: Store sequential spectra one
*                                       per timeStep.
*                                       If > 0: Bin data periodicly folded in
*                                       time, in this number of phase bins.
*					If nPhaseBins=0 they are assumed to
*					be of equal length.
*					If nPhaseBins > 0 the bin lengths
*					are read from phaseBins.
*  timeStep     ? 	        Output  If timeStepSet<0: This parameter is
*					ignored and timeStep is
*					set to the length of data.                                     
*                                       If timeStepSet=0: Store one spectrum
*                                       per source for each timeStep 
*                                       (seconds).
*                                       If timeStepSet>0: timeStep is the
*                                       period by which all data is folded
*                                       into phase bins. 
*  nPhaseBins	int *		Output	Number of "phaseBins" values.
*  phaseBins	float *   	Output 	Length of the phase bins.
*                                       (timeStepSet values in phase units.)


