Difference between revisions of "GCVS General Catalog of Variable Stars"

From DSO Planner
Jump to: navigation, search
(Created page with "=Download= [http://dsoplanner.com/files/gcvs4.May16.v1.1.txt.zip gcvs4.May16.v1.1.txt.zip] (extract gcvs4.May16.v1.1.txt prior to importing) =Intro= I have prepared this data...")
 
Line 1: Line 1:
=Download=
=Download=
[http://dsoplanner.com/files/gcvs4.May16.v1.1.txt.zip gcvs4.May16.v1.1.txt.zip]
[https://dsoplanner.com/files/gcvs5_csv.zip GCVS databse]
(extract gcvs4.May16.v1.1.txt prior to importing)
(extract gcvs5.csv prior to importing)
 
[https://dsoplanner.com/files/gsvs5.py Script for parsing the original data]


=Intro=
=Intro=
I have prepared this database for importing as an example of how it should be done in order to make it easy enough for third-party import into DSO Planner.
The database and parsing script was prepared by astronomy enthusiast Ed Vazhorov.
 
Refer to the [[Objects_Databases#User_Database | Knowledge Database]] for instructions on how to import this data.
 
Note that the custom database importing module is not available in the free version of DSO Planner.


=Databse Description=
=Databse Description=
# [http://www.sai.msu.su/gcvs/ The official source of GCVS] used.
[http://www.sai.msu.su/gcvs/gcvs/gcvs5/ The official source of GCVS] used.
# [http://www.sai.msu.su/gcvs/gcvs/iii/iii.dat Direct link to the original text file database] is available.
# Specialized Python code used to convert the database text to DSO Planner format. The source code is available on request.
# There were 51'851 records imported, out of 52'011 records available in the original database. 160 records removed as they have no Ra/Dec coordinates required to display them on the Star Chart.
# All of the GCVS fields were imported using the following custom fields:
## '''ngcvs (s)''' — star number as in the GCVS worksheet
## '''var (s)''' — Var Star type
## '''max (s)''' — maximum star magnitude (text as in GCVS)
## '''min1 (s)''' — minimum star magnitude (text as in GCVS)
## '''min2 (s)''' — secondary minimum magnitude (for eclipsing var stars)
## '''ps (s)''' — photometric system of magnitude (Visual, photographic etc. see GCVS fields description page/document)
## '''jd (s)''' — variability epoch Julian date
## '''year (s)''' — year of outburst (usually for Novas)
## '''pd (s)''' — variability period (days)
## '''mmd (s)''' — Max-min, rising time or duration of eclipse (see GCVS description)
## '''sp (s)''' — Star's spectrum description
## '''refs (s)''' — GCVS references records (science papers, maps, etc)
 
====Notes====
Standard data fields:
# '''mag (n)''' — corresponds to the maximum variable star magnitude. It was cleaned from GCVC marks.
# '''name1 (s)''' — short name of the star (letters and constellation).
# '''name2 (s)''' — used the alternative name/designation of the star from the last column of the GCVS.
# '''comment (s)''' — GCVS notes embedded from [http://www.sai.msu.su/gcvs/gcvs/iii/remark.txt the GCVS remarks.txt file]
 
=Suggested format instructions=
# The custom fields names chart (5) is mandatory, as these names must be entered into Add New Database dialog as custom fields and must match the names used in the file exactly. Don't publish any standard fields on that list to avoid confusion. Use the Notes section to convey any special handling of standard fields.
# The letter in the parenthesis after the field name corresponds to the field type used during the conversion: where (s) - Text string, (n) - Numeric value. Sure thing the importer could decide on the custom field types as he/she considers it best for his/her purposes, but it is important to have that information to reflect the type of the data available to avoid importing errors (i.e. on an attempt to import a not exactly numeric data into a strictly numeric field the app will skip the entire record as malformed). In this example, the original GCVS database has the Maximum Magnitude as a text string with the numeric portion, but for objects filtering algorithm of DSO Planner it must be numeric, so that was adjusted during the conversion from the original file with the extraction of the numeric portion and skipping its text elements. However, the rest of the GCVS values were kept intact in order to present the GCVS data as it is most usable to have for the variable stars scientific research planning.
# Note the file name suggested convention as well, if the database source is available, please use any available information to identify the original database name and version within the file name. After the last underscore, it is advised to put the version of your converted file as well e.g. "DatabaseName_v1.txt", so in case you make changes in the subsequent versions or alter their properties/fix bugs - users see the difference right within the new database file name.
# Use enumerated lists in your descriptions so, in case of issues, users of your file can refer to any field name or note by its number easily.
# Please use ZIP to compact your data files and make downloading and uploading faster. 7zip and RAR archives are not recommended.


-AlexK.
=Notes=
Create custom database with the following fields of type string: mag2, vartype, epoch, period, sptype (minimal magnitude, variable type, JD maximum epoch, period, spectral type). Then import the text file from above

Revision as of 09:33, 28 January 2024

Download

GCVS databse (extract gcvs5.csv prior to importing)

Script for parsing the original data

Intro

The database and parsing script was prepared by astronomy enthusiast Ed Vazhorov.

Databse Description

The official source of GCVS used.

Notes

Create custom database with the following fields of type string: mag2, vartype, epoch, period, sptype (minimal magnitude, variable type, JD maximum epoch, period, spectral type). Then import the text file from above