[Kstars-devel] KDE/kdeedu/kstars/kstars

[Jason Harris]

SVN commit 422195 by harris:

Adding new Custom catalogs tool, accessible from the Catalogs tab of 
the Configure window.  To add a custom catalog, first construct a file 
containing the catalog data.  The file should contain 
space-separated column data for each object.  Any of the following data 
fields can be used, in any order:

+ ID number
+ RA
+ Dec
+ Object type identifier
+ magnitude
+ major axis (arcmin)
+ minor axis (arcmin)
+ position angle (degrees)
+ common name / alternate name (wrap in quotes if it contains spaces!)
+ Ignore (a field in the data file that is to be skipped)

Open the Add Custom Catalog tool, and fill in the name of the catalog, 
the output catalog name, and the input data file you just created.  You 
need to arrange the "Catalog Fields" list, so that it contains the same 
data fields as your data file, and in the same order.  Just drag and 
drop.  For all fields except ignore, only one copy is allowed between 
the "Catalog fields" and "Available fields" boxes.  

Finally, select a coordinate epoch, a symbol color, and the catalog 
prefix.  The prefix is used with the ID numbers (if that is one of your 
fields) to construct the object name.  So if you use ID numbers, and 
your prefix is "YY", then the objects are named "YY 1", "YY 2", etc.

You can press the Preview button to make sure everything's okay.  If 
there are problems, you'll get a window explaining in some detail what 
the issues are.  When satisfied, press Ok, and your new catalog 
appears in the list.  Your objects are in the sky, and usable 
throughout the program.  The output catalog file is the same as the 
input data file, with a "metadata header" prepended to it that allows 
KStars to parse the file.

It's a pretty big commit, so please try it out and let me know what you 
think and if there are issues.  To get you started, I will post a 
sample catalog to the mailing list that you can play with.

KNOWN ISSUES: 

The difference between "Load Catalog" and "Create Catalog" may not be 
very obvious.  "Load Catalog" is only to be used if you have a file 
that already has a valid metadata header.

Tab order:  for some reason, the "Append existing file" edit box never 
gets input focus for tabbing.  The little "open file" icon next to it 
gets focus instead.

Need to add a mechanism to require RA and Dec fields in the 
catalog.

CCMAIL: kstars-devel at kde.org



 M  +23 -23    Makefile.am  
 M  +134 -31   addcatdialog.cpp  
 M  +19 -16    addcatdialog.h  
 M  +272 -39   addcatdialogui.ui  
 A             customcatalog.cpp   [License: GPL (v2+)]
 A             customcatalog.h   [License: GPL (v2+)]
 M  +1 -1      deepskyobject.cpp  
 A             draglistbox.cpp   [License: GPL (v2+)]
 A             draglistbox.h   [License: GPL (v2+)]
 M  +0 -9      kstars.kcfg  
 M  +389 -133  kstarsdata.cpp  
 M  +58 -15    kstarsdata.h  
 M  +57 -28    opscatalog.cpp  
 M  +3 -0      opscatalog.h  
 M  +27 -10    opscatalogui.ui  
 M  +7 -6      skymap.cpp  
 M  +12 -10    skymapdraw.cpp