LesvePhotometry user guide

Last update : March 2d 2017


The main window of LesvePhotometry consists of 3 parts
- a menu bar at the top
- tabs in the central frame
- a lower frame

After installation, run the program and fill or correct the input boxes in the central frame tabs:

Quick links

Central frame
Lower frame
File menu
Retrieving UCAC4 Catalog information
Reports
Reinsch Spline window

Central frame tabs

"General Settings" tab

For each report, uncheck the option if you want to skip the corresponding report generation
The reports provide the observation time in JD, except if "Heliocentric JD" option is checked
CBA Header
Observer (used in the AAVSO report)
An optional note may be added in the AAVSO report
Database : directory containing the default database used for photometry

"Photometry parameters" tab

- Mode

- Mode 1 is the normal mode, using one or an ensemble of comparison stars
For ensemble photometry, more than one Reference star (R) must be used in the "Usage" column of Variable star window, see hereafter. Two different methods may be used for "Ensemble Photometry" : Master star and Mean value, see How LesvePhotometry is performing Ensemble photometry paragraph in the FAQ page

- Mode 2 as Mode 1 but the data are color transformed for B, V, R, and I filters using the Transformation coefficients given in the right panel of the tab which have to be inputted manually or calculated with Mode 3
The program automatically detects which combinations of filter is used in the image sequence :
BVRI, BVR, BRI, VRI, BV, BR, BI, VR, VI, RI
After data reduction, the program looks for groups of observations, see AAVSO definition of Group of observations
http://www.aavso.org/aavso-extended-file-format
For each group the color indices are calculated. The color indices are tabulated and plotted in the Excel report. AAVSO and CBA reports will be generated in separate files for the untransformed and transformed data.

- Mode 3 Color transformation calibration
The program will reduce groups of images in the B V R I filters and will calculate the Transformation coefficients.
You are not constrained to use all filters for calibration. The program automatically detects which combination of filters is used in the image sequence : BVRI, BVR, BRI, VRI, BV, BR, BI, VR, VI, RI and calculates the corresponding transformation coefficients. The calibration process needs the same number of images in each filters.
E.g. if you provide 3 images in V and 3 images in I, the Tv_vi and Tvi coefficients will be calculated. The transformation coefficients are defined according to the paper of Bruce Gary
http://reductionism.net.seanic.net/CCD_TE/cte.html:
Tb_bv = slope of B-b against B-V
Tv_vr = slope of V-v against V-R
Tv_vi = slope of V-v against V-I
Tr_ri = slope of R-r against R-I
Tbv = slope reciprocal of b-v against B-V
Tvr = slope reciprocal of v-r against V-R
Tvi = slope reciprocal of v-i against V-I
Tri = slope reciprocal of r-i against R-I
Note that coefficients provided in VPhot for the AAVSONet telescopes are not defined in the same way. The coefficient Tv is defined as slope of (V-v) against (B-V). It is easy to convert the AAVSO Tv' to Tb :
Tb = Tv' + 1 - 1/Tbv with Tv' = slope of (V-v) against (B-V) . For demonstration, see the following AAVSO Photometry discussion (no more available on the AAVSO website)

AAVSONet W28 Transformation coefficients.pdf
The program generates the normal excel report and a TGReport text file. To analyse the consistency of the transformation coefficients, you may use the generated TGReport as input for the TransformationGenerator provided by AAVSO.
It is also possible to enter manually your transformation coefficients in the right panel of "Photometry parameters" tab.
To get M67 standard field data, you may use the LesvePhotometry tab "AAVSO VSP tool" and introduce HW Cnc as variable star and check the box "StdField.

- Aperture radius, Gap and Annulus
- Transformation Coeff's are used for Color transformation (Mode 2) and determined with Mode 3
- Var Min SNR : the reports will not include data if the SNR of target/variable star is lower than this value
- Maximal Flatness : the reports will not include data if the star shape is too elongated

"PinPoint parameters" tab

- the star catalogs locations
- see PinPoint documentation for the other parameters

"Default settings" tab

