summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRaphael Cojocaru <raphael.cojocaru@yahoo.com>2016-07-18 12:19:43 (GMT)
committerRaphael Cojocaru <raphael.cojocaru@yahoo.com>2016-07-18 12:19:43 (GMT)
commit4843e8f2282e11c571ff67aa0ef8e6082f8ba91b (patch)
tree8a77d6e1aa035083704ebb7572add7e4db230914
parent23e9f7671d92c0e3412377099c4f8f4c5ff950e9 (diff)
New tutorial for importing custom catalogs
-rw-r--r--doc/added_ldn.pngbin0 -> 75296 bytes
-rw-r--r--doc/complete_info_ldn.pngbin0 -> 57403 bytes
-rw-r--r--doc/config.docbook111
-rw-r--r--doc/open_dialog_ldn.pngbin0 -> 59276 bytes
-rw-r--r--doc/open_ldn.pngbin0 -> 43505 bytes
5 files changed, 111 insertions, 0 deletions
diff --git a/doc/added_ldn.png b/doc/added_ldn.png
new file mode 100644
index 0000000..06b9eed
--- /dev/null
+++ b/doc/added_ldn.png
Binary files differ
diff --git a/doc/complete_info_ldn.png b/doc/complete_info_ldn.png
new file mode 100644
index 0000000..0fc737e
--- /dev/null
+++ b/doc/complete_info_ldn.png
Binary files differ
diff --git a/doc/config.docbook b/doc/config.docbook
index 9c1939c..b044ee2 100644
--- a/doc/config.docbook
+++ b/doc/config.docbook
@@ -571,6 +571,117 @@ faint limits for sky objects for zoomed in and zoomed out states of the renderin
the <guilabel>Show objects of unknown magnitude</guilabel> item is enabled, objects whose
magnitudes are unknown, or not available to &kstars;, are drawn irrespective of the faint limits set.
</para>
+
+<para>
+To summarize, I will provide a brief example on how to add new catalogues. Firstly, you need a catalog
+data file. For this example, I will use <quote>Lynds Catalog of Dark Nebulae</quote>.
+There are the steps:
+<itemizedlist>
+
+<listitem><para>
+Download/write the raw catalog data file (the raw file is the file containing catalog's objects described by a set
+of parameters, like: ID Number, Right Ascension, Declination and so on). Note that each object should be written on
+a separate row and each line in the custom catalog file should contain the following space-separated fields:
+<para>For stars: type(0 for stars), RA, Dec, mag, SpType, name(optional)</para>
+<para>For other types: type(3-8), RA, Dec, mag (optional), flux(optional), name(optional)</para>
+</para></listitem>
+
+<listitem><para>
+Open the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure KStars...</guimenuitem></menuchoice> menu and
+choose <guilabel>Catalogs</guilabel> tab.
+</para></listitem>
+
+<listitem><para>
+In the Deep-Sky objects section, press the <guibutton>Import Catalog...</guibutton> button. If the button is not
+available, check the <guibutton>Deep-Sky Catalogs</guibutton> checkbox. This will enable you to configure &kstars;
+deep-sky objects catalogs.
+</para></listitem>
+
+<listitem><para>
+After you press the <guibutton>Import Catalog...</guibutton> button, <guilabel>Import Catalog</guilabel> window
+will pop up. At first, click on <guibutton>Open file dialog</guibutton> button in order to select the raw data file.
+<screenshot>
+<screeninfo>Import catalog</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="open_dialog_ldn.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Import new catalog</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+</para></listitem>
+
+<listitem><para>
+In the dialog window, find your raw file, select it and then press <guibutton>Open</guibutton> button.
+<screenshot>
+<screeninfo>Open catalog</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="open_ldn.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Open Dark Nebulae catalog</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+</para></listitem>
+
+<listitem><para>
+Now, you need to specify the correct order of the catalog fields within the raw data file. The fields must be added
+inside <guilabel>Catalog fields</guilabel> list. Note that you can drag fields in order to build the right order or
+you can use additional fields from <guilabel>Available fields</guilabel> fields. For example, if your raw data file
+contains a magnitude column, then you need to add Magnitude field to the <guilabel>Catalog fields</guilabel> list.
+<screenshot>
+<screeninfo>Complete info for new catalog</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="complete_info_ldn.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Complete info for new catalog</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+</para></listitem>
+
+<listitem><para>
+After you set the fields so that they match to your catalog raw file, you can move to next step: completing the
+remaining input fields: <guilabel>Coordinate epoch</guilabel>, <guilabel>Catalog name prefix</guilabel> ,
+<guilabel>Catalog name</guilabel> and <guilabel>Save catalog as</guilabel>. You can also choose the
+<guilabel>Symbol color</guilabel> used for your catalog. There you can specify how the fields are splitted within
+the raw data file: CSV (Comma-separated values) or Space Delimited.
+</para></listitem>
+
+<listitem><para>
+You can preview the output by pressing the <guibutton>Preview Output</guibutton> button. Pay attention to the header
+fields to have the same order as your catalog fields (&ie; ID RA Dc)
+</para></listitem>
+
+<listitem><para>
+Press <guibutton>OK</guibutton> button to close the <guilabel>Catalog Preview</guilabel> window. Then press
+<guibutton>OK</guibutton> button again to create and save your catalog.
+</para></listitem>
+
+<listitem><para>
+After you successfully imported your catalog, it will be displayed in the catalogs list. You can choose to be displayed
+or not, by pressing on its checkbox.
+<screenshot>
+<screeninfo>Added Dark Nebulae by Lynds catalog</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="added_ldn.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Dark Nebulae by Lynds catalog</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+</para></listitem>
+</itemizedlist>
+</para>
+
</sect1>
<sect1 id="solar_system">
diff --git a/doc/open_dialog_ldn.png b/doc/open_dialog_ldn.png
new file mode 100644
index 0000000..e696c36
--- /dev/null
+++ b/doc/open_dialog_ldn.png
Binary files differ
diff --git a/doc/open_ldn.png b/doc/open_ldn.png
new file mode 100644
index 0000000..2095986
--- /dev/null
+++ b/doc/open_ldn.png
Binary files differ