vStar 1.00 Beta User's Guide


  Introduction
 

GPL
Application

HowTo
 

Load Records
Search Records
Save as CSV
Save as Text

Glossary

 

Introduction

 

GPL

vStar - Searches & reports variable star records in AAVSO data file Copyright (C) 2005-2006 Frederick (Rick) Burton

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Application

vStar performs a selection of searches for variable stars based on American Association of Variable Star Observers (AAVSO) records. These records are found in a public domain file available for download at http://www.aavso.org/observing/aids/vallongtype.txt . A supporting file explaining fields and layout of vallongtype.txt is found at http://www.aavso.org/observing/aids/valsampl.txt.

top

 

HowTo

 

Load Records

From the File menu, choose Load File. The standard data file is named vallongtype.txt. Multiple versions of this data file may be kept and loaded one at a time. Record format is validated on the fly while loading data. Only valid records are loaded while invalid records are disregarded. If a new data load is initiated, the previously loaded data is replaced by the newly loaded data.

Linux:
The title bar and status bar display info about loaded records. When a file load completes, the name of the data file is displayed in the title bar while the number of records loaded is displayed in the status bar.
Windows:
The upper left portion of the vStar screen captioned "Data" displays info about loaded records. When a file load completes, the name of the data file and the number of records loaded is displayed in this area.

Search Records

Enter criteria values in the text boxes in the lower left portion of the vStar screen captioned "Search Criteria", then click either the Search Ascending button or the Search Descending button. The ascending search sorts records in their natural order as loaded from the data file while the descending search produces records in the reverse order. Search criteria text boxes are disabled when there are no records loaded.

Right Ascension and Declination criteria specify an area of the sky to search.

Magnitude and Period criteria set limits on variability behaviors of the stars to include in the search.

Linux:
The title bar displays info about searched records. When a search is performed, the number of records included in the search is displayed in the status bar.
Windows:
The upper left portion of the vStar screen captioned "Data" displays info about searched records. When a search is performed, the number of records included in the search result is displayed in this area.

When the "Specific" check box is checked, all criteria are used in the search. When this check box is unchecked, Magnitude and Declination text boxes are disabled and only stars without specific brightness variation details are included in the search.

 

Right Ascension

Hours are entered with values ranging from 0 to 23. The "West" value represents the western-most hour to search while the "East" value represents the eastern-most hour to search. When the same value is entered for West and East, only that hour is searched. Any values within the given range may be entered for either criteria. The hour 0 will be spanned when it is contained by the series of hours to be searched.

Declination

Degrees are entered with values ranging from -90 to 90. Negative values represent southern degrees and positive values represent northern degrees. The "South" value represents the southern-most declination to search while the "North" value represents the northern-most declination to search. Any values within the given range may be entered, but South must be less than North.

Magnitude

Maximum magnitude is entered as a positive floating-point value. This "Max >" value represents the lower limit of brightness (or upper limit of numeric value) for the maximum magnitude of the star´s brightness range.

Minimum magnitude is entered as a positive floating-point value. This "Min <" value represents the upper limit of brightness (or lower limit of numeric value) for the minimum magnitude of the star´s brightness range.

Period

Days are entered as positive floating-point values. The "Least" and "Greatest" values represent the lower and upper limits of the period of time during which the star's brightness change cycles.

Save As CSV

From the File menu, choose Save CSV. The current search results will be saved in comma-separated format including column headers. This file may be loaded into most spreadsheet programs for any further formatting or analysis.

Save As Text

From the File menu, choose Save Text. The current search results will be saved as a plain text file in the same native format as the original data file. The resulting file may be loaded into the program as a subset of the larger data file in order to perform a search within fewer records.

top

 

Glossary

  Right Ascension: Astronomical Longitude. Each hour equals 15 degrees and is divided into minutes and seconds of arc.

Declination: Astronomical Latitude. Degrees mirror terrestrial latitude with negative numbers representing southern locations.

Magnitude: Brightness Scale. Each whole number represents a change in brightness by a factor of 2.512 (5th root of 100) so that every five whole numbers represents a change in brightness by a factor of 100. Smaller values indicate greater brightness. A magnitude of 6.0 is naked-eye threshold.

Period: Length of Brightness Variation Cycle. The duration of the entire brightness variation pattern expressed in decimal days.

top