The SIGSPEC result files #index#.result.dat are located in the project directory and contain a list of all sig maxima associated to each of the input time series #index#.<project>.dat. A SIGSPEC result file consists of seven columns. A full description is provided by the SIGSPEC manual, p.![[*]](file:/usr/share/latex2html/icons/crossref.png){kind=icon}
. CINDERELLA uses only five columns:
The last line of a result file contains only two non-zero values in columns 5 and 6. These represent the rms and point-to-point scatter of the time series after the last prewhitening step, correspondingly, and are also used by CINDERELLA.
Example. The sample project CinderellaNative provides a run without any additional options by typing Cinderella CinderellaNative. The files 000000.CinderellaNative.dat, ..., 000008.CinderellaNative.dat are the same as 000038.diffsig.dat to 000046.diffsig.dat in the SIGSPEC example diffsig (Reegen 2009, p.), correspondingly.
The SIGSPEC result files 000000.result.dat to 000008.result.dat are provided in the project directory CinderellaNative. They contain all signal components found with sig 
2 and are displayed in Fig.1.
The screen output at runtime starts with a standard header.
CCCCC ii dd ll ll CC CC dd ll ll CC ii n nnn ddddd eeee r rrr eeee ll ll aaaa CC ii nn nn dd dd ee ee rr rr ee ee ll ll aa aa CC ii nn nn dd dd ee ee rr ee ee ll ll aa CC ii nn nn dd dd eeeeee rr eeeeee ll ll aaaaa CC ii nn nn dd dd ee rr ee ll ll aa aa CC CC ii nn nn dd dd ee ee rr ee ee ll ll aa aa CCCCC ii nn nn ddd d eeee rr eeee ll ll aaa a Comparison of INDEpendent RELative Least-squares Amplitudes Version 1.0 ************************************************************ by Piet Reegen Institute of Astronomy University of Vienna Tuerkenschanzstrasse 17 1180 Vienna, Austria Release date: April 29, 2008
The program starts with processing the command line, checking if a present directory CinderellaNative is present, and searching for a configuration file CinderellaNative.cnd (see ``The .cnd file'', p.). Since there is no such file present, CINDERELLA produces a warning message.
*** start **************************************************
Checking availability of project directory CinderellaNative...
project directory CinderellaNative ok.
Warning: CndFile_LoadCnd 001
Failed to open .cnd file.
Now CINDERELLA counts the time series input files and checks for corresponding SIGSPEC result files.
*** MultiFile count **************************************** Number of files 9
The next step is to count the rows in each SIGSPEC result file.
*** count rows in SigSpec result files ********************* CinderellaNative/000000.result.dat: 106 rows CinderellaNative/000001.result.dat: 21 rows CinderellaNative/000002.result.dat: 21 rows CinderellaNative/000003.result.dat: 21 rows CinderellaNative/000004.result.dat: 21 rows CinderellaNative/000005.result.dat: 21 rows CinderellaNative/000006.result.dat: 21 rows CinderellaNative/000007.result.dat: 21 rows CinderellaNative/000008.result.dat: 21 rows
Before reading the input files, CINDERELLA performs the assignment of target, comp and skip tags to the datasets (see ``Dataset Types'', p.). Since there is no file CinderellaNative.cnd available, the defaults are used: the first file, 000000.CinderellaNative.dat is considered a comparison dataset, the eight remaining files are interpreted as targets.
*** dataset type assignment ********************************
Warning: CndFile_Cind 001
Failed to open .cnd file.
Assigning default types.
000000.CinderellaNative.dat: comparison (default)
000001.CinderellaNative.dat: target (default)
000002.CinderellaNative.dat: target (default)
000003.CinderellaNative.dat: target (default)
000004.CinderellaNative.dat: target (default)
000005.CinderellaNative.dat: target (default)
000006.CinderellaNative.dat: target (default)
000007.CinderellaNative.dat: target (default)
000008.CinderellaNative.dat: target (default)
number of target datasets 8
number of comparison datasets 1
number of datasets to skip 0
The time series and SIGSPEC result files are read, and CINDERELLA displays the frequency resolution and the mean observable for each time series.
*** read input files *************************************** 000000.CinderellaNative.dat: Rayleigh resolution 0.1089880382935977 000000.CinderellaNative.dat: mean observable 0.0074422789800987 CinderellaNative/000000.result.dat 000001.CinderellaNative.dat: Rayleigh resolution 0.0914470160931467 000001.CinderellaNative.dat: mean observable -0.0704869463068650 CinderellaNative/000001.result.dat 000002.CinderellaNative.dat: Rayleigh resolution 0.0914470160931467 000002.CinderellaNative.dat: mean observable -0.0875484339175066 CinderellaNative/000002.result.dat 000003.CinderellaNative.dat: Rayleigh resolution 0.0914470160931467 000003.CinderellaNative.dat: mean observable -0.1046099215281657 CinderellaNative/000003.result.dat 000004.CinderellaNative.dat: Rayleigh resolution 0.0914470160931467 000004.CinderellaNative.dat: mean observable -0.1216714091388107 CinderellaNative/000004.result.dat 000005.CinderellaNative.dat: Rayleigh resolution 0.0914470160931467 000005.CinderellaNative.dat: mean observable -0.1387328967494604 CinderellaNative/000005.result.dat 000006.CinderellaNative.dat: Rayleigh resolution 0.0914470160931467 000006.CinderellaNative.dat: mean observable -0.1557943843601256 CinderellaNative/000006.result.dat 000007.CinderellaNative.dat: Rayleigh resolution 0.0914470160931467 000007.CinderellaNative.dat: mean observable -0.1728558719707690 CinderellaNative/000007.result.dat 000008.CinderellaNative.dat: Rayleigh resolution 0.0914470160931467 000008.CinderellaNative.dat: mean observable -0.1899173595814251 CinderellaNative/000008.result.dat
The amplitudes in the SIGSPEC result file of the comparison dataset (file CinderellaNative/000000.result.dat have to be transformed in order to be comparable to the target datasets (see ``Amplitude transformation'', p.). CINDERELLA uses the rms residual as a measure for this transformation. This is the default setting.
*** amplitude transformation ******************************* by rms error: file 0
The core of CINDERELLA consists of three different analyses. The first part of these is the computation of conditional sigs for each pair of target vs. comparison datasets. In this case we have eight target datasets and one comparison dataset, which results in eight operations. In general, the total number of operations performed in this step is the product of the number of target datasets times the number of comparison datasets. Detailed information on the computation of pairwise conditional sigs is found in ``Single-comparison output'' (p.).
*** pairwise Cinderella analysis ***************************
1 vs. 0: conditional sig
2 vs. 0: conditional sig
3 vs. 0: conditional sig
4 vs. 0: conditional sig
5 vs. 0: conditional sig
6 vs. 0: conditional sig
7 vs. 0: conditional sig
8 vs. 0: conditional sig
The second part of the CINDERELLA analysis is a computation of mean conditional sigs for each target dataset over all comparison datasets (see ``Multi-comparison output'', p.). Since there is only one comparison dataset available in this example, the output of this procedure is the same as of the previous pairwise analysis. Finally, CINDERELLA evaluates composed sigs for each target dataset. This calculation is applied to the ``raw'' SIGSPEC results and also to the conditional sigs obtained by the previous operation. Details on the computation of composed sigs are found in ``Composed Mode'' (p.).
*** total Cinderella analysis ******************************
1: conditional sig
2: conditional sig
3: conditional sig
4: conditional sig
5: conditional sig
6: conditional sig
7: conditional sig
8: conditional sig
composed sig
composed sig of conditional sigs
On exit, CINDERELLA displays a goodbye message.
Finished. ************************************************************ Thank you for using Cinderella! Questions or comments? Please contact Piet Reegen ([email protected]) Bye!
The CINDERELLA output for this example is discussed in the subsequent chapters.