LesvePhotometry is looking for needed parameters in the FITS header of image files. If parameters are not found, it will use the default parameters only if the corresponding check box has been checked. It is better to adapt parameters in the program used to control the camera.
BZERO BSCALE physical ADU = BZERO + BSCALE * array_value
PEDESTAL Correction to add for zero-based ADU
EGAIN Electronic gain in e-/ADU
EXPOSURE or EXPTIME exposure time in seconds
XPIXSZ YPIXSZ pixel size in microns
FOCALLEN focal length in milimeters
FILTER filter band, accepted values U B V R I C (C for clear) and SU SG SR SI SZ for Sloan filters
FOCALLEN focal length in milimeters
OBJCTRA sexagesimal right ascension of image (optional)
OBJCTDEC sexagesimal declination of image (optional)
SITELAT or LAT-OBS sexagesimal observatory latitude
SITELONG or LONG-OBS sexagesimal observatory longitude (East longitude are positive)

"Configuration Save/Load" tab

All parameters are stored in ASCOM Profile i.e. they will be re-used when you reopen the program, except some special parameters identified with a blue label.
Nevertheless you can also save the current configuration in a file. This feature is useful when you work on images created from different telescopes or cameras. For each telescope you can use a specific configuration file. You will be prompted to provide a directory and a file name for the configuration file (.txt). All parameters and settings in
- General Settings
- Photometry parameters
- PinPoint parameters
- Default settings
will be saved in the configuration file

Lower frame

"TableIndex of Variables"

This field can be left blank if in the image file name the characters before a delimiter are the variable database key. The delimiter character ("-", "#" or "%") is user selectable in the "General Settings" tab. E.g. if image file name is IYUMa#R-001.fit, the program will search the database for a star having the key IYUMa. With this rule for image file names, you may run LesvePhotometry with a mix of different stars. If you mix different stars, specific reports will be created for each star.
If you do not follow this rule for image file name, you have to input the database star key.

"Photometry - Go"

Click this button to launch the program, a window will pop-up. Select your sky images for photometry.

"Load 1 image for UCAC4 info"

Click this button to select one sky image for star identification based on UCAC4 catalog. See chapter : Retrieving UCAC4 Catalog information

File menu

Create a New Empty Database

You will be prompted to provide a directory and a name to your new database.

Maintenance of a Database

- select the database you intend to open for inspection or for maintenance (e.g. VS_Database.db3)

Variable star window

- In Variable Selector window, click on a Variable name and all the fields for this Variable will be displayed. If you modify an entry click " Save it in database" button.



It is easy to share a part of your Variable star database with other users :
- to export data of the selected Variable star, click on the "Export this star Group" button. The comparison stars used with the Variable star will be exported at the same time. You will be prompted to select a text file to export the data. See an example of the exported file StarExport example.txt

- to import such a transfer file, in "File" drop down menu, select "Import..."

In Variable star window :
VariableTableIndex mandatory, is the table index key, it must be unique in the database.
AAVSOVarName mandatory, is used in the report file names and as the star name in the AAVSO report.
As it is used as a part of report file name it can't use the following characters. If you use one of those character it will be replaced by a blank in the report file names.

< (less than)
> (greater than)
: (colon)
" (double quote)
/ (forward slash)
\ (backslash)
| (vertical bar or pipe)
? (question mark)
* (asterisk)

AAVSODesignation AUID AAVSO Unique IDentifier, not mandatory
Chart this field is used in AAVSO report, define here which AAVSO chart reference
RA (hour) and DE coordinates of the Variable star
CMPx define here the index of reference / comparison stars

In the "Usage" column: R indicates that this star will be used as a Reference star for the magnitude calculations. You can select more than one reference star (Ensemble photometry)
CK this star will be used as the check star, ONLY ONE star as check star.
This star will be used as the check star in the AAVSO report
C this star will be used as another check star but not included in the AAVSO report.
"Usage" field will be left blank, if you don't want to use the corresponding comparison star but nevertheless you want to keep it.

- Double click a comparison star name (CMP1 to 10) and a new window will open with the comparison star data

Comparison star window




Now you can introduce the comparison star data. To insert a new comparison star, type its name in the CMP field of the Variable and double-click the name.

