• General
  • Why does this FAQ exist?
    Stark Labs is one guy who does this in his spare time (me). I've got a full-time job (research professor working in the cognitive neuroscience of memory) and a family with a wonderful wife and two little kids. What that means is that resources are limited. I love helping users and answering questions, but let's face it... every time I'm answering an e-mail with the same answer, I'm spending time that I could be spending fixing bugs or adding features.

    So, this FAQ is here to help me help the users and to help users help themselves.
  • Nothing in here answers my question - where else should I go?
    There are a number of places to turn if your question isn't answered here:

    - The Stark Labs Yahoo Group is a user-run group with a lot of great folks willing to help out. I’m there occasionally as well.
    - The Wiki has a FAQs for PHD Guiding and Nebulosity, a new user-guide for Nebulosity, and a lot of other great information.
    - There are tutorials and walk-throughs for PHD Guiding and Nebulosity here on the site.
    - There is a lot of good stuff in the blog
    - There are pre-release versions of software that may fix problems you’re having.
    - If you think you’ve got a bug, you can fill out a bug report
  • Purchasing and Delivery
  • Why hasn't my license code arrived?
    The license codes are sent out automatically and typically arrive within a few minutes (Note, this is not true for upgrades). If you did not receive your code, this is typically the result of either some form of filter on your end or a mismatch between the address you check and the PayPal address. About two or three times a year, I find that something went wrong in the system and although a payment was made, the license didn't get mailed out. About once a week, a customer never gets the code and yet I've gotten the Cc of the e-mail that went out. If that's the case or if you've lost your code, head to the Missing Code page.
  • Why hasn't my CD arrived?
    Delivery is electronic and no CD is ever mailed. Several dealers exist that can provide you with a CD (and I can in a pinch), but the vast majority of sales are electronic. You will receive a license code that will turn the demo version into the full version.
  • Do I have to have a PayPal account to purchase software or make a donation?
    No. PayPal handles my credit card transactions, but you can purchase with a credit card and without ever setting up a PayPal account. On the purchase page, you will see a section that says "Don't have a PayPal account? Use your credit card or bank account". Follow the link there. In addition, you can always pay by mail.
  • Can I pay by any other means?
    Yes. Personal checks and money orders are accepted as well. It will take longer, but you do not need to do anything by electronic payment. You can send money to:

    Craig Stark
    Stark Labs
    9 Pauling Ct.
    Irvine, CA, 92617
  • Do I need two license codes for two copies of Nebulosity?
    No, you do not as long as you are only running one at a time. See here for a bit more info.
  • Nebulosity Issues
  • Nebulosity keeps asking for my registration code. What the heck?
    For some users (and I wish I knew why), the "preferences" Nebulosity uses get mucked up when they first install a full version. The result is that the dialog keeps appearing asking them to enter their Nebulosity 2 license code. Assuming you're entering the code correctly (complete with dashes), the problem is a known one and the solution for you is a simple one-time affair.

    On the Mac:
    Go into your home folder, in Library, Preferences. You'll find a "Nebulosity Preferences" document in there. Double-click on it to open it up with Text Edit. Delete one of the two "Code" entries and save. You should then be all set.

    On a PC:
    1) Start, Run, enter "regedit"
    2) Navigate to: HKEY_CURRENT_USER\Software\StarkLabs\Nebulosity
    3) Is there an entry there for "Code2"? If so and if there is one in Preferences beneath this, delete it. For grins, delete "Code" if you see it there too (perhaps write that one down – it's your Neb1 code)
    4) Fire up Neb2 and it'll ask for the Neb2 code. Enter it and make sure there are no spaces on either side and that you have the dashes in there (I copy/paste it personally).
    5) If you exit now and restart, it should work.
  • Can I install Nebulosity on more than one machine? How do I transfer my license to another machine?
    Yes, you may. The license stipulates that you may only use it on one machine at a time. It reads (in part):

    You may install and use the software on another computer, but the software should not be in use on more than one computer at a time unless you purchase additional licenses (e.g., a laptop used for image collection and a desktop used for subsequent image processing). You may make back-up copies of the software for archival purposes. You may permanently transfer your license to use the software to another party who will be bound by this agreement, provided you do not retain any copies of the software.

    To do this, simply install Nebulosity on the second machine and enter the license code there. There is no "activation routine", you don't need to be connected to the Internet, and you don't need to talk to a customer support representative and promise your next born child.
  • What driver should I use for the QHY8?
    There are no fewer than 4 drivers / ways to connect to the QHY8 in Windows.  Each driver has a different pull-down in Nebulosity's menu and you must make sure you've got the right system drivers for the pull-down you're trying to use ("system driver" being what is installed when you plug the cam in and you get the USB chimes).

    QHY8: Current drivers from QHY: 
    http://qhyccd.com/files/QHY8-0906.rar
    CCD Labs Q453: Drivers from CCD Labs (original QHY drivers)
    QHY8 TVDE: Now unsupported drivers from Tom van den Eede (
    www.astrosoft.be)
    ASCOM: ASCOM driver (e.g., from 
    www.astrosoft.be)

    In addition, there are now "WinUSB" drivers. These are supported by current pre-releases (which remove the QHY8 TVDE and CCD Labs Q453 entries).

    Many of these support the same features, but the "TVDE" drivers were never stable in 4x4 binning, so I had to disable that.  The others work fine with 4x4 (pretty sure it's in the ASCOM one).  Which one you use is up to you. I've always used the drivers from QHY when I've used this or similar cams. Given that QHY has shifted to the WinUSB drivers, I would suggest that users switch over to these.
  • Is my Canon 300D or 10D supported?
    These (and several others) are "DIGIC I" cameras. Canon's "EDSDK" is what application developers (e.g., me) use to support the cameras. Unfortunately, the EDSDK does not support DIGIC I cameras and only supports DIGIC II, III, and 4 (yes, they call it "4" and not "IV") cameras. The SDK (Software Development Kit) that supports the older DIGIC I cameras is out of date, unsupported, etc. and no, I'm not going to code up for it.

    What that means is that Nebulosity will not control the cameras for image capture. You can use something like DSLR Shutter for capture (or whatever you like) and process the images in Nebulosity (it will read the CRW files), but Nebulosity won't do image capture. Sorry!

  • When is Nikon support coming?
    I honestly don't know, but don't hold your breath. There's still some chance it will get in, but Nikon has made it more difficult than most. To give you an idea, I got a good bit of the way into supporting the D40/D40x. The code was already about 20x as long as supporting something like an SBIG or QSI camera and all it managed to do was to connect and tell the camera to take a basic picture. It didn't even download the picture. I've had to use my limited resources on other things, making this on indefinite hold.
  • My Meade DSI isn't working properly
    If you're on a USB2 port, head on over to the Meade support site and download the current driver (you'll likely need to install the upgrade to Envisage). The version on the CD Meade shipped has issues. Updating has fixed this for every user I've seen hit this.

    If you're on a USB1 port, somehow find and use a USB2 port.
  • Does Nebulosity do X with camera Y in mode Z?
    If you're not a registered user, the demo is fully functional (it just adds diagonal black lines on your image). If you are a registered user, keep in mind Nebulosity won't break if you try something new. So try it! Give it a shot... have a scan through the manual (the PDF is search-able) and check out the Yahoo group.
  • Will Nebulosity support my camera?
    Nebulosity provides access to a very large array of cameras. If you don't see your specific camera listed and you're on Windows, check to see if your camera has an ASCOM camera driver for it. For example, most of the Orion StarShoot series have ASCOM camera drivers. Nebulosity can talk to a generic ASCOM camera interface and your ASCOM camera driver can convert this into the specifics needed for your camera. Thus, Nebulosity can talk to any ASCOM-compliant camera without buiding in direct support (and you won't see the camera listed in Nebulosity's pull-down). The ASCOM camera spec currently limits the features available, but the spec is undergoing some revision to address these limitations. On the Mac, the situation isn't as nice.

    When in doubt, try something that looks like your camera. No harm in trying!

  • Feature X and/or camera Y isn't working right
    Please have a look at the Pre-release page before going any further. Odds are pretty decent the problem has already been fixed. If not, file a bug report. Don't worry about using pre-releases. If it's been up there for more than a week, odds are there's nothing too horrible about it. You can always "downgrade". FWIW, I always use pre-releases.
  • PHD Issues
  • Will PHD work with my camera?
    PHD provides access to a very large array of cameras. If you don't see your specific camera listed and you're on Windows, check to see if your camera has an ASCOM camera driver for it. For example, most of the Orion StarShoot series have ASCOM camera drivers. PHD can talk to a generic ASCOM camera interface and your ASCOM camera driver can convert this into the specifics needed for your camera. Thus, PHD can talk to any ASCOM-compliant camera without buiding in direct support.

  • Will PHD work with my mount?
    Almost certainly, it will. There are two basic ways of getting guide commands to your mount. One uses the serial or USB link to your mount and the other uses your mount's autoguide input (ST-4) port. This article I wrote for Astronomy Technology Today explains it all. In addition, on the Mac, keep in mind that PHD can talk to whatever mount is connected to Equinox (links to other planetarium packages are in the works).
  • Calibration is failing, why?

    Please note
    1) The crosshairs are the lock position. They don’t move.
    2) The box is where PHD thinks the star is
    3) If it bleeps / flashes, etc. PHD has lost the lock on the star. It thinks it might be a hot pixel, the SNR is low, etc.
    4) Better alignment is always better. Never intentionally misalign. If you have appreciable drift, PHD can mistake this for its attempts to move the mount during calibration. I’ve had RA calibrations “succeed” when really no signals were getting to the mount. PHD has no way of knowing if star drift from misalignment or its turning of the motors actually moved the star.
    5) Exposure duration has nothing to do with calibration. The calibration step size (Advanced panel) does. The exposure duration controls how long the camera exposes and the step size controls how long a guide pulse is sent out on each calibration “step” (there are up to 60 steps).
    Given this, we have a few things to consider about calibration:
    - When you’ve clicked on a star, you get a green box around it. If it’s not green but yellow/orange, you don’t have a star (find another one). Once you hit the PHD / Guide button you should get green crosshairs to appear (these show the “lock” position).
    - Once calibration has begun, the star should start to move. Does it? If so, maybe it’s just not moving enough. Increase the calibration step size (Advanced panel) to send longer pulses. If not, you may not be getting any signals to the mount. The star should move one way and then back during RA calibration. After that, it should move perpendicular to this (and then back) during Dec. If it's not moving like this, your signals are probably not getting through.
    - You’ve connected to the right mount / driver, right?
    - Once (in theory) connected to the mount, hit Ctrl-T (or go into Tools, Manual Guide). This will pop up a series of dialogs saying it will engage the motor in each direction. Once you hit OK, you get a 1 second pulse to that motor. Look and/or listen closely to your mount to determine if any change in position and/or motor noise happens when you hit OK. One person at least attached a long stick to the telescope so that the small guide motions could be magnified and he could see them. If you get some activity here - any activity - PHD is sending commands to the mount. If you don’t, it’s not. Start looking at your cables, your choice in the Mount menu or ASCOM dialog, etc.
    - When just looping, do you see the star move much? If so, you’re not aligned to the pole well and we’ve got a lot of drift from that misalignment. Fix this.
    - If calibration has succeeded in the past, about how many steps did it take? If it’s taken just a few, decrease the calibration step size to send shorter guide pulses during calibration. If it’s taken 30-60, increase the step size (Advanced panel).
    - Are you trying to guide near the pole? If so, you're going to need to boost the calibration step size a good bit. See
    here for more
    - Does RA calibrate just fine but not DEC? PHD tries to clear out the backlash in DEC before calibrating, but it may not succeed if there is a lot of it. Have PHD running in the loop mode, you can see how long it takes to take up the DEC backlash using your mount’s normal controller. Go N until you move, then switch to S and count how many seconds it takes. PHD tries to take up the DEC backlash before calibration but if there’s a lot and/or the calibration step size is too short, it may not work. To get around this, you can manually take out the backlash prior to calibration. N is calibrated first. Figure out the arrow on your handbox that does the same motion as this. Before entering the calibration, hit this until the star starts to move. Then calibrate and you should get the DEC done just fine.

  • My Meade DSI isn't working properly
    If you're on a USB2 port, head on over to the Meade support site and download the current driver (you'll likely need to install the upgrade to Envisage). The version on the CD Meade shipped has issues. Updating has fixed this for every user I've seen hit this.

    If you're on a USB1 port, somehow find and use a USB2 port.
  • My Orion StarShoot Autoguider no longer works (1.12 or later)
    Orion updated their drivers to support 32 and 64-bit Windows 7. In the process, this broke backwards compatibility. From 1.12 on, PHD now installs the 32/64-bit version of SSAGIF.dll for the Orion Autoguider by default (Orion's request). Users should either update the driver (http://www.telescope.com/rsc/img/catalog/lc/articles/ssag64bit.html) or rename SSAGIF_orig.dll (the previous version, still bundled with PHD) to SSAGIF.dll in \Program Files\PHD Guiding if they wish to use the old one.
  • Just what are those #'s in the log file?
    PHD deals in pixels (distance), seconds or milliseconds (time), and radians (angles). It never needs to know things like how long your focal length is because it only works in units that can be directly observed - how far the star moved in pixels in a given amount of time. Thus, we have:

    Frame: Counter telling you what image it was, starting at 1
    Time: Time since the start of the run, in seconds
    dx: Distance the star was from the lock position along the camera’s X-axis, in pixels
    dy: Distance the star was from the lock position along the camera’s Y-axis, in pixels
    Theta: Angle formed by creating a line from the lock position to the star position, in radians
    RA_Dist: Projection of the vector from lock to star position onto the RA axis (as determined in the calibration stage) as distance in pixels
    RA_Dur: Duration of the RA pulse sent (in msec)
    Dec_Dist: Projection of that vector along the Dec axis (as determined in the calibration stage)
    Dec_Dur: Duration of the Dec pulse sent (in msec).
    Star_Mass: "Mass" of the star (sum of the star's intensity)

  • Mac Specific
  • Do you / when will you support Camera X (e.g., the Orion Autoguider) on the Mac?
    Support for a camera (or any other bit of hardware) needs a driver and an "API" (Application Program Interface) for me to talk to. Without that, I might as well just stare at the camera and think happy thoughts. It'd be as effective...

    It's a lot like this. Suppose you just bought a FooMatic 1000 printer that works on Windows just fine, but there's no Mac driver for it.  So, you're there on your Mac in Word or OpenOffice or whatever, and you can't print.  It'd be nice if someone wrote a driver but my guess is the weight of the blame for its absence would fall on FooMatic and not on the folks who wrote your favorite word processor.

    Yes, it is true that I've reverse engineered or ported drivers over to the Mac for other cameras. I helped in the Meade DSI port (and now maintain that driver), I've done the ShoeString gear, and I've gotten the QHY8 and QSI cameras going, for example. The latter two had Linux drivers that could be ported without much fuss. The ShoeString gear are simple "HID" devices that didn't take too much, etc. At the very least, I've had the support of the camera maker and things have come at a time when I've had time. In general, these things take a lot of time and it's really more up to the hardware maker than the application writer to get that basic level of support up and going on the platform.

    A number of companies either give Mac support on their own or have supported the development of drivers (e.g., by posting Linux code freely to their site). Support those companies and / or talk to the other companies about the need for Mac support. The customer's voice is the loudest.