summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRaphael Cojocaru <raphael.cojocaru@yahoo.com>2016-08-09 11:16:01 (GMT)
committerRaphael Cojocaru <raphael.cojocaru@yahoo.com>2016-08-09 11:16:01 (GMT)
commit2ef514ca98c311701ccbb3187b1ea6e77f78cf3d (patch)
treea8a5bbac83c9c3f1ebbdb9482ca973db8cbe3a97
parent0699e337da7b9bdf417b9935f174239fb047884e (diff)
Update tutorial
-rw-r--r--doc/config.docbook37
1 files changed, 22 insertions, 15 deletions
diff --git a/doc/config.docbook b/doc/config.docbook
index 76f0395..5029212 100644
--- a/doc/config.docbook
+++ b/doc/config.docbook
@@ -612,16 +612,23 @@ objects described by a set of parameters, like: ID Number, Right Ascension, Decl
</important>
<para>
-The following is a subset of the raw data file:
+The following is a subset of the original raw data file:
<programlisting>
-1 16:26:0 -16:0:0.1 13.943 5
-2 18:4:0 -31:30:0.1 66.813 5
-3 18:0:0 -31:0:0.1 141.986 5
-4 16:59:5 -22:8:0.1 3.795 5
-5 17:13:2 -24:22:0.2 6.573 5
+ 1 16 26.0 -16 0 .18 +21.82 .054 3 49 8 452
+ 2 18 4.0 -31 30 .13 -05.32 1.240 2 0 4 837
+ 3 18 0.0 -31 0 .15 -04.33 5.600 2 0 6 817
+ 4 16 59.5 -22 8 .18 +11.82 .004 5 27 7 533
+ 5 17 13.2 -24 22 .20 +07.96 .012 4 0 9 595
</programlisting>
+The raw file contains some extra information, unusable for &kstars;. It also contains extra white spaces
+and values are not meeting &kstars; expectations (&ie; for Right Ascension: colon-delimited hh:mm:ss.s
+or floating-point value). Thus, it need to be modified in order to match &kstars; format.
+For a better understanding on what each column means, you can take a look at
+<ulink url="ftp://cdsarc.u-strasbg.fr/cats/VII/7A/">the original source</ulink> of the catalog.
+It contains the raw data file and, in adittion, it contains an useful readme, which will help
+you understand what you should keep and furthermore, what you need to remove from the raw data file.
Minimally, the raw data file should contain the following fields:
<itemizedlist>
<listitem><para>ID Number</para></listitem>
@@ -633,15 +640,15 @@ Minimally, the raw data file should contain the following fields:
</para>
<para>
-The raw <quote>Dark Nebulae by Lynds</quote> contains only Right Ascension, Declination
-and Area (square degrees). Therefore, in order to properly import the catalog
-into &kstars;, the ID and Object Type fields need to be added. You can insert these values
-manually using your favorite text editor. However, it is recommended to use any spreadsheet
-application to import the raw data file and add the necessary columns. This is especially
-convenient for large data sets. Since the original raw data contains an area field which
-is not supported by &kstars;, we need to approximate it to a usable value which is the
-Major Axis. Therefore, we use the following formula in the spreadsheet to convert area
-to major axis in arcminutes:
+The raw <quote>Dark Nebulae by Lynds</quote> contains only three usable fields for &kstars;:
+Right Ascension, Declination and Area (square degrees). Therefore, in order to properly
+import the catalog into &kstars;, the ID and Object Type fields need to be added. You can
+insert these values manually using your favorite text editor. However, it is recommended
+to use any spreadsheet application to import the raw data file and add the necessary
+columns. This is especially convenient for large data sets. Since the original raw data
+contains an area field which is not supported by &kstars;, we need to approximate it to a
+usable value which is the Major Axis. Therefore, we use the following formula in the
+spreadsheet to convert area to major axis in arcminutes:
<constant>Major Axis = sqrt(Area) * 60</constant>
</para>