Warning, /education/kstars/doc/ekos-align.docbook is written in an unsupported language. File is not indexed.

0001 <sect2 id="ekos-align">
0002     <title>Align</title>
0003     <indexterm>
0004         <primary>Tools</primary>
0005         <secondary>Ekos</secondary>
0006         <tertiary>Align</tertiary>
0007     </indexterm>
0008     <sect3 id="ekos-align-introduction">
0009         <title>Introduction</title>
0010         <screenshot>
0011             <screeninfo>
0012                 Ekos Align Module
0013             </screeninfo>
0014             <mediaobject>
0015                 <imageobject>
0016                     <imagedata fileref="ekos_astrometry.png" format="PNG"/>
0017                 </imageobject>
0018                 <textobject>
0019                     <phrase>Ekos Align Module</phrase>
0020                 </textobject>
0021             </mediaobject>
0022         </screenshot>
0023         <para>
0024             Ekos Alignment Module enables highly accurate GOTOs to within sub-arcseconds accuracy and can measure and correct polar alignment errors. This is possible thanks to the astrometry.net solver. Ekos begins by capturing an image of a star field, feeding that image to <ulink url="https://astrometry.net">astrometry.net</ulink> solver, and getting the central coordinates (RA, DEC) of the image. The solver essentially performs a pattern recognition against a catalog of millions of stars. Once the coordinates are determined, the true pointing of the telescope is known.
0025         </para>
0026         <para>
0027             Often, there is a discrepancy between where the telescope thinks it is looking at and where it is truly pointing. The magnitude of this discrepancy can range from a few arcminutes to a couple of degrees. Ekos can then correct the discrepancy by either syncing to the new coordinates, or by slewing the mount to the desired target originally requested.
0028         </para>
0029         <para>
0030             Furthermore, Ekos provides a Polar Alignment Assistant Tool to correct polar alignment errors. It takes three images, slewing between the images, and calculates the offset between the mount axis and polar axis. It feeds back to the user the altitude and azimuth adjustments needed to align these axes. These images are typically taken near the celestial pole (Close to Polaris for Northern Hemisphere) but can work well taken from anywhere, usually starting near the meridian and slewing either East or West.
0031         </para>
0032         <para>
0033             At a minimum, you need a CCD/Webcam and a telescope that supports Slew &amp; Sync commands. Most popular commercial telescope nowadays support such commands.
0034         </para>
0035         <para>
0036             For the Ekos Alignment Module to work, you have an option of either utilizing the <emphasis>online</emphasis> astrometry.net solver, <emphasis>offline</emphasis>, or <emphasis>remote</emphasis> solver:
0037         </para>
0038         <itemizedlist>
0039             <listitem>
0040                 <para>
0041                     <guilabel>Online Solver</guilabel>: The online solver requires no configuration, and depending on your Internet bandwidth, it might take a while to upload and solve the image.
0042                 </para>
0043             </listitem>
0044             <listitem>
0045                 <para>
0046                     <guilabel>Offline Solver</guilabel>: The offline solver can be faster and requires no Internet connection. In order to use the offline solver, you must install astrometry.net in addition to the necessary index files.
0047                 </para>
0048             </listitem>
0049             <listitem>
0050                 <para>
0051                     <guilabel>Remote Solver</guilabel>: The remote solver is an offline solver the resides on a different machine (for example, you can use Astrometry solver on StellarMate). Captured images are solved on the remote machine.
0052                 </para>
0053             </listitem>
0054         </itemizedlist>
0055     </sect3>
0056 
0057     <sect3 id="ekos-align-get-astrometry">
0058         <title>Get astrometry.net</title>
0059 
0060         <para>
0061             If you are planning to use <emphasis>Offline</emphasis> astrometry then you need to download astrometry.net application.
0062         </para>
0063         <note>
0064             <para>
0065                 Astrometry.net is already shipped with StellarMate so there is no need to install it. Index files from 16 arcminutes and above (4206 to 4019) are included with StellarMate. For any additional index files, you need to install them as necessary. To use Astrometry in StellarMate from a remote Ekos on &Linux;/&Windows;/&MacOS;, make sure to select <guimenuitem>Remote</guimenuitem> option in Ekos Alignment Module. Furthermore, make sure that the <guimenuitem>Astrometry</guimenuitem> driver is selected in your equipment profile.
0066             </para>
0067         </note>
0068         <screenshot>
0069             <screeninfo>
0070                 Ekos Remote Astrometry
0071             </screeninfo>
0072             <mediaobject>
0073                 <imageobject>
0074                     <imagedata fileref="ekos_remote_astrometry.png" format="PNG"/>
0075                 </imageobject>
0076                 <textobject>
0077                     <phrase>Ekos Remote Astrometry</phrase>
0078                 </textobject>
0079             </mediaobject>
0080         </screenshot>
0081         <variablelist>
0082             <varlistentry>
0083                 <term>&Windows;</term>
0084                 <listitem>
0085                     <para>
0086                         To use astrometry.net under &Windows;, you need to download and install the <ulink url="https://adgsoftware.com/ansvr/">ANSVR Local Astrometry.net solver</ulink>. The ANSVR mimics the astrometry.net online server on your local computer; thus the internet not required for any astrometry queries.
0087                     </para>
0088                     <para>
0089                         After installing the ANSVR server and downloading the appropriate index files for your setup, make sure ANSVR server is up and running and then go to Ekos Alignment options where you can simply change the <guilabel>API URL</guilabel> to use the ANSVR server as illustrated below:
0090                     </para>
0091                     <screenshot>
0092                         <screeninfo>
0093                             ANSVR Parameters
0094                         </screeninfo>
0095                         <mediaobject>
0096                             <imageobject>
0097                                 <imagedata fileref="astrometry_windows_ansvr.png" format="PNG"/>
0098                             </imageobject>
0099                             <textobject>
0100                                 <phrase>ANSVR Parameters</phrase>
0101                             </textobject>
0102                         </mediaobject>
0103                     </screenshot>
0104                     <para>
0105                         In Ekos Align module, you must set the solver type to <guimenuitem>Online</guimenuitem> so that it uses the local ANSVR server for all astrometry queries. Then you can use the align module as you would normally do.
0106                     </para>
0107                     <para>
0108                         Remember as indicated above that StellarMate <emphasis>already</emphasis> includes astrometry.net. Therefore, if you would like to use StellarMate remotely to solve your images, simply change solver type to <guimenuitem>Remote</guimenuitem> and ensure that your equipment profile includes <emphasis role="bold">Astrometry</emphasis> driver which can be selected under the <guilabel>Auxiliary</guilabel> dropdown. This is applicable to all operating systems and not just &Windows;.
0109                     </para>
0110                 </listitem>
0111             </varlistentry>
0112             <varlistentry>
0113                 <term>&MacOS;</term>
0114                 <listitem>
0115                     <para>
0116                         Astrometry.net is already included with &kstars; for &MacOS;, so no need to install it.
0117                     </para>
0118                 </listitem>
0119             </varlistentry>
0120             <varlistentry>
0121                 <term>&Linux;</term>
0122                 <listitem>
0123                     <para>
0124                         Astrometry.net is already included with &kstars; bleeding version. But if astrometry is not installed, then you can install it by running the following command under &ubuntu;:
0125                     </para>
0126                     <para>
0127                         <command>sudo apt-get install astrometry.net</command>
0128                     </para>
0129                 </listitem>
0130             </varlistentry>
0131         </variablelist>
0132     </sect3>
0133 
0134     <sect3 id="ekos-align-download-index-files">
0135         <title>Download Index Files</title>
0136         <para>
0137             For offline (and remote) solvers, index files are necessary for the solver to work. The complete collection of index files is huge (over 30 GB), but you only need to download what is necessary for your equipment setup. Index files are sorted by the Field-Of-View (FOV) range they cover. There are two methods to fetch the necessary index files: The new download support in Align module, and the old manual way.
0138         </para>
0139         <sect4 id="ekos-align-automatic-download">
0140             <title>Automatic Download</title>
0141             <screenshot>
0142                 <screeninfo>
0143                     Astrometry.net Indexes Download
0144                 </screeninfo>
0145                 <mediaobject>
0146                     <imageobject>
0147                         <imagedata fileref="astrometry_indexes_settings.png" format="PNG"/>
0148                     </imageobject>
0149                     <textobject>
0150                         <phrase>Astrometry.net Indexes Download</phrase>
0151                     </textobject>
0152                 </mediaobject>
0153             </screenshot>
0154             <para>
0155                 Automatic download is only available for Ekos users on &Linux; &amp; &MacOS;. For &Windows; users, please download ANSVR solver.
0156             </para>
0157             <para>
0158                 To access the download page, click the <guibutton>Options</guibutton> button in the <link linkend="ekos-align">Align module</link> and then select <guilabel>Astrometry Index Files</guilabel> tab. The page displays the current FOV of your current setup and below it a list of available and installed index files. Three icons are used to designate the importance of index files given your current setup as follows:
0159             </para>
0160             <itemizedlist>
0161                 <listitem>
0162                     <para>
0163                         <inlinemediaobject><imageobject><imagedata fileref="security-high.png" format="PNG"/></imageobject></inlinemediaobject> <guilabel>Required</guilabel>
0164                     </para>
0165                 </listitem>
0166                 <listitem>
0167                     <para>
0168                         <inlinemediaobject><imageobject><imagedata fileref="security-medium.png" format="PNG"/></imageobject></inlinemediaobject> <guilabel>Recommended</guilabel>
0169                     </para>
0170                 </listitem>
0171                 <listitem>
0172                     <para>
0173                         <inlinemediaobject><imageobject><imagedata fileref="security-low.png" format="PNG"/></imageobject></inlinemediaobject> <guilabel>Optional</guilabel>
0174                     </para>
0175                 </listitem>
0176             </itemizedlist>
0177             <para>
0178                 You must download all the required files, and if you have plenty of hard drive space left, you can also download the recommended indexes. If an index file is installed, the checkmark shall be checked, otherwise check it to download the relevant index file. Please only download one file at a time, especially for larger files. You might be prompted to enter the administrator password (default in StellarMate is <userinput>smate</userinput>) to install the files. Once you installed all the required files, you can begin using the offline astrometry.net solver immediately.
0179             </para>
0180         </sect4>
0181         <sect4 id="ekos-align-manual-download">
0182                 <title>Manual Download</title>
0183                 <para>
0184                     You need to <ulink url="http://data.astrometry.net">download</ulink> and install the necessary index files suitable for your telescope+CCD field of view (FOV). You need to install index files covering 100% to 10% of your FOV. For example, if your FOV is 60 arcminutes, you need to install index files covering skymarks from 6 arcminutes (10%) to 60 arcminutes (100%). There are many online tools to calculate FOVs, such as <ulink url="http://starizona.com/acb/ccd/calc_pixel.aspx">Starizona Field of View Calculator</ulink>.
0185                 </para>
0186                 <table frame="all">
0187                     <title>Index Files</title>
0188                     <tgroup cols='3' align='left' colsep='1' rowsep='1'>
0189                         <thead>
0190                             <row>
0191                                 <entry>Index Filename</entry>
0192                                 <entry>FOV (arcminutes)</entry>
0193                                 <entry>Debian Package</entry>
0194                             </row>
0195                         </thead>
0196                         <tbody>
0197                             <row>
0198                                 <entry>index-4219.fits</entry>
0199                                 <entry>1400 - 2000</entry>
0200                                 <entry morerows="11" valign="middle"><ulink url="http://data.astrometry.net/debian/astrometry-data-4208-4219_0.45_all.deb">astrometry-data-4208-4219</ulink></entry>
0201                             </row>
0202                             <row>
0203                                 <entry>index-4218.fits</entry>
0204                                 <entry>1000 - 1400</entry>
0205                             </row>
0206                             <row>
0207                                 <entry>index-4217.fits</entry>
0208                                 <entry>680 - 1000</entry>
0209                             </row>
0210                             <row>
0211                                 <entry>index-4216.fits</entry>
0212                                 <entry>480 - 680</entry>
0213                             </row>
0214                             <row>
0215                                 <entry>index-4215.fits</entry>
0216                                 <entry>340 - 480</entry>
0217                             </row>
0218                             <row>
0219                                 <entry>index-4214.fits</entry>
0220                                 <entry>240 - 340</entry>
0221                             </row>
0222                             <row>
0223                                 <entry>index-4213.fits</entry>
0224                                 <entry>170 - 240</entry>
0225                             </row>
0226                             <row>
0227                                 <entry>index-4212.fits</entry>
0228                                 <entry>120 - 170</entry>
0229                             </row>
0230                             <row>
0231                                 <entry>index-4211.fits</entry>
0232                                 <entry>85 - 120</entry>
0233                             </row>
0234                             <row>
0235                                 <entry>index-4210.fits</entry>
0236                                 <entry>60 - 85</entry>
0237                             </row>
0238                             <row>
0239                                 <entry>index-4209.fits</entry>
0240                                 <entry>42 - 60</entry>
0241                             </row>
0242                             <row>
0243                                 <entry>index-4208.fits</entry>
0244                                 <entry>30 - 42</entry>
0245                             </row>
0246                             <row>
0247                                 <entry>index-4207-*.fits</entry>
0248                                 <entry>22 - 30</entry>
0249                                 <entry><ulink url="http://data.astrometry.net/debian/astrometry-data-4207_0.45_all.deb">astrometry-data-4207</ulink></entry>
0250                             </row>
0251                             <row>
0252                                 <entry>index-4206-*.fits</entry>
0253                                 <entry>16 - 22</entry>
0254                                 <entry><ulink url="http://data.astrometry.net/debian/astrometry-data-4206_0.45_all.deb">astrometry-data-4206</ulink></entry>
0255                             </row>
0256                             <row>
0257                                 <entry>index-4205-*.fits</entry>
0258                                 <entry>11 - 16</entry>
0259                                 <entry><ulink url="http://data.astrometry.net/debian/astrometry-data-4205_0.45_all.deb">astrometry-data-4205</ulink></entry>
0260                             </row>
0261                             <row>
0262                                 <entry>index-4204-*.fits</entry>
0263                                 <entry>8 - 11</entry>
0264                                 <entry><ulink url="http://data.astrometry.net/debian/astrometry-data-4204_0.45_all.deb">astrometry-data-4204</ulink></entry>
0265                             </row>
0266                             <row>
0267                                 <entry>index-4203-*.fits</entry>
0268                                 <entry>5.6 - 8.0</entry>
0269                                 <entry><ulink url="http://data.astrometry.net/debian/astrometry-data-4203_0.45_all.deb">astrometry-data-4203</ulink></entry>
0270                             </row>
0271                             <row>
0272                                 <entry>index-4202-*.fits</entry>
0273                                 <entry>4.0 - 5.6</entry>
0274                                 <entry><ulink url="http://data.astrometry.net/debian/astrometry-data-4202_0.45_all.deb">astrometry-data-4202</ulink></entry>
0275                             </row>
0276                             <row>
0277                                 <entry>index-4201-*.fits</entry>
0278                                 <entry>2.8 - 4.0</entry>
0279                                 <entry><ulink url="http://data.astrometry.net/debian/astrometry-data-4201-1_0.45_all.deb">astrometry-data-4201-1</ulink> <ulink url="http://data.astrometry.net/debian/astrometry-data-4201-2_0.45_all.deb">astrometry-data-4201-2</ulink> <ulink url="http://data.astrometry.net/debian/astrometry-data-4201-3_0.45_all.deb">astrometry-data-4201-3</ulink> <ulink url="http://data.astrometry.net/debian/astrometry-data-4201-4_0.45_all.deb">astrometry-data-4201-4</ulink></entry>
0280                             </row>
0281                             <row>
0282                                 <entry>index-4200-*.fits</entry>
0283                                 <entry>2.0 - 2.8</entry>
0284                                 <entry><ulink url="http://data.astrometry.net/debian/astrometry-data-4200-1_0.45_all.deb">astrometry-data-4200-1</ulink> <ulink url="http://data.astrometry.net/debian/astrometry-data-4200-2_0.45_all.deb">astrometry-data-4200-2</ulink> <ulink url="http://data.astrometry.net/debian/astrometry-data-4200-3_0.45_all.deb">astrometry-data-4200-3</ulink> <ulink url="http://data.astrometry.net/debian/astrometry-data-4200-4_0.45_all.deb">astrometry-data-4200-4</ulink></entry>
0285                             </row>
0286                         </tbody>
0287                     </tgroup>
0288                 </table>
0289                 <para>
0290                     The Debian packages are suitable for any Debian-based distribution (Ubuntu, Mint, &etc;). If you downloaded the Debian Packages above for your FOV range, you can install them from your favorite package manager, or via the following command:
0291                 </para>
0292                 <para>
0293                     <command>sudo dpkg -i astrometry-data-*.deb</command>
0294                 </para>
0295                 <para>
0296                     On the other hand, if you downloaded the FITS index files directly, copy them to <filename role="directory">/usr/share/astrometry</filename> directory.
0297                 </para>
0298                 <note>
0299                     <para>
0300                         It is recommended to use a download manager as such <ulink url="https://addons.mozilla.org/en-US/firefox/addon/downthemall/">DownThemAll!</ulink> for &firefox; to download the Debian packages as browsers' built-in download manager may have problems with download large packages.
0301                     </para>
0302                 </note>
0303             </sect4>
0304         </sect3>
0305 
0306         <sect3 id="ekos-align-how-to-use">
0307             <title>How to Use?</title>
0308             <para>
0309                 Ekos Align Module offers multiple functions to aid you in achieving accurate GOTOs. Start with your mount in home position with the telescope tube looking directly at the celestial pole. For users in Northern Hemisphere, point the telescope as close as possible to Polaris. It is not necessary to perform 2 or 3 star alignments, but it can be useful for some mount types. Make sure your camera is focused and stars are resolved.
0310             </para>
0311             <itemizedlist>
0312                 <listitem>
0313                     <para>
0314                         <guilabel>Capture &amp; Solve</guilabel>: Capture an image and determine what region in the sky the telescope is exactly looking at. The astrometry results include the equatorial coordinates (RA &amp; DEC) of the center of the captured image in addition to pixel scale and field rotation. Depending on the Solver Action settings, the results can be used to Sync the mount or Sync and then Slew to the target location. For example, suppose you slewed the mount to Vega then used <emphasis>Capture &amp; Solve</emphasis>. If the actual telescope location is different from Vega, it will be first synced to the solved coordinate and then Ekos shall command the mount to slew to Vega. After slew is complete, the Alignment module will repeat Capture &amp; Solve process again until the error between reported and actual position falls below the accuracy thresholds (30 arcseconds by default).
0315                     </para>
0316                 </listitem>
0317                 <listitem>
0318                     <para>
0319                         <guilabel>Load &amp; Slew</guilabel>: Load a FITS or JPEG file, solve it, and then slew to it.
0320                     </para>
0321                 </listitem>
0322                 <listitem>
0323                     <para>
0324                         <guilabel>Polar Alignment Assistant</guilabel>: A simple tool to aid in polar alignment of German Equatorial Mounts.
0325                     </para>
0326                 </listitem>
0327             </itemizedlist>
0328             <warning>
0329                 <para>
0330                     <emphasis role="bold">Never</emphasis> solve an image at or near the celestial pole (unless Ekos Polar Alignment Assistant Tool is used). Slew at least 20 degrees away from the celestial pole before solving the first image. Solving very close to the poles will make your mount pointing worse so avoid it.
0331                 </para>
0332             </warning>
0333         </sect3>
0334 
0335         <sect3 id="ekos-align-alignment-settings">
0336             <title>Alignment Settings</title>
0337             <screenshot>
0338                 <screeninfo>
0339                     Astrometry.net Settings
0340                 </screeninfo>
0341                 <mediaobject>
0342                     <imageobject>
0343                         <imagedata fileref="astrometry_settings.png" format="PNG"/>
0344                     </imageobject>
0345                     <textobject>
0346                         <phrase>Astrometry.net Settings</phrase>
0347                     </textobject>
0348                 </mediaobject>
0349             </screenshot>
0350             <para>
0351                 Before you begin the alignment process, select the desired CCD &amp; Telescope. You can explore astrometry.net options that are passed to the astrometry.net solver each time an image is captured:
0352             </para>
0353             <itemizedlist>
0354                 <listitem>
0355                     <para>
0356                         <guilabel>CCD</guilabel>: Select CCD to capture from.
0357                     </para>
0358                 </listitem>
0359                 <listitem>
0360                     <para>
0361                         <guilabel>Exposure</guilabel>: Exposure duration in seconds.
0362                     </para>
0363                 </listitem>
0364                 <listitem>
0365                     <para>
0366                         <guilabel>Accuracy</guilabel>: Acceptable difference between reported telescope coordinate and actually solved coordinate.
0367                     </para>
0368                 </listitem>
0369                 <listitem>
0370                     <para>
0371                         <guilabel>Bin X</guilabel>: Set horizontal binning of the CCD.
0372                     </para>
0373                 </listitem>
0374                 <listitem>
0375                     <para>
0376                         <guilabel>Bin Y</guilabel>: Set vertical binning of the CCD.
0377                     </para>
0378                 </listitem>
0379                 <listitem>
0380                     <para>
0381                         <guilabel>Scope</guilabel>: Set the active telescope in case you have different Primary and Guide scopes. FOV is re-calculated when selecting a different telescope.
0382                     </para>
0383                 </listitem>
0384                 <listitem>
0385                     <para>
0386                         <guilabel>Options</guilabel>: Options that are passed to the astrometry.net solver. Click the edit button <inlinemediaobject><imageobject><imagedata fileref="document-edit.png" format="PNG"/></imageobject></inlinemediaobject> to explore the options in detail.
0387                     </para>
0388                 </listitem>
0389                 <listitem>
0390                     <para>
0391                         <guilabel>Solver</guilabel>: Select solver type (Online, Offline, Remote). The remote solver is only available when connecting to a remote device.
0392                     </para>
0393                 </listitem>
0394             </itemizedlist>
0395             <para>
0396                 By default, the solver will search all over the sky to determine the coordinates of the captured image. This can <emphasis>take a lot of time</emphasis>; therefore, in order to speed up the solver, you can restrict it to only search within a specified area in the sky designated by the <guilabel>RA</guilabel>, <guilabel>DEC</guilabel>, and <guilabel>Radius</guilabel> options above.
0397             </para>
0398         </sect3>
0399 
0400         <sect3 id="ekos-align-astrometry-net-settings">
0401             <title>Astrometry.net Options</title>
0402             <para>
0403                 Options for offline and online solvers.
0404             </para>
0405             <screenshot>
0406                 <screeninfo>
0407                     Astrometry.net Options
0408                 </screeninfo>
0409                 <mediaobject>
0410                     <imageobject>
0411                         <imagedata fileref="astrometry_settings.png" format="PNG"/>
0412                     </imageobject>
0413                     <textobject>
0414                         <phrase>Astrometry.net Options</phrase>
0415                     </textobject>
0416                 </mediaobject>
0417             </screenshot>
0418             <para>
0419                 Most of the options are sufficient by default. If you have astrometry.net installed in a non-standard location, you can change the paths as necessary.
0420             </para>
0421             <itemizedlist>
0422                 <listitem>
0423                     <para>
0424                         <guilabel>WCS</guilabel>: World-Coordinate-System is a system for embedding equatorial coordinate information within the image. Therefore, when you view the image, you can hover it and view the coordinate for each pixel. You can also click anywhere in the image and command to the telescope to slew there. It is highly recommended to keep this option on.
0425                     </para>
0426                 </listitem>
0427                 <listitem>
0428                     <para>
0429                         <guilabel>Verbose</guilabel>: If the solver repeatedly fails to solve, check this option to enable <emphasis>verbose</emphasis> output of the solver to help you identify any problems.
0430                     </para>
0431                 </listitem>
0432                 <listitem>
0433                     <para>
0434                         <guilabel>Overlay</guilabel>: Overlay captured images unto the sky map of &kstars;.
0435                     </para>
0436                 </listitem>
0437                 <listitem>
0438                     <para>
0439                         <guilabel>Upload JPG</guilabel>: When using online astrometry.net, upload all images are JPEGs to save bandwidth as FITS images can be large.
0440                     </para>
0441                 </listitem>
0442             </itemizedlist>
0443         </sect3>
0444 
0445         <sect3 id="ekos-align-solver-options">
0446             <title>Solver Options</title>
0447             <para>
0448                 Ekos selects and updates the optimal options by default to accelerate the performance of the solver. You may opt to change the options that are passed to the solver in case the default options are not sufficient.
0449             </para>
0450             <screenshot>
0451                 <screeninfo>
0452                     Solver Settings
0453                 </screeninfo>
0454                 <mediaobject>
0455                     <imageobject>
0456                         <imagedata fileref="solver_settings.png" format="PNG"/>
0457                     </imageobject>
0458                     <textobject>
0459                         <phrase>Solver Settings</phrase>
0460                     </textobject>
0461                 </mediaobject>
0462             </screenshot>
0463         </sect3>
0464 
0465         <sect3 id="ekos-align-capture-and-solve">
0466             <title>Capture &amp; Solve</title>
0467             <para>
0468                 Using Ekos Alignment Module, aligning your mount using the controller's 1, 2, or 3 star alignment is <emphasis>not</emphasis> strictly necessary, though for some mounts it is recommended to perform a rough 1 or 2 star alignment before using Ekos alignment module. If you are using EQMod, you can start using Ekos alignment module right away. A typical workflow for GOTO alignment involves the following steps:
0469             </para>
0470             <orderedlist>
0471                 <listitem>
0472                     <para>
0473                         Set your mount to its home position (usually the NCP for equatorial mounts).
0474                     </para>
0475                 </listitem>
0476                 <listitem>
0477                     <para>
0478                         Select <guilabel>Slew to Target</guilabel> in the <guilabel>Solver Action</guilabel>.
0479                     </para>
0480                 </listitem>
0481                 <listitem>
0482                     <para>
0483                         Slew to a nearby bright star.
0484                     </para>
0485                 </listitem>
0486                 <listitem>
0487                     <para>
0488                         After slew is complete, click <guibutton>Capture &amp; Solve</guibutton>.
0489                     </para>
0490                 </listitem>
0491             </orderedlist>
0492             <para>
0493                 If the solver is successful, Ekos will sync and then slew to the star. The results are displayed in the <guilabel>Solution Results</guilabel> tab along with a bullseye diagram that shows the offset the reported telescope coordinates (&ie; where the telescope <emphasis>thinks</emphasis> it is looking at) vs. its actual position in the sky as determined by the solver.
0494             </para>
0495             <para>
0496                 Each time the solver is executed and returns successful results, Ekos can run on the following actions:
0497             </para>
0498             <itemizedlist>
0499                 <listitem>
0500                     <para>
0501                         <guilabel>Sync</guilabel>: Syncs the telescope coordinates to the solution coordinates.
0502                     </para>
0503                 </listitem>
0504                 <listitem>
0505                     <para>
0506                         <guilabel>Slew to Target</guilabel>: Syncs the telescope coordinates to the solution coordinates and then slew to the target.
0507                     </para>
0508                 </listitem>
0509                 <listitem>
0510                     <para>
0511                         <guilabel>Nothing</guilabel>: Just solve the image and display the solution coordinates.
0512                     </para>
0513                 </listitem>
0514             </itemizedlist>
0515         </sect3>
0516 
0517         <sect3 id="ekos-align-polaralignment">
0518             <title>Polar Alignment</title>
0519                 <para>
0520                     When setting up a German Equatorial Mount (GEM) for imaging, a critical aspect of capturing long-exposure images is to ensure proper polar alignment. A GEM mount has two axis: Right Ascension (RA) axis and Declination (DE) axis. Ideally, the RA axis should be aligned with the celestial sphere polar axis. A mount's job is to track the star's motion around the sky, from the moment they rise at the eastern horizon, all the way up across the median, and westward until they set.
0521                 </para>
0522 
0523                 <mediaobject>
0524                     <videoobject>
0525                         <videodata contentdepth="595" contentwidth="800" fileref="https://www.stellarmate.com/images/videos/polar_align.webm"/>
0526                     </videoobject>
0527                     <caption>
0528                         <para>
0529                             <phrase>Polar Alignment Assistant</phrase>
0530                         </para>
0531                     </caption>
0532                 </mediaobject>
0533 
0534                 <para>
0535                     In long exposure imaging, a camera is attached to the telescope where the image sensor captures incoming photons from a particular area in the sky. The incident photons have to strike the same photo-site over and over again if we are to gather a clear and crisp image. Of course, actual photons do not behave in this way: optics, atmosphere, seeing quality all scatter and refract photons in one way or another. Furthermore, photons do not arrive uniformly but follow a Poisson distribution. For point-like sources like stars, a point spread function describes how photons are spatially distributed across the pixels. Nevertheless, the <emphasis>overall</emphasis> idea we want to keep the source photons hitting the same pixels. Otherwise, we might end up with an image plagued with various trail artifacts.
0536                 </para>
0537                 <screenshot>
0538                     <screeninfo>
0539                         Polar Alignment
0540                     </screeninfo>
0541                     <mediaobject>
0542                         <imageobject>
0543                             <imagedata fileref="alignment_polaris.png" format="PNG"/>
0544                         </imageobject>
0545                         <textobject>
0546                             <phrase>Polar Alignment</phrase>
0547                         </textobject>
0548                     </mediaobject>
0549                 </screenshot>
0550                 <para>
0551                     Since mounts are not perfect, they cannot perfectly keep track of object as it transits across the sky. This can stem from many factors, one of which is the misalignment of the mount's Right Ascension axis with respect to the celestial pole axis. Polar alignment removes one of the biggest sources of tracking errors in the mount, but other sources of error still play a factor. If properly aligned, some mounts can track an object for a few minutes with the only deviation of 1-2 arcsec RMS.
0552                 </para>
0553                 <para>
0554                     However, unless you have a top of the line mount, then you'd probably want to use an autoguider to keep the same star locked in the same position over time. Despite all of this, if the axis of the mount is not properly aligned with the celestial pole, then even a mechanically-perfect mount would lose tracking with time. Tracking errors are proportional to the magnitude of the misalignment. It is therefore very important for long exposure imaging to get the mount polar aligned to reduce any residual errors as it spans across the sky.
0555                 </para>
0556                 <para>
0557                     Before starting the process, point the mount as close as possible to the celestial pole with the counterweights down. If you are living in the Northern Hemisphere, point it as close as possible to Polaris. If Polaris is not visible (&eg; blocked by trees or  buildings) you may point elsewhere, preferably near the Meridian. Make sure there is at least 30-60 degrees of sky viewable in an arc East or West of the Meridian from the position you choose. Select the direction of free sky, the number of degrees for each of two slews, the mount slew speed, and whether the mount will be slewing automatically (recommended) or manually.
0558                 </para>
0559                 <para>
0560                     The tool works by capturing and solving three images. After capturing each, the mount rotates by the fixed amount you entered and another image is captured and solved. If you chose manual, you will need to slew the mount by roughly the angle chosen.
0561                 </para>
0562                 <screenshot>
0563                     <screeninfo>
0564                         Polar Alignment Assistant
0565                     </screeninfo>
0566                     <mediaobject>
0567                         <imageobject>
0568                             <imagedata fileref="polar_assistant_main2.png" format="PNG"/>
0569                         </imageobject>
0570                         <textobject>
0571                             <phrase>Polar Alignment Assistant</phrase>
0572                         </textobject>
0573                     </mediaobject>
0574                 </screenshot>
0575 
0576             <sect4 id="ekos-align-platesolvecorrection">
0577                 <title>Plate Solve Correction Scheme</title>
0578                 
0579                 <para>
0580                   The images below show the workflow when the <emphasis>Plate Solve</emphasis> correction technique is used. The image below shows a display after the 3 measurement images are captured and solved. It shows an error of almost 18' in altitude and that the mount's axis needs to be moved up. Similarly it shows an azimuth error of almost 15' and that the axis needs to be moved to the right (as viewed from behind the telescope). 
0581                 </para>
0582                 <screenshot>
0583                     <screeninfo>
0584                         Polar Alignment Assistant
0585                     </screeninfo>
0586                     <mediaobject>
0587                         <imageobject>
0588                             <imagedata fileref="polar_assistant_ps1.png" format="PNG"/>
0589                         </imageobject>
0590                         <textobject>
0591                             <phrase>Polar Alignment Assistant, Plate Solve Workflow 1</phrase>
0592                         </textobject>
0593                     </mediaobject>
0594                 </screenshot>
0595                 <para>
0596                   If your error is low enough (&eg; less than an arc-minute) then you don't need to make any adjustments. Simply press stop and you're done.
0597                 </para>
0598                 <para>
0599                   If you will be making corrections to your mount's axis, you should select the adjustment approach (we're using Plate Solve in this example), and how often the system should recapture images to re-measure the polar alignment error. The refresh interval should be frequent, but it doesn't make sense to make it faster that your CPU can capture and plate-solve the images. We're using 2s in this example. Then press the <guibutton>Refresh</guibutton> button to begin the correction process.
0600                 </para>
0601                 <para>
0602                   The system will capture images, and re-estimate the polar alignment error after each image. You can try to reduce the error by adjusting the Altitude and Azimuth correction knobs on your mount. The image below shows the screen after the altitude error has been almost zeroed. See the difference between the  <emphasis>Measured Error</emphasis> row, which shows the originally measured error after the original 3 captures, and the  <emphasis>Updated Error</emphasis> row which shows the current error estimate.
0603                 </para>
0604                 <screenshot>
0605                     <screeninfo>
0606                         Polar Alignment Assistant
0607                     </screeninfo>
0608                     <mediaobject>
0609                         <imageobject>
0610                             <imagedata fileref="polar_assistant_ps2.png" format="PNG"/>
0611                         </imageobject>
0612                         <textobject>
0613                             <phrase>Polar Alignment Assistant, Plate Solve Workflow 2</phrase>
0614                         </textobject>
0615                     </mediaobject>
0616                 </screenshot>
0617                 <para>
0618                   Below the user has also adjust Azimuth to reduce the error further. Now the error is very low and the process is done. The user should press the stop button.
0619                 </para>
0620                 <screenshot>
0621                     <screeninfo>
0622                         Polar Alignment Assistant
0623                     </screeninfo>
0624                     <mediaobject>
0625                         <imageobject>
0626                             <imagedata fileref="polar_assistant_ps3.png" format="PNG"/>
0627                         </imageobject>
0628                         <textobject>
0629                             <phrase>Polar Alignment Assistant, Plate Solve Workflow 3</phrase>
0630                         </textobject>
0631                     </mediaobject>
0632                 </screenshot>
0633                 </sect4>
0634                 <sect4 id="ekos-align-move-star-correction">
0635                 <title>Move Star Correction Scheme</title>
0636 
0637                 <para>
0638                   We also have an alternative schemes for correcting polar alignment. Two variations are <emphasis>Move Star &amp; Calc Error</emphasis> and <emphasis>Move Star</emphasis>. When you select this scheme, the system place a yellow/green/violet triangle on the screen. The triangle can be moved by clicking near a star, and the yellow/violet corner is moved to that star. In this scheme the user corrects polar alignment by first adjusting the mount's azimuth knob so that the selected star moves along the yellow side of the triangle. Once the star is near the next vertex, the azimuth knob should be adjusted so that the star moves along the green side of the triangle. Once the star is moved to the green/violet vertex, the mount is polar aligned, and the user can click <emphasis>stop</emphasis>.
0639                 </para>
0640                   <para>
0641                     The difference between <emphasis>Move Star &amp; Calc Error</emphasis> and  <emphasis>Move Star</emphasis> is that in the former, the system attempts to track the star the user has selected, and places a circle around that star. In that scheme it also attempts to update the <emphasis>Updated Err</emphasis> row. If the star tracking isn't reliable, simply ignore it or use the <emphasis> Move Star </emphasis>scheme and move the star by-eye until it's close to the final target. An example of using this technique is shown in this video: 
0642                     <ulink url="https://www.youtube.com/watch?v=iOp7hrxw0oU">https://www.youtube.com/watch?v=iOp7hrxw0oU</ulink>
0643                 </para>
0644             </sect4>
0645         </sect3>
0646 </sect2>