Tools and Utilities

Manual Guide
Auto-Select Star
Calibration Details
PHD2 Server
Logging and Debug Output
Drift Alignment
Lock Positions
Comet Tracking
Guiding Assistant
Equipment Profiles
Simulator Parameters
Keyboard Shortcuts

Manual Guide




If you are connecting to a new mount and are encountering calibration problems, you will probably want to be sure that PHD2's commands are actually getting to the mount. Or you may want to nudge the mount or experiment with manual dithering.  In the 'Tools' menu, click on 'Manual Guide' and a dialog will appear to let you move the mount at guide speed in any direction. Each time you press the button, a pulse of the duration specified in the 'Guide Pulse Duration' field will be sent.  The default value is the 'calibration step-sze' set in the Advanced Options dialog.  If you are debugging calibration problems, listen to (rather than watch) your mount to determine if the mount is getting the commands from PHD2. The idea here is just to figure out if the mount is responding to PHD2's signals. You won't be able to see the mount move (it's moving at guide speed) but you may be able to hear it. Other options include watching the motors themselves or attaching a laser pointer to your scope and aiming it at something fairly far away (to amplify your motions).  If you have an adaptive optics device attached, you'll see separate move buttons for both the AO and the secondary mount.  

Dithering is used primarily with image capture or automation applications, usually through the PHD2 server interface.  However, you can do manual dithering or experiment with dither settings using the controls at the bottom of the dialog.  The 'dither' amount field at the left controls the amount the mount will be moved , in units of pixels.  You can scale this amount - i.e. multiply it by a constant - by using the 'scale' spin control to the right.  These two controls establish a maximum amount of movement that will be used for dithering - the product of 'scale' X 'dither'.  When you click on the 'Dither' button, PHD2 will move the mount by a random amount that is less than or equal to the limit you have set, in one of the north/south/east/west directions.  The 'RA Only' checkbox will constrain the dither adjustments to only east or west.  Obviously, if you are doing a manual dither in this way, you'll want to be sure your imaging camera is not in the middle of an exposure.

Auto-Select Star

Clicking on 'Auto-select Star' under the 'Tools' menu, or using the keyboard shortcut of <Alt>S, tells PHD2 to scan the current guide image and identify a star suitable for guiding.  PHD2 will try to select a star of sufficient brightness that is not near another star and not too close to the edge of the frame.  The selected star may appear overly dim on the screen, but this is usually not a problem.  You can use the Star Profile tool to examine the properties of the selected star - it should be non-saturated with a sharp profile, the same properties you should look for when choosing a guide star manually.  The auto-select process is not infallible, so you may need to select a star yourself if you don't like the automated result.  If you want to use Auto-Select, you should definitely use either a bad-pixel map or dark library to reduce the likelihood of PHD2 mistakenly choosing a hot pixel.

Calibration Details

Calibration data is saved automatically each time a calibration sequence completes successfully.  The use of the calibration data has been described elsewhere (Using PHD Guiding), including  options for restoring calibration data from an earlier time or "flipping" it after a meridian flip.  You access these functions using the 'Calibration' sub-menu under the 'Tools' menu.  Two other calibration-related items are  shown there, namely the options to clear the current data or to enter calibration data manually.  The "clear" option accomplishes the same thing as the 'Clear calibration' checkbox in the Advanced Dialog - it will force a recalibration whenever guiding is resumed.  The 'Enter calibration data' option should be used only under very unusual circumstances and only if you're sure you know what you're doing; but it is available as a matter of completeness.  If you click on the 'Enter calibration data' item, you'll see a dialog box that allows input of relatively low-level calibration data.  This data might come from a much earlier session, perhaps extracted from the PHD2 guiding log file.

Most of the calibration-related windows, including calibration sanity-checks, will open a window that looks something like this:



The first thing to look at is the graph to the left, which shows what star movements resulted from the guide pulses that PHD2 sent during calibration.  The lines represent the RA and Dec guide rates that were computed as a result of the calibration, and these lines should be roughly perpendicular.  The data points will never be perfectly aligned, but they should not have major curves, sharp inflections, or reversals in direction. Particularly with longer focal length scopes, the points will often show considerable scatter around the lines, but this is normal.  The solid points (west and north pulses) are used to compute the RA and declination rates, while the hollow points show the "return" paths of the east and south moves.  These can help you see how much fluctuation occurred due to seeing and also whether there is a significant amount of backlash.  If you are using the "fast-recenter" option in the Advanced Settings, there may be many fewer points shown in the east and north paths.  The tabular information to the right shows what was known about the pointing position of the scope and the various ASCOM settings that relate to guiding.  If you are not using an ASCOM mount and don't have an "Aux mount" specified, some of this information will be missing. The table will also show the expected guiding rates for a "perfect" calibration using the same sky position and guide speed settings you used.  You will almost never achieve these ideal values, and you shouldn't worry about them unless your values are very different.  If you didn't see an alert message when the calibration completed, your results are probably good enough.   If you want to re-use a calibration for an extended time,  it is probably worth a few extra minutes to check this information and confirm that the calibration went reasonably well and produced sensible results.  Bad calibrations can occur even for very experienced imagers using high-end mounts, so it is good to check.

