La base APASS Compacte

The COMPACT APASS Database

(Text in english below)

Cette base de données provient de la publication version DR10 du catalogue APASS de l'AAVSO dont la description est donnée ici et .

Remerciements

Un grand merci aux équipes de l'AAVSO qui ont rendu ces informations disponibles.

Si vous désirez utiliser cette base de données, s'il vous plaît, veuillez considérer de supporter l'AAVSO en devenant membre ou en faisant une donation. En cas de publication, merci de citer COMPACT APASS et remercier l'APASS par le crédit suivant : "This research was made possible through the use of the AAVSO Photometric All-Sky Survey (APASS), funded by the Robert Martin Ayers Sciences Fund and NSF AST-1412587."

Introduction

Le catalogue APASS est un catalogue photométrique en cours de construction par l'AAVSO. A fin 2021, la version publiée est la DR10.
Ce catalogue est le résultat de survey de l'intégralité du ciel conduit sur les filtres Johnson B et V et Sloan g', r', i' et z_s. Il est valide de la 7ème à la 17ème magnitude.

Ce catalogue est accessible directement en ligne par la page suivante sur le site de l'AAVSO. Il n'existe pas d'API permettant de lancer automatiquement des extractions de cette base. Cependant, la base est accessible sur le site FTP public de l'AAVSO dans son intégralité au format texte.

But

Le but de Compact APASS est de fournir une version binaire de cette base et permettant une recherche facile sans nécessiter d'accès internet.

Contenu

La base est constituée de 36 fichiers binaires nommés zm90.bin à zm05.bin pour l'hémisphère Sud et zp00.bin à zp85.bin pour l'hémisphère Nord. Ce découpage respecte intégralement celui proposé iniitalement par l'AAVSO. 

Organisation des données

Les fichiers CAPASS sont divisés en bandes de déclinaison de 5 °.

La base de données est donc structurée en 36 fichiers, contenant les données relatives aux étoiles de la bande considérée donnée par le nom du fichier. Le nom du fichier indique la borne inférieure des déclinaison des étoiles contenues : ainsi, les étoiles dont la déclinaison est comprise entre -90° et -85° sont dans le fichier zm90.bin, les étoiles dont la déclinaison est comprise entre +10° et +15° sont dans le fichier zp10.bin, par exemple.

Dans les fichiers, les étoiles sont enregistrées par ascensions droites croissantes (RA) dans chacun des fichiers ce qui permet une recherche rapide et facile par zone du ciel. Un outil de recherche simple sera prochainement fourni.

Encodage des étoiles...

Les données de chaque étoile sont codées dans un enregistrement long de 46 octets. La structure de données est la suivante, donnée en langage Pascal :
T_data_CAPASS = bitpacked record
     SPD_ZSST : longint; // Codes SPD et ZSST de l'étoile
     RA       : longint;  // Ascension Droite J2000.0 en mas
     RA_err   : smallint; // Incertitude sur l'Ascension Droite en mas
     DEC      : longint;  // Déclinaison J2000.0 en mas
     DEC_err  : smallint; // Incertitude sur la Déclinaison en mas

     NBN_B    : byte;     // nombre d'observations pour le filtre B

     NBN_V    : byte;     // nombre d'observations pour le filtre V
     NBN_g    : byte;     // nombre d'observations pour le filtre g' (SG)
     NBN_r    : byte;     // nombre d'observations pour le filtre r' (SR)
     NBN_i    : byte;     // nombre d'observations pour le filtre i' (SI)
     NBN_z    : byte;     // nombre d'observations pour le filtre z' (SZ)

     mag_B    : smallint; // mag B en mmag

     mag_V    : smallint; // mag V en mmag
     mag_g    : smallint; // mag g' en mmag
     mag_r    : smallint; // mag r' en mmag
     mag_i    : smallint; // mag i' en mmag
     mag_z    : smallint; // mag z' en mmag

    errmag_B    : smallint; // incertitude sur mag B en mmag
     errmag_V    : smallint; // incertitude sur mag V en mmag
     errmag_g    : smallint; // incertitude sur mag g' en mmag
     errmag_r    : smallint; // incertitude sur mag r' en mmag
     errmag_i    : smallint; // incertitude sur mag i' en mmag
     errmag_z    : smallint; // incertitude sur mag z' en mmag
  end;

Les valeurs de magnitudes ou d'incertitudes non définies (égales à 99.99 dans l'APASS) ont été codées -32768, de même que les magnitudes inférieures à 7.

Le champ SPD_ZSST fournit un numéro d'étoile sur 4 octets (longint)  dont l'octet de poids fort donne le APASS south-polar-distance et les trois octets restant un numéro de séquence propre à l'étoile. Notez que les valeurs pour les filtres u' et Y ne sont pas actuellement définies dans la version DR10.

Types de données utilisés:

Les types de données indiqués ci-dessus, en utilisant le langage Pascal, sont :

longint : entier signé 32 bits
smallint : entier signé 16 bits
byte : entier positif 8 bits

Téléchargement de CAPASS

Ces données sont disponibles sous format compressé 7zip sur le site FTP de l'Observatoire de Cesson (UAI B24), France, c'est à dire sur mon site FTP personnel accessible par ce lien, lien à ouvrir avec un outil clien FTP tel que Filezilla pour des raisons de sécurité (utilisation de TLS 3.0). Utiliser le login capass et le mot de passe capass.

Toutes les données peuvent être décompressées dans un même répertoire avant utilisation afin de restaurer la structure de la base de données.

Attention !

