kstars/doc/hips.docbook

0001 <sect1 id="hips">
0002 <title><acronym>HiPS</acronym> Progressive Overlay</title>
0003 <indexterm><primary>Views</primary>
0004 <secondary>HiPS Progressive Overlay</secondary>
0005 </indexterm>
0006
0007 <para>&kstars; provides support for HiPS: Hierarchical Progressive Surveys. HiPS provides multi-resolution progressive surveys to be overlayed directly in client applications.
0008 It provides an immersive experience as you can explore the night sky dynamically. With over 200+ surveys across the whole electromagnetic spectrum from radio,
0009 infrared, visual, to even gamma rays, the user can pan and zoom progressively deeper into the data visually.
0010 </para>
0011 <para>It can be enabled from the <menuchoice><guimenu>View</guimenu> <guisubmenu>HiPS All Sky Overlay</guisubmenu></menuchoice> submenu.</para>
0012 <para>Under the submenu, a list of enabled surveys are listed. Click on the survey of interest to activate it. You can only activate one-overlay at a time. After activating the survey, &kstars; shall begin downloading
0013 the data in the background and progressively overlay the images unto the sky map as they become ready. Zooming in usually requires another patch of images that should trigger another download cycle.</para>
0014
0015 <screenshot>
0016   <screeninfo>DSS Color HiPS</screeninfo>
0017   <mediaobject>
0018     <imageobject>
0019       <imagedata fileref="kstars_hips.png" format="PNG"/>
0020     </imageobject>
0021     <textobject>
0022       <phrase>DSS Color Overlay</phrase>
0023     </textobject>
0024   </mediaobject>
0025 </screenshot>
0026
0027 <para>The above screenshot shows the DSS Color visual overlay in &kstars;.</para>
0028
0029 <para><guimenuitem>HiPS Settings...</guimenuitem> menu item shows a dialog with the following pages:</para>
0030 <itemizedlist>
0031   <listitem><para><guilabel>Display</guilabel>: Enable or disable <guilabel>Show HiPS grid</guilabel> and <guilabel>Linear interpolation</guilabel> checkboxes. The interpolation is enabled by default and should make the overlay appear smoother.</para></listitem>
0032   <listitem><para><guilabel>Cache</guilabel>: Set the <guilabel>Disk:</guilabel> and <guilabel>Memory:</guilabel> cache size in MB. Increase cache size if you have abundant resources and want to reduce bandwidth required to download the images.</para></listitem>
0033   <listitem><para><guilabel>Sources</guilabel>: Browse a list of HiPS sources and enable/disable them accordingly. When you select each source, a summary and a preview are downloaded that include information on the mission in additional to technical data on the survey.</para></listitem>
0034 </itemizedlist>
0035 </sect1>