PHD2 Server

PHD2 supports third-party imaging and automation applications that need to control the guiding process.  Stark Labs' Nebulosity program was the first to do this, but other applications have subsequently been produced.  By using the PHD2 server process, image capture programs can control dithering between exposures or suspend guide exposures while the primary imaging camera is downloading data.  To use these capabilities with a compatible application, you should click on  the 'Enable Server' option under the 'Tools' menu.  The server interface has been reworked substantially in PHD2, and it's now possible for an application to control most aspects of PHD2's guiding operations.  Documentation for the server API is available on the PHD2 Wiki.

Logging and Debug Output

PHD2 can optionally produce two types of log files: a debug log and a guiding log.  Both are highly useful for different reasons.  The guiding log is similar to the one produced by PHD, but with extended information. The guide log is intentionally formatted to allow easy interpretation by either a human reader or an external application.  For example, the very capable PHDLogView application (not part of the PHD2 release) can produce a variety of graphs and summary statistics based on data in the PHD2 guide log.   But the log can also be easily imported into Excel or other applications for analysis and graphing.  When importing into Excel, just specify that a comma should be used as a column separator.  The debug log has a  complete record of everything that was done in the PHD2 session,  so it is very helpful in isolating any problems you  have.  It also employs a human-friendly (albeit verbose) text format, so it's not difficult to examine the debug log to see what happened.  If you need to report a problem with the software, you will almost certainly be asked to provide the debug log file.  If you have neither log file available, you are unlikely to get any help.  Creation of these log files is controlled by the two menu items under the 'Tools' menu, and these should be left "checked" as a normal practice.

The location for the files is controlled by the 'Log File Location' field in the 'Global' tab of the 'Advanced Settings' dialog.  By default, log files are stored in the OS-specific default directory for application data files.  In Windows7, for example, the files will be stored in a 'PHD2' sub-folder in the "AppData\Local" location.  This may not be a convenient location, so you can specify a different folder using this edit field.

In some unusual cases, you may need to capture guide camera images, usually to support debugging and problem resolution.  This can be done by clicking the 'Enable Star Imaging Logging' menu item under the 'Tools' menu.  The resultant image files will be stored in the same location as the other log files.  The format of these image files is controlled from the 'Global' tab of the 'Advanced Settings' dialog.  If you are trying to document a problem you're having, you should choose the 'Raw Fits' format for maximum flexibility.

Drift Align

Drift alignment is a well-known technique for achieving polar alignment and is considered by many to be the "gold standard".  The Drift Alignment tool is a wizard-like sequence of dialogs that can help you work through the drift alignment process and get quantifiable results.  Once you've calibrated your guider, click on 'Drift Align' under the 'Tools' menu.  The first Drift Align dialog will appear to help you adjust the azimuth on your mount.  If you are using an ASCOM mount, you'll have the option of slewing to an area near the celestial equator and the celestial meridian.  If you're not using an ASCOM mount, you'll need to slew to that location manually.  Once the scope is positioned and you have a suitable star in the field of view, click on the 'Drift' button to begin collecting data.  You'll see the graph window with a display of star deflections and corrections and, more importantly, two trendlines. When the mount is precisely polar aligned in azimuth, the Declination trend line will be perfectly horizontal.  Let the exposures continue until the declination trendline has stabilized and is no longer jumping around with each new exposure.  At the bottom of the graph window, you'll see a measurement for the polar alignment error in azimuth. And, in the image window, you will see a magenta circle around the guide star. The circle indicates an upper limit on how far the guide star needs to move when azimuth is adjusted. (Initially, the circle may be too large to be visible on the screen, so you may not see it until your alignment gets closer.)

