Imaging Planner Tool

Planification d'acquisition

The Imaging Planner tool assists users in selecting objects to image. Users can download catalogs of recommended objects, and may create and share their own catalogs. The tool calculates when objects in a catalog may be imaged on the selected night, given constraints such as minimum altitude, terrain, and moon elevation and separation. It can sort the objects along several dimensions including the number of hours an object may be imaged tonight (given the user's geography, constraints and possibly artificial horizon), the object's peak altitude, distance from the moon, constellation, name, and type. Objects can also be filtered out for several reasons (e.g., object type, whether it was previously imaged, keywords, whether the object has been selected, or if the user is uninterested). This tool aids object selection by displaying high-quality images, showing sky locations on the skymap, and providing links to follow to internet sites with more information and images. It allows attaching notes and links to objects, and selecting them for future consideration. This tool can be used with Ekos or other imaging tools, but does not directly interact with the imager; it helps the user decide what to image.

Setting up the Imaging Planner

The Imaging Planner tool can be used with KStars/Ekos or other astrophotography software. This section provides setup instructions, if you are new to KStars. Existing KStars users may find the initial steps unnecessary.

  1. Download KStars
  2. Run KStars for the first time

    • The Startup Wizard appears when you run KStars for the first time. You can also access it from Settings → Startup Wizard.

    • Setup your geography in the Startup Wizard.

    • Click Download Extra Data.

    • If you are running KStars 3.7.6 or later, the only required Imaging Planner download is the Imaging Planner catalog (see image). It should say Catalog 2... or later. Imaging Planner Catalog Download

    • If you are running earlier versions, it's recommended to also download the NGC/IC, Open NGC, Abell, Sharpless, Hickson, and Lynds catalogs to greatly speed up the time it takes the Imaging Planner to start up for the first time.

    • In either case, you can also download any other catalogs you may want.

  3. Setup your Artificial Horizon file (optional, but nice)

    • Your horizon file should be formatted as follows, where the lines starting with # are just comments and are optional, SideNearFence can be replaced by whatever you want to call your horizon, and the other lines have two floating point numbers for azimuth and altitude. This format is likely similar or identical to the horizon file format used by other imaging software:

      # KStars Artificial Horizon export
#
Horizon SideNearFence
67.6236 22.7211
71.4942 21.7769
73.8178 20.6722
...

    • Go to Settings → Artificial Horizon. Click the icon that's the 5th from the left (if you hover your mouse over it, and it should say "Import a previously exported horizon file").

    • Navigate to your horizon file and select it.

    • Click Apply and then click Close.

  4. Change your theme (Optional)

    • If you prefer a darker theme, go to Settings → Themes and select Black Body.

  5. Running the planner for the first time

    • Go to Tools → Imaging Planner

    • The planner will start, but may prompt you to load a catalog

    • If you need a catalog or aren't using the most recent catalog (e.g. the 770-object Catalog2) that was uploaded in the Download Extra Data section above, then find and click Load Catalog on the right side of the Imaging Planner.

      • It should bring up an Open file menu starting with a folder where you should be able to find Imaging Planner catalogs. Currently the latest catalog is in a folder called ImagingPlanner-catalog2.

      • Double click that folder, and it should bring you to a folder where you should be able to find all.csv.

      • Select (single click) all.csv and click Open. It should grey out the Imaging Planner, and start loading the catalog's data. This load can take several minutes when first adding a catalog on KStars versions before 3.7.6. The delay should be much shorter on and after 3.7.6.

      • These long delays should only happen the first time you run the Imaging Planner tool. You will see a note near the top that keeps updating, saying things like 13/66 adding Arp 240.

    • If you have a catalog, or you've completed loading one, the Imaging Planner is ready for use.

    • Subsequent startups should be much faster, with your choices remembered.

  6. Using the Imaging Planner

La table des objets

The Object Table, which occupies most of the left side of the Imaging Planner tool, displays a list of objects from the loaded catalog, excluding any that have been filtered out (see the Filters section below). The table's columns display various attributes. Select a row to see details, an altitude graph, and an image on the right.

The table sorts by imaging hours by default. Click a column header to sort by that column. Click again to reverse the sort order.

Right-clicking a row opens a menu of operations. Select multiple rows using "click then shift-click". The right-click menu can operate on all selected rows, adding attributes to the objects. Choices are:

  • Choisir l'objet sélectionné. On peut choisir plusieurs objets en même temps. Marquer un objet permet de n'afficher plus tard que les objets choisis plutôt que toute la table. Par exemple, après avoir passé du temps à rechercher des objets et quand un candidat intéressant est trouvé, il peut être marqué pour être étudier plus tard. Et ainsi de suite. On peut ensuite filtrer les objets par marque pour n'afficher que cette liste (voir Filtres plus bas).

  • Marquer un objet déjà photographier. On peut à nouveau ajouter cet attribut et ensuite filtrer pour ne pas les afficher (ou n'afficher que ceux-ci).

  • Marquer un objet à ignorer. Similaire à marquer les objets déjà photographiés.

  • Centrer l'objet sur la carte du ciel de KStars. Cela ne fait sens que si le centrage automatique a été désactivé dans le menu des options.

  • Screenshot. This is a more complex operation described in the screenshot sub-section below.

Objects that are marked as imaged are displayed with a different background color as the other images in order to distinguish them. This tool doesn't automatically know that you've imaged an object, e.g. because you may have imaged it with KStars/Ekos. Rather you must explicitly mark an object as imaged using the menu, or use the Load Imaged button in the Filters section.

Les objets choisis sont également affichés différemment. Ils sont affichés en gras et italique et soulignés pour bien les distinguer.

La ligne au-dessus de la table affiche le nombre de lignes dans la table et le nombre total d'objet dans le catalogue chargé. Ce nombre peut être différent si certains objets sont filtrés. Il y a aussi une boite de recherche permettant de rechercher un objet qui se trouve dans la table.

Screenshots

You may want to place a nice finished example of a target you are considering on the SkyMap. This could be, for example, an image you admire on Astrobin. This could be useful to later help you frame your planned capture. One can do this using the image overlays capability. However, you can shortcut this procedure if all you want to do is create a temporary overlay (this session only). A demonstration video of this process can be found here and is summarized below:

  • Find a nice large example of the image you want to overlay and open up that web page so it's visible on your screen.

  • Go back to the Imaging Planner tool and right click on the object in the object table. There select the bottom option Screenshot.

  • Your mouse cursor will change to the screenshot cursor. (You can use the Escape keyboard character if you want to cancel this operation.)

  • Using keyboard commands (not the mouse) navigate back to the nice image, move your mouse in the upper left corner of the image you wish to screenshot, press down and drag the mouse to the bottom right corner of that image, and then release the mouse. If you don't know how to navigate to the image display with keyboard commands, you'd need to adjust the sizes of the nice image display and the imaging planner tool such that both fit on your screen unobstructed.

  • If all has gone well, a window will pop up with a Solve button. Click on Solve. This step can be automated by checking the Start Solving Immediately checkbox in the hamburger menu in the upper right corner of the main Imaging Planner window.

  • If the image was solved, the SkyMap should now be displayed with your example image placed correctly. You may need to zoom-in to see it if your view is zoomed out too far.

Date, Heure et Géographie

La date d'analyse peut être modifiée en haut à droite de l'outil. On peut avance ou reculer d'un jour avec le bouton de droite. On peut également saisir une date arbitraire dans la boite en saisir manuellement une date. L'illumination de la Lune est affichée à gauche de la date.

The time used (e.g. for the object's position in the skymap) and the geography/location used to determine an object's sky position are taken from the values being used in by KStars. To change your location, go to the Settings → Geographic menu. To change the current time, go to the Time → Set Time... menu.

Options et Aide

Il y a deux boutons à droite du contrôle de la date.

  • Le bouton d'options ouvre un petit menu d'options. Actuellement, le menu contient deux cases à cocher. La première contrôle si le système déplace la carte du ciel de KStars vers les coordonnées d'un objet lorsqu'il est sélectionné dans le tableau. La deuxième détermine si l'outil est une fenêtre indépendante (c'est-à-dire qu'elle peut passer derrière ou devant d'autres fenêtres de KStars) ou si elle reste toujours devant la fenêtre principale de KStars.

  • Le deuxième bouton, lorsqu'il est cliqué, ouvre ce manuel KStars dans un navigateur web.

Information sur l'objet

La section des informations sur l'objet, située en haut à gauche de l'outil, affiche des informations sur l'objet sélectionné. Cliquez sur un objet pour voir cette section se remplir.

  • La première ligne doit afficher le nom principal, le type d'objet et la taille de l'objet.

  • La deuxième ligne doit afficher tous les noms alternatifs de l'objet.

  • La troisième ligne donne des informations sur le transit et la séparation de la Lune.

  • La dernière ligne vous permet d'ajouter des notes sur l'objet. Ces informations sont enregistrées de session en session par KStars dans sa base de données MySQL et sont associées au nom de l'objet. Vous pouvez modifier ces notes en cliquant sur l'icône de crayon à gauche de la ligne Note. Si vous ajoutez jusqu'à trois URL dans la note (rappelez-vous d'utiliser http ou https au début de l'URL), elles devraient être automatiquement détectées, et une icône pour les parcourir sera ajoutée à la ligne des Notes. Si la note est trop longue pour la section Informations sur l'objet, vous pouvez toujours voir la note complète en cliquant sur le bouton de crayon.

Le graphique d'altitude

L'altitude de l'objet actuellement sélectionné est tracée dans le graphique Altitude en fonction du Temps. Le graphique s'étend de peu avant le coucher du soleil à peu après le lever du soleil. Vous remarquerez un fond sombre pendant la nuit. Vous pouvez également observer un motif hachuré indiquant l'illumination de la Lune en arrière-plan. L'altitude est tracée en blanc, mais une ligne verte plus épaisse est superposée pour indiquer les moments où l'objet peut être imagé selon vos contraintes. Ainsi, si vous ne voyez qu'une ligne d'altitude blanche, l'objet ne peut pas être imagé. Si vous voyez une ligne verte, ce sont les moments et altitudes où l'objet peut être imagé. Si vous cliquez sur le graphique, vous verrez l'altitude de l'objet sélectionné affichée dans le coin supérieur gauche du graphique.

Imaging Planner Graph

In the above graph screenshot, the X axis corresponds to the nighttime between about 20:30 in the evening and 05:30 in the morning. The white line is a plot of the altitude of the selected object (which happened to be NGC 6384, not displayed). The superimposed bright green line shows it is imageable between a little after midnight until about 4:20am. The blue background on both sides of the graph correspond to just before and after astronomical twilight. The hashing shows some moonlight between sunset and almost 2:30am. The user clicked on the graph where (on the X axis) it was 10:18pm, and at that time the object's altitude was 9.6º.

Contrainte d'acquisition

L'outil de planification d'acquisition calcule quand, pendant la nuit, les objets peuvent être photographié. Plusieurs contraintes affectent ce calcul. Certaines sont définies dans cet outil, et quelques-unes sont des paramètres de KStars/Ekos qui peuvent nécessiter des modifications.

  • L'altitude minimale en degrés à laquelle un objet peut être photographié est indiquée dans la case Min alt. Si vous changez cette valeur, vous devriez voir la colonne des Heures recalculée dans le tableau des objets, ainsi que le graphique mis à jour dans la section Informations sur l'objet.

  • De manière similaire à l'altitude, vous pouvez modifier l'angle minimal de séparation de la Lune en degrés.

  • If the artificial horizon checkbox is checked, then artificial horizon constraints are used to calculate the possible imaging times. The artificial horizon are the parts of the sky that are blocked from imaging by buildings or trees or the like at your telescope's location. The artificial horizon is set up elsewhere in KStars (see Setting Menu and go down to Settings → Artificial Horizon) and at its simplest is a list of azimuth and altitude values. If you make use of this tool and image from an area where significant parts of the sky is blocked, it is recommended you set up and use the artificial horizon feature. Associated with the artificial horizon is the SkyMap's terrain feature. If you set up your terrain image, then when the Imaging Planner tool displays the object on the SkyMap, you will see when it is relative to your local environment. Of course, you'd need to set a realistic imaging time--that is, if you plan during the daytime and the tool is locating objects at the current time, then the object may be set or behind buildings or trees.

  • KStars/Ekos uses astronomical twilight times to constrain imaging times. Using the defaults will result in no imaging outside of astronomical twilight times. If you wish to adjust this please see the constraint in the Ekos Scheduler's Offset menu--change the Dusk Offset positive to start imaging later, and negative to start imaging earlier. Similarly change Dawn Offset positive to continue imaging longer, and negative to stop imaging sooner. These controls can be found by selecting Tools → Ekos and then clicking on the Scheduler tab (2nd from the left), clicking the Options button on the bottom right, and the offset tab on the top-left.

Filtres

Il existe plusieurs façons de filtrer les objets affichés dans le tableau des objets du planificateur d'acquisition. Le filtrage des objets les retire du tableau, mais ils peuvent être retrouvés à nouveau en modifiant le filtre. Notez que la section des filtres peut être masquée ou affichée en cliquant sur le petit bouton à gauche de la section des filtres.

  • Items can be filtered by how many hours they are image-able this night. Change the value in the Min Hours box, and objects with fewer hours than that value will not be displayed.

  • Cocher ou décocher l'un des types d'objet fera en sorte que les objets de ces types soient affichés ou non.

  • Picked: Checking Picked will cause only "picked" objects to be displayed. Similarly checking "Not Picked" will cause only objects not picked to be displayed. Checking Don't Care in the picked line will cause the picked-status to be irrelevant in whether an object is filtered from the table.

  • Similar to picked, Imaged causes objects labeled as previously imaged to be displayed or not.

  • Ignored causes objects labeled as "Ignored" to be displayed or not.

  • Keyword searches inside the Notes the user has added to the object, and is "true" if it sees a word in the note that matches the keyword (see the Object Information section above).

The Load Imaged button in the Imaged row of the Filters section allows you to load an already-imaged file. This file is a simple list of object names, one per row, that you can construct and load. Loading this will cause the tool to remember those object names and mark them as already imaged when it encounters them. If you wish to undo this action, the way to do that is to set the filters to just show imaged objects and then use the right-click/control-click menu to set the desired objects as not imaged. You can speed that up by selecting many objects at a time with the click then shift-click technique.

Image de l'objet

Si disponible, une petite image de l'objet actuellement sélectionné est affichée. Cliquer sur l'image, la ligne de crédit de l'astrophotographe ou la ligne URL ouvrira un navigateur avec le lien fourni vers l'image complète, si un lien a été fourni.

Note that the Load Catalog button is also in this section.

Configuration de KStars pour le planificateur d'acquisition

Il existe plusieurs façons de configurer KStars pour améliorer votre expérience avec cet outil.

  • The most important thing to do is go to Data → Download New Data... and download a catalog associated with this tool. The first time you use this tool you'll need to click on the Load Catalog button and load the downloaded catalog. The tool should automatically download the catalog in subsequent runs.

  • Another important thing to do if you are running earlier versions of KStars (pre 3.7.6), also in the above Data → Download New Data... menu, is to download some deep-sky object catalogs. In particular the NGC IC, OpenNGC, Sharpless, Abell, Lynds and Hickson catalogs would be handy. You can run the Imaging Planner without these (small) downloads, but the start-up time on the first time you use this tool will be much longer if you don't download them.

  • Lisez la section des Contraintes d'acquisition ci-dessus et suivez les suggestions qui y sont présentées, afin que cet outil puisse mieux prédire combien de temps un objet peut être acquis durant la date sélectionnée.

  • Les objets sélectionnés peuvent être automatiquement centrés dans l'affichage de la carte du ciel. Si cet affichage est utile, vous pouvez ajuster le zoom afin qu'il soit proche du champ de vision de votre appareil d'acquisition. Les éléments ci-dessous s'appliquent également à cet affichage de la carte du ciel.

  • Vous pouvez également définir l'heure dans KStars pour refléter quand vous effectuerez l'acquisition. Voir le menu Heure.

  • If you don't set the time, you may want to hide the terrain display (if you've set that up) and also not render the ground, as those may obscure the object. You show and hide the terrain display in the view menu, and the ground can be disabled in Settings → Guides with the Opaque Ground checkbox.

  • If you're using a HiPS-based skymap, you would likely want local copies of the DSS data to speed-up the rendering of the SkyMap. See View → HiPS All Sky Survey and under there HiPS Settings... → Cache and enable the cache and enter the location of your local copy of the data. The data is available on https://irsa.ipac.caltech.edu/data/hips/CDS/DSS2/color/Norder1 ... /Norder7 and another resource is https://coochey.net/?p=699

  • It would be useful to create a custom SkyMap "FOV Symbol" which is the same as the field-of-view of your imager. See Settings → FOV Symbols, and inside there select New → Camera, and enter the focal length of your optics and the camera's specifications.

  • You may want to adjust the color theme, e.g. in Settings → Themes to Black Body if you like dark themes.

Catalogues

KStars currently provides a single imaging-planner catalog via the Data → Download New Data... menu item. The hope is that there will be future specialized catalogs, and possibly user-generated catalogs too. Therefore the catalog is formatted in a human-readable way.

Format du catalogue

Le format est actuellement un fichier séparé par des virgules avec un objet par ligne.

  • The first column is an object ID--which is the kind of ID that would work with the KStars Find Object tool.

  • La deuxième colonne est un nom de fichier (par rapport à l'emplacement du catalogue) où une image approximative de l'objet en jpeg 300x300 peut être trouvée.

  • La troisième colonne est le nom du photographe de l'image.

  • La quatrième colonne est un lien vers une version plus grande de l'image.

  • La cinquième colonne est la permission de licence Creative Commons pour utiliser l'image (par exemple, « ACC » signifie « Attribution Creative Commons », « ANCSACC » signifie « Attribution Non-Commercial ShareAlike Creative Commons », en utilisant les mêmes conventions que le site Astrobin.com).

Pour ajouter un objet sans image, il suffit d'ajouter l'identifiant de l'objet sans virgule suivante, ou un identifiant d'objet avec 4 virgules suivantes, comme l'une de ces lignes (sans guillemet) : « M 42 », ou « M 42,,,, ». Un exemple de ligne complète pourrait être : « M 42,M_42.jpg, Hy Murveit, https://www.astrobin.com/x4dpey/, ACC ».

Il existe quelques autres lignes spécialisées possibles :

  • Les lignes commençant par # sont des commentaires.

  • Les lignes contenant « LoadCatalog RELATIVE_CATALOG_FILENAME » signifient que le contenu de « RELATIVE_CATALOG_FILENAME » doit être lu comme s'il faisait partie de ce fichier de catalogue.

To add custom objects, create a .csv file (e.g., on your desktop). The first line should reference the existing catalog with LoadCatalog. Subsequent lines list your objects. Then, use Load Catalog on your new .csv file.

Chargement des catalogues

  • Catalogs read in from Data → Download New Data... are stored in the standard KStars data directory, but catalogs can be read in from anywhere.

  • Use the Imaging Planner's Load Catalog button to read in a new catalog.

  • Lorsqu'un catalogue est chargé, le catalogue précédent est supprimé.

  • Lorsque l'outil démarre, il charge le dernier catalogue chargé lors de la session précédente.