Bien qu'une grande attention ait été accordée à la réalisation de cette conversion et que de nombreuses vérifications aient été effectuées, l'auteur décline toute responsabilité quant aux éventuelles conséquences de l'utilisation de ces données. Veuillez lire ce document sur les problèmes connus dans l'APASS DR10.

Ces données et informations sont libres d'utilisation. Cependant, si vous utilisez Compact APASS dans vos recherches, pensez à remercier l'AAVSO et l'équipe APASS comme écrit plus haut et à citer Compact APASS et son auteur.

Merci d'utiliser le Compact APASS ! A consommer sans modération !

Fait à Cesson (France, 77) le 11 Décembre 2021.

Marc SERRAU



English translation :

This database comes from the publication version 10th Data Release of the AAVSO APASS catalog, the description of which is given here et there.

Acknowledgments 

Many thanks to the AAVSO teams who made this information available. If you would like to use this database, please consider supporting AAVSO by becoming a member or making a donation. In case of publication, please cite COMPACT APASS and thank APASS with the following credit: "This research was made possible through the use of the AAVSO Photometric All-Sky Survey (APASS), funded by the Robert Martin Ayers Sciences Fund and NSF AST-1412587."

Introduction

The APASS catalog is a photometric catalog under construction by AAVSO. At the end of 2021, the published version is DR10. This catalog is the result of a survey of the entire sky conducted on Johnson filters B and V and Sloan g ', r', i 'and z_s. It is valid from 7th to 17th magnitude.

This catalog is accessible directly online from the following page on the AAVSO website. There is no API allowing you to automatically launch extracts from this database. However, the data are also accessible on the AAVSO FTP public site in its entirety in plain text format.

Goal

The aim of Compact APASS is to provide a binary version of the APASS DR10 database allowing local easy research without requiring internet access.

Contents

The database is made up of 36 binary files named zm90.bin to zm05.bin for the southern hemisphere and zp00.bin to zp85.bin for the northern hemisphere. This division fully respects that initially proposed by AAVSO.

Data organization

As APASS, Compact APASS files are divided into 5 ° declination bands.

The database is therefore structured in 36 files, containing the data relating to the stars of the band considered given by the name of the file. The name of the file indicates the lower limit of the declination of the stars contained: thus, the stars whose declination is between -90 ° and -85 ° are in the file zm90.bin, the stars whose declination is between + 10 ° and + 15 ° are in the zp10.bin file for instance.

In files, stars are recorded sorted by ascending right ascension (RA) in each of the files which allows a very easy and fast search by area of the sky. 
A simple search tool will be provided soon.

Star encoding ...

The data for each star is encoded in a 46-byte long record. The data structure is as follows, given here in Pascal language:
T_data_CAPASS = bitpacked record
     SPD_ZSST : longint; // SPD et ZSST codes for the star. See below.
     RA       : longint;  // Right Ascension J2000.0 in mas
     RA_err   : smallint; // error on Right Ascension in mas
     DEC      : longint;  // Declination J2000.0 in mas
     DEC_err  : smallint; // Error on Declination in mas

     NBN_B    : byte;     // Nomber of observations for filter B

     NBN_V    : byte;     // Nomber of observations for filter V
     NBN_g    : byte;     // Nomber of observations for filter g' (SG)
     NBN_r    : byte;     // Nomber of observations for filter r' (SR)
     NBN_i    : byte;     // Nomber of observations for filter i' (SI)
     NBN_z    : byte;     // Nomber of observations for filter z' (SZ)

     mag_B    : smallint; // mag B in mmag

     mag_V    : smallint; // mag V in mmag
     mag_g    : smallint; // mag g' in mmag
     mag_r    : smallint; // mag r' in mmag
     mag_i    : smallint; // mag i' in mmag
     mag_z    : smallint; // mag z' in mmag

    errmag_B    : smallint; // Error on magnitude B in mmag
     errmag_V    : smallint; // Error on magnitude V in mmag
     errmag_g    : smallint; // Error on magnitude g' in mmag
     errmag_r    : smallint; // Error on magnitude r' in mmag
     errmag_i    : smallint; // Error on magnitude i' in mmag
     errmag_z    : smallint; // Error on magnitude z' in mmag
  end;
Undefined magnitudes or errors values (equal to 99.99 in APASS) were coded -32768, as were magnitudes less than 7.
The SPD_ZSST field provides a star number on 4 bytes (longint), the most significant byte of which gives the
APASS south-polar-distance of the band and the remaining three bytes a sequence number specific to the star.
Note that the values for the u 'and Y filters are not currently defined in version DR10.

Data types used:

The data types shown above, using Pascal language, are:

longint: 32-bit signed integer
smallint: 16-bit signed integer
byte: 8-bit positive integer

Downloading the Compact APASS

These data are available in 7zip compressed format on the FTP site of the Cesson Observatory (IAU B24), France, i.e. on my personal FTP site accessible by this link.

This link must be opened with an FTP client such as the Filezilla tool for security reasons (use of TLS 3.0). Use the capass login and the capass password.

All the data can be decompressed in the same directory before use in order to restore the structure of the database.

Warning

Although great care has been taken in carrying out this conversion and many verifications have been carried out, the author declines all responsibility for any possible consequences of the use of this data. Please read this document on the known issues of APASS DR10.

These data and information are free to use. However, if you are using Compact APASS in your research, consider thanking AAVSO and the APASS team as written above and citing Compact APASS and its author.

Thank you for using the Compact APASS! To consume without moderation !

Made in Cesson
 (France, 77) le 11 Décembre 2021.

Marc SERRAU