Now click on the 'Adjust' button to halt guiding, then make a  mechanical adjustment in azimuth. Watch the guide star as you make the adjustment, moving the guide star towards the magenta circle, but not beyond it. Once done, click on the 'drift' button again to repeat the measurement. If your adjustment was in the right direction and did not over-shoot, the Declination trendline will be closer to horizontal.  Continue iterating in this way until you are satisfied with your azimuth accuracy.  You can use the 'notes' field to record which way the drift line moves depending on how you make the adjustment.  For example, you might note that a counter-clockwise turn of the mount azimuth knob moves the drift line "up."  Since these notes are retained across PHD2 sessions, subsequent drift alignments will probably proceed more quickly.

Until you are experienced with drift aligning your particular mount, the 'adjustment' part of the process can be a bit tedious.  At first, you'll have to determine how to adjust a knob on the mount to achieve the desired effect: "how much" and "what direction."  To help with this, the PHD2 drift align tool supports "bookmarks".  These are a handy way to record the positions of the guide star before and after you've made an adjustment.  Bookmarks are accessed using the Bookmarks menu, or keyboard shortcuts, as follows:
By setting a bookmark before you make a mount adjustment, you can get a clear view of how the adjustment has moved the star on the guide frame.

Next, click on the 'Altitude' button.  Then slew the scope to a position near the celestial equator and 25-30 degrees above the horizon.  Click on the 'drift' button to begin collecting data for the altitude part of the alignment process.  As before, you will iterate between making adjustments and measuring your alignment until you are satisfied with the result, keeping notes as you go about how mount adjustments affect the behavior of the declination drift line.  If you make substantial adjustments in altitude, you'll need to go back to the 'azimuth' measurement and repeat that procedure.  If you work through these procedures systematically, you'll converge on a good polar alignment with a known degree of accuracy.  A good polar alignment will help your guiding performance, especially in declination.

