4.1 Assumptions ########################################## Philosophy ------------------------ This photometry script has been written with the following ideas: * making an end-to-end photometric processing, from the calibrated images (input) to a final optimised lightcurve (output) in a single run. All the checking operations are included in the script, so that there is no need to open the file with the final magnitudes to check the data or to remove some points. The good thing is that this approach makes the processing very reliable, the bad thing is that several interactions with the user are needed: this script is absolutely not automatic. Automatisation is surely possible, but to make it reliable the script should probably be optimised for a given system (telescope + CCD). It seems difficult to make a completely automatic software that works 100% on all systems. * export as much as possible meaningful information (image uniformity, image shifts, etc) to output files in a concise but self-explanatory way, so that it is immediatly clear what was done with the data when opening the files 6 months later. These extra information are sometimes useful, and always instructive. * extracting the best possible photometric information. At the moment, the script performance compares quite favorably to other existing softwares, and the noise of the obtained lightcurves has been found, on a few test cases, to be in the range 10-20% above the theoretical limit (as calculated with the CCD equation, with shot noise of signal and background, read-out noise, quantization noise). Star catalogs and reference stars ----------------------------------- Star catalogs are useful for two things: - to derive absolute magnitudes for the measured objects - to help to select reference stars with the appropriate color, so that they are influenced by the variations of air mass in the same way as the observed targets To get accurate absolute magnitudes the right approach is to use photometric filters, a good sky and CCD transformation equations. Then, due to the reliability and accuracy of star catalogs, it is probably still difficult to get better than 0.1 accuracy. The present script only considers differential magnitudes, for which the technique is much simpler, and an accuracy in the range of a few 0.01 is common. For this reason no catalog is needed. For the choice of reference stars, we found that using a criterium based on color to reject some stars, and to accept others, is not very transparent. When we do so, we actually don't know how bad are the rejected stars, and how good are the one that we actually keep. Actually, we found that visual validation of the reference star magnitudes is much more powerful. Drifting stars are immediatly identified, but also problematic stars (cosmic ray impacts, variable stars, star crossing by asteroid, etc). Calculating magnitude noises ----------------------------- Calculating the uncertainty of the measured magnitudes is not easy. Some softwares have chosen to calculate magnitude uncertainty from the theory, using the CCD equation and propagating the errors through the processing chain, starting from the pixel noise and ending with magnitude noise. Unfortunately, this method is not always accurate, and in some cases it doesn't work! In principle the real noise is always stronger than the theoretical one. In some case it can be larger by a factor of 2. This fact can be verified by making photometry over a constant star. Then, you can compare the noise obtained with the processing algorithm to the noise that you will compute yourself from the data. For the present script, we choosed to estimate the real noise. The method to do it is the following: we substract, from the magnitude curve, a smoothed version of it (obtained by convolution with a boxcar window). The result is a flat and noisy curve, with a RMS value being directly proportional to the RMS magnitude noise of the original lightcurve. This method is equivalent to applying a high-pass filter to the magnitude curve, so as to extract the noise information. The good side is that the noise computed with this method is accurate, and is truly quantifying the quality of the magnitude data. The bad side is that there is a single value of noise for the complete curve (instead of one value per data point). Last changes (v1.2.0 and later) ----------------------------------- Now the photometry script can use 3 different photometry methods. They are, in order of decreasing accuracy: * method = 'centroid' corresponds to a photometry disk centered on the star centroid, as calculated with a 2D gaussian PSF fit (or any other method). This method is the most accurate, it was called 'recenter', in v1.1.0 and v1.1.1. * method = 'maximum' corresponds to a photometry disk centered on the star pixel with maximum signal. This method was called 'normal', in v1.1.0 and v1.1.1. * method = 'select' corresponds to a photometry disk centered on the pixel selected by user. This method was not possible with v1.1.0 and v1.1.1. The last method ('select') works well with defocused images obtained with mirror telescopes, when the star is a ring and the photometry disk cannot be centered with the star maximum signal or the star centroid cannot be calculated reliably.