Git commit 2ef514ca98c311701ccbb3187b1ea6e77f78cf3d by Raphael Cojocaru. Committed on 09/08/2016 at 11:16. Pushed by raphaelc into branch 'master'.
Update tutorial M +22 -15 doc/config.docbook http://commits.kde.org/kstars/2ef514ca98c311701ccbb3187b1ea6e77f78cf3d 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>