Filters

Classical Johnson U B V and Cousins R I and Sloan filters u' g' r' i' z' are supported by LesvePhotometry.
The references to Sloan filters are those used by AAVSO : SU SG SR SI SZ for u' g' r' i' z', respectively.
Those references must be used in the image FITS header for the FILTER keyword. Two buttons are provided to calculate the magnitude from one system to another system.

UBVRI to Sloan magnitudes
The following relationships (Jester et al. 2005 AJ 130, 873 http://arxiv.org/abs/astro-ph/0506022v1) are used to convert reference magnitudes in UBVRI system to Sloan system.
SG = V + 0.60 * (B-V) - 0.12
SR = V - 0.42 * (B-V) + 0.11
SU = SG + 1.28 * (U-B) + 1.13
SI = SR - 0.91 * (R-I) + 0.20
SZ = SR - 1.72 * (R-I) + 0.41

APASS data
The AAVSO Photometric All-Sky Survey APASS is conducted in five filters : Johnson B and V plus Sloan SG SR SI.
A button "Calcuate R I and SZ from APASS data" is provided to calculate the missing reference magnitude from APASS data. This button uses the following relationships (Jester et al. 2005 AJ 130, 873):
R = V - 1.09 * (SR - SI) - 0.22
I = R - 1.00 * (SR - SI) - 0.21
sz = R - 1.72 * (R - I) + 0.41

The AAVSO "Seqplot" tool uses also the first two relationships for calculating R and I magnitudes.

The DSLR filters TB, TG, TR are also supported in accordance to AAVSO specifications.


Export - Import

In "Maintenance of a Database" you have an option to export star Groups (i.e. data of a Variable star and its comparison stars) in a transfer file.
To import such a transfer file, generated by another user or by the the AAVSOtoLesve.exe program written by Steve Rau:
- In "File" drop down menu, select "Import Variable and comparison stars.".
- You will be first prompted to select a database and after to select a transfer file with extension ".txt".
If the Variable star is already in the database, you will be asked if you want to override the data (Yes) or to skip these data (No) or to abort the importation (Cancel). A example of the content of an exported group is given hereafter. Each line starts with the token "Variable" or "Comparison" and continues with all the star data.

Variable #AALeo#AA Leo#000-BCW-206#nomad##11 39 14.23#10 19 38.4#GSC 860-754#GSC 860-586#GSC 860-398########R#CK#C########Mag range 11.65 to 12.81
Comparison #GSC 860-754##11 39 07.15#10 16 18.48#10.762#10.329#10.04###Nomad
Comparison #GSC 860-586##11 39 40#10 19 51#11.933#11.334#10.92###Nomad
Comparison #GSC 860-398##11 39 10#10 18 10#13.42#13.14#12.7###Nomad

Retrieving UCAC4 catalog information

The release of PinPoint 6.0 (dc3.com) includes support of the Fourth U.S. Naval Observatory CCD Astrograph Catalog (UCAC4). LesvePhotometry has been tested successfully with PinPoint 6.0 version. However, LesvePhotometry V 1.2.0.40 already gives access the UCAC4 catalog information with previous PinPoint versions. This catalog is interesting for users as it contains the AAVSO Photometric All-Sky Survey magnitudes (APASS release DR6 -June 2012) http://www.aavso.org/apass.

Usage directives

- You need the UCAC4 catalog http://www.usno.navy.mil/USNO/astrometry/optical-IR-prod/ucac. UCAC4 may be downloaded from ftp://cdsarc.u-strasbg.fr/cats/I/322A/UCAC4 (8G). Or as noted on the USNO website:
2012 Aug:UCAC4 was released in August 2012. It is available from CDS as Vizier catalog I/322; DVDs have been shipped to all customers on file. To receive a free copy of the UCAC4 catalog on DVD please send a request to brenda.hicks[at]navy.mil with "UCAC4" in subject and your full name and postal mailing address in the body of your e-mail.
- In any case, you have to apply UCAC4 corrections for a small number of high proper motion stars. To do the corrections, download the program "modifs.exe" from http://www.usno.navy.mil/USNO/astrometry/optical-IR-prod/ucac copy it in your UCAC4 folder and run it. It takes a few ten seconds to correct the UCAC4 catalog.
- Launch LesvePhotometry and in "PinPoint parameters" tab, enter the path the UCAC4 catalog folder but do not select this catalog for use at this time.
- Select any catalog (e.g.GSC ACT) currently supported by your PinPoint release. Don't choose UCAC4 if you don't have the PinPoint 6.0 yet.
- Click on the button "Load 1 image for UCAC4 info" and select a FITS image. The usual sky image window opens. You may use DSS images download them at http://archive.eso.org/dss/dss or one of your own fits images
- In this sky image window, click on a star and a window displaying "UCAC4 Catalog Information" will pop-up.

- The first lines refer to the data found by PinPoint, i.e. information from the catalog chosen in "PinPoint parameters" tab. PinPoint does not match all detected stars to the catalog. In this case the information fields are left blank.
- The other lines are UCAC4 star data, i.e. data of the closest star to the matched one by PinPoint. If the star is not matched by PinPoint, the program chooses the star in respect to the position of mouse click. The position tolerance is 5 arc seconds.

- For your convenience you may also mark the selected star with the button "Mark the star".
- To import the data in your comparison star sequence

- Open the "Variable star" window as usual (File - Maintenance of a database - select the database)
- In UCAC4 "Catalog Information" window click on "Copy UCAC4 info to clipboard" button.
- In "Variable star" window, click on "Get UCAC4 info from clipboard", you will be prompted for a comparison star number (n = 1 to 10) corresponding to the CMPn textbox. The data will be automatically copied in the comparison star window.
- Repeat this process for other comparison stars and before saving your work don't forget to save data in the database.

Reports

Five reports can be generated

- AAVSO extended report
- CBA report
- Photometry excel report with a chart presenting the light curve.
- Csv report (Comma separated values). Exactly the same as Photometry excel report, but useful if you don't have Microsoft Excel.
- Lew's Plotter excel report. Lew Cook has developed a plotting excel workbook to plot data given in the format of AAVSO extended report. For your convenience, LesvePhotometry is able to create a copy of the Lew's master excel workbook and directly paste the data inside the excel workbook. This excel workbook has 14 different plots, e.g. airmass, instrumental magnitude against time but also magnitude errors against airmass or magnitude. All the Lew's Plotter capabilities and explanations are given at http://www.lewcook.com/lewaavsoformatplot.htm Many thanks to Lew Cook who wrote this excel workbook and authorized its distribution.

For the five reports, the file names have the following structure:
report_type observation_date star_name ON report_generation_time.extension
The report files are saved in the same directory as the analyzed ccd images.

Reinsch Spline window

Beside the 3 reports, two windows are open for measurement of light curve extrema. The algorithm used for the smoothing is known as Reinsch spline. A theoretical document of the algorithm is provided with the program installation.
The Reinsch Spline program (ReinschSpline.exe) can be also used standalone.
The Spline function is used to calculate an extremum (maximum or minimum) of the light curve. After getting the light curve with ReadClipboard" button, the data points and the spline curve are displayed in the Plotting Form. At this time you have to click on "left" and "right" buttons to set the left and right limits used by the algorithm to determine the extremum. The left and right limits must encompass only one extremum.

As soon as these limits are set, the extremum parameters are calculated: i.e. ToM and Mag@M. You can save these results with "Save to Clipboard" and "Save to file" buttons, four numbers are saved, e.g.
12.408 0.007 2456566.3048 0.0022
which are Extremum magnitude value and uncertainty, HJD or JD of Extremum value and uncertainty. The uncertainties calculations are based on data encompassed by the left and rights limits. If you enter star coordinates and check the box "Apply Heliocentric corrections" the extremum will be expressed in HJD instead of JD. With the "Keep only center data" button, the Plotting Form will show only data included between the left and right limits. This feature is useful if you want to only examine a part of the light curve.
If the Reinsch Spline function is called by the LesvePhotometry program, the star coordinates are also provided and the "Apply Heliocentric corrections" option is checked by default.