The drift alignment tool is easiest to use when you are using an ASCOM connection to your mount (including an 'Aux' connection).  Even if you subsequently want to use ST-4 style guiding, you should use the ASCOM connection for drift alignment.  If you can't do that for some reason, the following features will be impaired:
A very complete step-by-step tutorial for drift alignment is available on the Openphdguiding web site, and first-time users are strongly encouraged to study it. (https://sites.google.com/site/openphdguiding/phd2-drift-alignment)

Lock Positions

PHD2 normally sets a 'lock position' where the guide star is located at the end of calibration.  Depending on the details of the calibration sequence, this may not be exactly where the star was located at the start of calibration - it could be off by a few pixels.  If you are trying to precisely center your target, you may want to use a 'sticky lock position.'  You do this by clicking on your guide star before calibration, then setting the 'Sticky Lock Position' under the 'Tools' menu.  After calibration is complete, PHD2 will continue to move the mount until the star is located at the sticky lock position.  So you may see an additional delay after the calibration while PHD2 repositions the scope at guide speed.  The sticky lock position will continue to be used even as guiding is stopped and subsequently resumed.  Again, this insures a rigorous positioning of the guide star (and presumably your image target) at the expense of delays needed for PHD2 to reposition the mount.

Comet Tracking

One way to image a comet is to have PHD2 use the comet as the guide "star", but this approach may not always work. For example, the head of the comet may not present a star-like center suitable for guiding. Or, when using an off-axis guider, the comet may not even be visible in the guide camera.

PHD2 provides a Comet Tracking tool for use when guiding on the comet itself is not feasible. The idea is to guide on an ordinary star, but to gradually shift the lock position to match the comet's motion, or tracking rate.

There are a three different ways to provide the comet tracking rate to PHD2.






To enter the rate manually, you would select "Arcsec/hr" for units and "RA/Dec" for axes, then enter the rates from the comet's ephemeris.

Comet rate training works like this:

First, center the comet in your imaging camera. If your imaging application has some kind of reticle display, you should use that to note the precise position of the comet on the imaging sensor. Once this is ready, select a guide star in PHD2 and start guiding. Next click "Start" in the Comet Tracking tool to begin training.

Take a continuous series of short exposures in your imaging camera using your imaging application's Frame and Focus feature. Over time, the comet will drift away from the starting location. Use PHD2's "Adjust Lock Position" controls to move the comet back to the starting location. You may have to experiment a bit to determine which way the comet moves on the imaging camera sensor in response to the Up/Down/Left/Right controls in PHD2. You may find it useful to enable the "Always on top" button in the Adjust Lock Position window so the controls stay visible on top of your imaging application.

PHD2 will quickly learn the comet tracking rate as you re-center the comet. Once you are satisfied that PHD2 is tracking the comet, you can click Stop to end the training. PHD2 will continue shifting the lock position to track the comet until you disable comet tracking by toggling the Enable/Disable button.

You can practice the comet training technique using the built-in camera simulator. Check the "Comet" option in the Cam Dialog, and the simulator will display a comet. Use a bookmark to mark the comet's starting location, and use the Adjust Lock Position controls to move the comet back to the bookmark location.

Guiding Assistant

The Guiding Assistant is an instructional tool to help you measure current seeing conditions and the general behavior of your guiding subsystem.  When it is run, it temporarily disables guiding output and measures the ensuing motion of the guide star. This can help you see the high-frequency motions caused by seeing (atmospheric) conditions.  These cannot usually be corrected by conventional guiding because they occur at a much higher frequency than you can typically even measure. Trying to correct for them with conventional guiding is often called "chasing the seeing" and is not recommended.  Avoiding it is best accomplished by setting a minimum-move level that will cause PHD2 to ignore most of this high-frequency behavior.  The Guiding Assistant can also show you other behavior of your system such as overall drift rates in right ascension and declination as well as peak-to-peak and maximum-rate-of-change measurements in right ascension,.  While these things can usually be "guided out", measuring them can be helpful if you want to improve the underlying performance of the mount - for example, by improving your polar alignment if the declination drift rate is high.

When the Guiding Assistant is first started, you'll see a dialog box like this:



The upper message area in the Guiding Assistant dialog-box displays usage instructions, much like a wizard interface.  In order for the Guiding Assistant to start measurement, you first need to start guiding in the usual way.  This identifies the target star in the frame and enables (but does not start) the underlying data collection mechanism.  You then click 'Start' in the Guiding Assistant to begin the measurement process.  Once you do this, guiding commands will be disabled, so the star will appear to wander around on the display - this is entirely normal.  As guider images are acquired, statistics are computed and displayed in real-time in the user interface. Of particular interest are the table entries in the "High-frequency Star Motion" section which show ongoing results of the averaging process.  After about one minute of data collection, these numbers will usually stabilize and you'll have a reasonable measurement of the high-frequency star movement caused by seeing conditions.  When you click the 'Stop' button, guiding commands will be re-enabled and the data collection process will end.  Other computed results will then be displayed in the lower area of the table showing overall drift rates and various other measurements.  All of these values are displayed in units of both arc-seconds and pixels.  The dialog box will look something like this:



The contents of the 'Recommendations' group at the bottom of the window reflect the results of the high-frequency measurements.  Assuming your chosen guide algorithms support a minimum-move property, you have the option of automatically setting those parameters based on the results.  You can also decide to re-run the measurements or close the dialog box altogether if you want to proceed with normal guiding operations.  Over time, we may be able to add recommendations regarding other guiding properties.

Managing Equipment Profiles

Equipment profiles were introduced in the section on Basic Use where they are used as part of the 'Connect Equipment' dialog.  If you want to manage multiple profiles, you will probably want to use the 'Manage Profiles' button in the 'Connect Equipment' dialog.  Using the menu items there, you can create a new profile or edit/rename/delete an existing one.  Each profile holds all the settings that were active at the time the profile was last used.  If you create a new profile, you can import these settings from either the PHD2 generic defaults or from an existing profile.  You can also use the 'Wizard' option to have PHD2 establish settings that are specific to your equipment configuration.  To edit the settings in an existing profile, you first select it in the equipment profile drop-down list, then click on 'Settings' under the 'Manage Profiles' pull-down.  This will take you to the 'Brain' dialog, where you can make whatever changes you want.  Remember than profiles are automatically updated anytime settings are changed during a PHD2 session.  Finally, you can import and export profiles for purposes of debugging, backup, or even exchange with other PHD2 users.

Advanced Settings for the Simulators

The device simulators were introduced in the Basic Use section as useful tools for you to experiment with PHD2 and become famliar with its features.  Remember that you must choose 'Simulator' as the camera type and 'On-camera' as the mount type in order to get the benefits of simulation.  As you become more interested in the details of the simulation, you can use the 'Cam Dialog' button on the main display to adjust the simulation parameters:




You can adjust simulated mount behaviors for declination backlash, drift due to polar mis-alignment, and periodic error.  You can also adjust the 'seeing' level, which will create fairly realistic guide star deflections that look like seeing effects.  If you adjust these parameters one-by-one, you'll see how they affect star deflections and how the different guide algorithms react to those movements.  Of course, you're dealing with a "nearly perfect" mount in these scenarios (except for backlash), so the simulation can't be entirely realistic.

Keyboard Shortcuts

Keyboard shortcuts are available for many of the more commonly used tools and functions in PHD2.  These are enumerated in the Keyboard Shortcuts section.