grand logo BASS2000
User Guide


This guide has been sent in the past to all observers at THEMIS (PI) one week before their observations, starting in July 2002. We point out the importance of filling properly the keywords in THEMIS data headers through the Observing Interface developped at THEMIS for the perennization of these data at BASS2000. The document is also available at THEMIS in the observing room. Please do not hesitate to contact us (see below) during your observing run if you have any questions.

  • Guide utilisateurs (.doc)
    . User guide for good THEMIS data headers and forms
    User guide for good THEMIS data headers and forms

    Nadège Meunier, BASS2000, June 2002



    THEMIS data obtained with the MTR and MSDP mode are available 1 year after the observation in the BASS2000 catalogue (http://bass2000.bagn.obs-mip.fr). The current request is simple and requires the correct implementation of the OBJECT keyword : this is very important because it is closely related to the observing program and the scientific objectives. Such a request is however not sufficient because the amount of data selected using a standard request is too large (hundreds of Gb for example). We will need to implement new criterions to allow future users to make a useful request. For this purpose we will need your help: for a good request it is necessary for all keywords to be filled systematically and correctly, otherwise the request would be strongly biased or wrong. The purpose of this guide is to help you fill to the keywords that are the responsability of the observer. All keywords are also described at http://bass2000.bagn.obs-mip.fr/New2001/Pages/thesaurus2001.html Do not hesitate to contact us if you have problems to fill the keywords during your observations.

    1)In the user interface

    - The OBJECT keyword: it is defined in each target page in the IO (hereafter Observer's Interface). A menu is available to allow to select the proper object. If you re-use a target for a new object, please be careful to change this keyword. It is very important for the request because it provides the most pertinent information about the observing program.


    - The CAMPAIGN keywords (mandatory when it is a campaign): it is defined in the Observation Settings / FITS Parameters page in the IO and is usually filled only once for your whole run. We advise you to fill it at the beginning in order to be sure that all files will contain the information, even possible calibration observations made at the beginning. The definition of the 4 keywords is the following :

    CMP_NAME: Name of the campaign (title of the JOP for a SOHO campaign for example)

    CMP_NO: Number of the campaign (related to the number of times this campaign has been made, valid for all types of campaigns)

    CMP_TYPE: Number of the JOP or similar campaign type (usually for a SOHO campaign)

    CMP_DESC: List of the instruments involved in the campaign

    The 3 first keywords are SOHO-standard. During all campaigns with the same name, the character chain in 'CMP_NAME' must be exactly the same to allow requests from different data bases (BASS2000, MEDOC, ...), even several years later. However it can be different from the observing program.

    · Example for coordinated observation with SOHO (4th time this campaign is made):

    CMP_NAME = 'supergranulation study'

    CMP_NO= 4

    CMP_TYPE= 'JOP 200'

    CMP_DESC='THEMIS, MDI, TRACE'

    · Example for coordinated observation with another groundbased telescope (first time this campaign is made)

    CMP_NAME = 'granulation and dynamics'

    CMP_NO= 1

    CMP_TYPE= ''

    CMP_DESC= 'THEMIS, COUPOLE TOURELLE PIC DU MIDI'


    - The NOAA number: When you observe an active region it is very important that you fill this keyword (defined in the target page of the IO). This keyword will be implemented to allow common requests between different data bases (BASS2000, MEDOC). You can find the information for the region you are observing on the following website (usually updated daily): http://www.solar.ifa.hawaii.edu/ARMaps/Today/latest.gif


    Other keywords defined once that are important

    Your institute (it is implemented automatically by the IO from your proposal), the contact and the PI names, your e-mail (these are defined in the Observation Settings / FITS Parameters IO Page), the spectral pixel size defined in the Technical Parameters / Camera IO page. All these keywords should be filled at the begining of your run before any files is recorded.

    2) On the form provided by your resident astronomer 

    Seeing, calima and nebulosit.

    The SEEING, CALIMA and NEBULOSITY information are defined on a scale between 1 (very bad) to 5 (excellent). The definition of the scale adopted for the seeing is the following :

    level 1: no structure is distinguished within the field of view

    level 2: structures are distinguished on a scale greater than 1/4 of the field of view itself

    level 3: granulation is just sometimes distinguished

    level 4: granulation is constantly distinguished but with poor contrast

    level 5: granulation is constantly distinguished but with excellent contrast

    Starting this 2002 campaign, the seeing is recorded using a scintillator (seeing outside the telescope) providing a systematic record of the seeing on a relative scale as well as information about the nebulosity. To allow us to make the correspondance between this relative scale and and this 1-5 scale used the 2 previous years we would be very grateful if you would accept to fill the form this year for the seeing and the nebulosity.


    Calibration.

    In order to provide all necessary data to the database users, we need to know at BASS2000 which calibration files (flat-field, dark current, as well as field-stop in the case of MSDP data) go with which scan. We advise you to regroup them in one sequence (scan + calibrations). You can indicate the hours of the calibration files for each scan on the form.

    Tip: the IO increments the sequence number each time you start a new combination of target selection. This is adapted if you group your files from the beginning. However in case you do not do so or if a problem occurs during the observation, the IO allows you to decrement the sequence number manually in the Start Observations page to include a new observation in a sequence.

    Note: Data are archived, listed in the catalogue and provided to the BASS2000 user as sequences, it is therefore important to have sequences that are not too big but still containing consistent data.


    Problems and interesting events.

    Please indicate any problem you met on the form, for example interrupted scans that we should not archive, adjustment problems you have noticed after the observation, interesting events that occured during the scan (flare for example).

    3) After the observations

    If you have not filled the form after the observations, you can still contact us later to provide us the informations described above. Note that we will contact you to provide us these informations if we do not receive them together with the data.

    We thank you for your collaboration.

    Nadège Meunier and the BASS2000 team

    Web: http://bass2000.bagn.obs-mip.fr

    Contact: (contact at ast.obs-mip.fr) or (meunier at ast.obs-mip.fr) (33-5-62-56-60-24)