Index: /trunk/Ohana/src/libdvo/doc/dvo-structures.txt =================================================================== --- /trunk/Ohana/src/libdvo/doc/dvo-structures.txt (revision 6245) +++ /trunk/Ohana/src/libdvo/doc/dvo-structures.txt (revision 6245) @@ -0,0 +1,56 @@ + +DVO has undergone at least two bit-incompatible versions of the data +structures to date: the 'loneos' version and the 'elixir' version. + +the 'loneos' version was used for the loneos database currently still +in my dataspace. + +the 'elixir' version, which extended some of the structures and added +the Secfilt concept, was added at CFHT and is used for all of the +existing CFHT elixir databases. + +For DVO-2 development, I will need to make a few modifications to +those tables. It will be useful to allow versions of DVO which +interact with these different versions correctly. At one level, this +simply means changing the structures in the included file. More +difficult is that certain functions use elements of the structures +from one version which are not available in the other versions. + +I am going to explore this process briefly to get DVO-2 started, +particularly so I can solve the astrometric problems which are +currently limited by the use of floats to represent RA & DEC. + +I am going to make the selection of the structures depend on #define +values in the header files. Currently, everybody which works with the +dvo files includes loneos.h. This should be broken out to a loneos.h, +elixir.h, panstarrs.h, etc, all independently included from within +dvo.h, which will be the include file called within the user-level +programs. + +Translations + +/* average data as stored in the LONEOS database -- must be translated on load */ + +Loneos:Measure -> Elixir:Measure +/* OLD LONEOS VERSION. NOT BYTE COMPATIBLE WITH NEW VERSION + (can be loaded with translation, losing the exptime, + and limited the number of Naverage to 0xffffff - in load_catalog) */ + +------ + +the DVO structure Catalog contains the data from a single sky patch, including: + average, measure, missing, and secfilt. + +the catalog may be saved in one of 4 modes (catalog.catmode): + raw : the old Elixir style which is a header + 4 binary tables + mef : catalog is a single file with header and 4 fits tables + split : catalog is 5 files, one with the header and one for each table + mysql : catalog is 4 (or 5?) mysql tables + + in split mode, the filename is the file of the descriptive header + and the averages, the measure, missing, and secfilt data are + stored in additional files referenced in the header and named + based on the filename (replacing extension .cpa with .cpb, .cpc, + .cpd, for example) + + Index: /trunk/Ohana/src/libdvo/doc/fits_db.txt =================================================================== --- /trunk/Ohana/src/libdvo/doc/fits_db.txt (revision 6245) +++ /trunk/Ohana/src/libdvo/doc/fits_db.txt (revision 6245) @@ -0,0 +1,5 @@ + +FITS_DB represents a FITS table file, including the primary header, +any existing matrix, the table header, and the table data as either an +ftable (real) or vtable (virtual) FITS table. + Index: unk/Ohana/src/libohana/doc/dvo-structures.txt =================================================================== --- /trunk/Ohana/src/libohana/doc/dvo-structures.txt (revision 6244) +++ (revision ) @@ -1,56 +1,0 @@ - -DVO has undergone at least two bit-incompatible versions of the data -structures to date: the 'loneos' version and the 'elixir' version. - -the 'loneos' version was used for the loneos database currently still -in my dataspace. - -the 'elixir' version, which extended some of the structures and added -the Secfilt concept, was added at CFHT and is used for all of the -existing CFHT elixir databases. - -For DVO-2 development, I will need to make a few modifications to -those tables. It will be useful to allow versions of DVO which -interact with these different versions correctly. At one level, this -simply means changing the structures in the included file. More -difficult is that certain functions use elements of the structures -from one version which are not available in the other versions. - -I am going to explore this process briefly to get DVO-2 started, -particularly so I can solve the astrometric problems which are -currently limited by the use of floats to represent RA & DEC. - -I am going to make the selection of the structures depend on #define -values in the header files. Currently, everybody which works with the -dvo files includes loneos.h. This should be broken out to a loneos.h, -elixir.h, panstarrs.h, etc, all independently included from within -dvo.h, which will be the include file called within the user-level -programs. - -Translations - -/* average data as stored in the LONEOS database -- must be translated on load */ - -Loneos:Measure -> Elixir:Measure -/* OLD LONEOS VERSION. NOT BYTE COMPATIBLE WITH NEW VERSION - (can be loaded with translation, losing the exptime, - and limited the number of Naverage to 0xffffff - in load_catalog) */ - ------- - -the DVO structure Catalog contains the data from a single sky patch, including: - average, measure, missing, and secfilt. - -the catalog may be saved in one of 4 modes (catalog.catmode): - raw : the old Elixir style which is a header + 4 binary tables - mef : catalog is a single file with header and 4 fits tables - split : catalog is 5 files, one with the header and one for each table - mysql : catalog is 4 (or 5?) mysql tables - - in split mode, the filename is the file of the descriptive header - and the averages, the measure, missing, and secfilt data are - stored in additional files referenced in the header and named - based on the filename (replacing extension .cpa with .cpb, .cpc, - .cpd, for example) - -