Catalog format

1>Science target and reference star catalog:
Creating the catalog is very important since most of the catalog fields will be passed into the OBs and in the end, to the fitsheaders. Therefore, when scheduling real observations, make sure that all the catalog fields are correct. The format of the catalog is "tab separated columns" with a 2 line header. A good starting point is to send a Simbad request using this script :

Simbad Script :
You should probably start from the demo catalog to create your own (Catalog menu->Open a demo Catalog). Starbase is an ASCII relational database for UNIX (http://cfa-www.harvard.edu/~john/starbase/starbase.html) that allows to manipulate this kind of catalog.


# - name :column name in input catalog
# - descr: description
# - units: units
# - type : data type (float, int, string)
# - value:possible values
# - range: numerical ranges
# - range: numerical ranges
# - usage: where this parameter is used in APES
# - default : default value
# - kwPAF : keyword name in Parameter File (.paf)
# - kwOBX : keyword name in ASCII export file (.obx)

MANDATORY KEYWORDS

+----
| name : stype
| descr: target type (T=target R=reference)
| units: no units
| type : string
| value: "T", "R"
| usage: allows group selection in the table widget
| defau: no default, mandatory
| kwPAF: USER.DATA.stype
+----

| name : star_id
| descr: object code
| units: no units
| type : string
| value : Whatever name you want
| example : HD192323, Gl86, My Favorite Star
| usage: general
| defau: no default, mandatory
| kwPAF: TARGET.CODE, REFERENCE.CODE
+----

| name : system_id
| descr: code for the group Target+Reference stars
| units: no units
| type : string
| value: equals star_id of the science target star
| usage: allows to sort a input catalog if needed
| defau: no default, mandatory
| kwPAF: USER.DATA.system_id
+----

| name : alpha
| descr: right ascension
| units: hh:mm:ss.sss or hhH:mmM:ss.sssS (ex: "3:12:23.523", "3h 12m 13s", ...)
| type : string
| value: alpha coordinate in ICRS2000 or FK5
| range: 0h ... 24h
| usage: general
| defau: no default, mandatory
| kwPAF: TARGET.ALPHA, REFERENCE.ALPHA
+----

| name : delta
| descr: declination
| units: dd:mm:ss.ss or ddD:mmM:ss.ssS (ex: "72:4:23.63", "72d4m23.6s", ...)
| type : string
| value: delta coordinate in ICRS2000 or FK5
| range: -90[d]...+90[d]
| usage: general
| defau: no default, mandatory
| kwPAF: TARGET.DELTA, REFERENCE.DELTA
+----

| name : dalpha* :
| descr: projected separation between the reference and the target along the alpha axis (Deltaapha*cos(delta)). Based on dalpha*, APES recomputes "alpha reference".
| units: arcsec
| type : string
| value:
| range:
| usage: general
| defau: no default, mandatory only if alpha reference is not provided
| kwPAF: TARGET.DELTA, REFERENCE.DELTA
+----

| name : ddelta :
| descr: projected separation between the reference and the target star along the delta axis. Based on dalpha*, APES recomputes "delta reference".

| units: arcsec
| type : string
| value:
| range:
|example : 8.234
| usage: general
| defau: no default, mandatory only if delta reference is not provided
| kwPAF: TARGET.DELTA, REFERENCE.DELTA
+----

| name : mualpha*
| descr: alpha proper motion in the Hipparcos format
* units: [arcsec/yr]
| type : float
* range: +/- 5000
| usage: general, mandatory
| defau: 0
| kwPAF: TARGET.MUALPHA, (REFERENCE.MUALPHA not present)
+----

| name : mudelta
| descr: alpha proper motion
* units: [arcsec/yr]
| type : float
* range: +/- 5000
| usage: general, mandatory
| defau: 0
| kwPAF: TARGET.MUDELTA, (REFERENCE.MUDELTA not present)
+----

| name : equinox
| descr: date of coordinates [year]
| units: [year]
| type : integer
| range: 1900...2100
| usage: general, mandatory
| defau: 2000
| kwPAF: COORDINATES.EQUINOX
+----

| name : parallax
| descr: parallax
| units: [milli-arcsec]
| type : float
| range: no range
| usage: PDEC, mandatory
| defau: 100
| kwPAF: TARGET.PARALLAX. REFERENCE.PARALLAX
+----

| name : coord_syst
| descr: coordinates System Default
| units: no units
| type : string
* range: "ICRS", "FK5"
| usage: No usage in Apes, will be included in the PAF File, mandatory
| defau: "ICRS"
| kwPAF: COORDINATES.SYSTEM
+----

| name : magV
| descr: magnitude in V band
| units:
| type : float
| range:
| usage: No usage in Apes, Mandatory for P2PP
| defau: no default
| kwPAF: TARGET.VMAG, REFERENCE.VMAG
+----

| name : magH
| descr: magnitude in H band
| units:
| type : float
| range:
| usage: No usage in Apes, Mandatory for P2PP
| defau: no default
| kwPAF: TARGET.HMAG, REFERENCE.HMAG
+----

| name : magK
| descr: magnitude in K band
| units:
| type : float
| range: no range
| usage: ETC
| defau: no default
| kwPAF: TARGET.KMAG, REFERENCE.KMAG
+----

| name : SP_type
| descr: spectralType
| units: no unit
| type : string
| range:
| usage: No usage in Apes.
| defau: no default
| kwPAF: USER.DATA.SP_type
+----

OPTIONAL KEYWORDS

| name : Tint_max
* descr: maximum integration time allowed on the faint target.
* units: seconds
* type : double
* range: 1..N
* usage: upper value for the DIT on the faint target. Larger value would decrease the astrometric accuracy
* defau: 30
| kwPAF: USER.DATA.Tint_max
+----

| name : stdev_Dphi
| descr: sigma delta Phi (Differential Phase Error)
* units: [micro-arsec]
| type : float
| range: 10 .. 1000
| usage: Requested error on the measurement of the differential phase. ETC uses that value to compute the
| defau: 30
| kwPAF: USER.DATA.stdev_Dphi
+----

| name : B_calib
* descr: Use target as a baseLine calibrator (Yes|No)
| units: no units
| type : string
| range: "Y", "Yes", "yes", "N", "No", "no", ...
* usage: No usage in Apes, No usage in the templates. Is included in the PAF File for the DRS
| defau: "YES"
| kwPAF: BASELINE.CALIBRATOR
+----

| name : Teff
| descr: effective Temperature
* units: Kelvin
| type : float
* range: 2000 10000
| usage: No usage in Apes, will be included in the PAF File
| defau: no default
| kwPAF: USER.DATA.Teff
+----

| name : lambda_eff
| descr: effective wavelength
| units: [mu]
| type : float
| range:
| usage: No usage in Apes, will be included in the PAF File
| defau: no default
| kwPAF: USER.DATA.lambda_eff
+----

| name : MS_tar
| descr: target Mass Star
| units:
| type : float
| range:
| usage: No usage in Apes, will be included in the PAF File
| defau: no default
| kwPAF: USER.DATA.MS_tar
+----

| name : MP_tar
| descr: target Mass Planet
| units:
| type : float
| range:
| usage: No usage in Apes, will be included in the PAF File
| defau: no default
| kwPAF: USER.DATA.MP_tar
+----

| name : Vsini
| descr: rotational Velocity
| units:
| type : float
| range:
| usage: No usage in Apes, will be included in the PAF File
| defau: no default
| kwPAF: USER.DATA.Vsini
+----

| name : FeH
| descr: metallicity
| units:
| type :
| range:
| usage: No usage in Apes, will be included in the PAF File
| defau: no default
| kwPAF: USER.DATA.FeH
*
* A ENLEVER DU CATALOGUE. CA SERA CALCULE DANS APES
*+----

*| name : visibility
*| descr:
*| units:
*| type :
*| range:
*| usage: ETC
*| defau: no default
*| kwPAF: TARGET.VISIBILITY, REFERENCE.VISIBILITY
+----

| name : activity
* descr: chromospheric activity as expressed by the index Log(R'_HK)
(the fractional Ca II H and K flux, corrected for the photospheric flux).
| units: none
| type :
| range:
| usage: No usage in Apes, will be included in the PAF File
| defau: no default
| kwPAF: USER.DATA.activity
+----

* It was Dmas. Now called Rrsol
* name : r
* descr: Linear diameter of the target
* units: Solar radius
* type : float
| range:
* usage: Used in APES to compute the expected visibility, the accuracy on the phase or the integration time
| defau: 1
| kwPAF: USER.DATA.Dmas
+----

| name : T0_1 (T0_2, T0_3)
| descr: Date of passage at periastron
| units: [jd]
| type : float
| range:
| usage: PDEC: Astrometric motion
| defau: 53371
| kwPAF: USER.DATA.T0_1 (USER.DATA.T0_2 ,USER.DATA.T0_3)
+----

| name : period_1 (period_2, period_3)
| descr: orbital period (previously called: P_day)
| units: [day]
| type : float
| range: > 0
| usage: PDEC: Astrometric motion
* defau: no default
| kwPAF: USER.DATA.period_1 (USER.DATA.period_2 ,USER.DATA.period_3)
+----

| name : ecc_1 (ecc_2, ecc_3)
| descr: eccentricity
| units: no unit
| type : float
* range: 0...<1
| usage: PDEC: Astrometric motion
| defau: 0
| kwPAF: USER.DATA.ecc_1 (USER.DATA.ecc_2 ,USER.DATA.ecc_3)
+----

| name : a_1 (a_2, a_3)
* descr: semi-major axis of the barycentric orbit of the parent star (induced by planet 1,2,3) previously called: a_muas)
* units: [1e-3 au]
| type : float
| range: no range
| usage: PDEC: Astrometric motion
| defau: 999
| kwPAF: USER.DATA.a_1 (USER.DATA.a_2 ,USER.DATA.a_3)
+----

* name : inc_1 (inc_2, inc_3)
* descr: inclination of the orbit 1,2,3 (previously called: inc_deg)
| units: [deg]
| type : float
| range:
| usage: PDEC: Astrometric motion
| defau: 0.
| kwPAF: USER.DATA.inc_1 (USER.DATA.inc_2 ,USER.DATA.inc_3)
+----

* name : omega_1 (omega_2, omega_3)
* descr: Longitude of periastron of orbit 1,2,3 (previously called: omega_deg)
| units: [deg]
| type : float
| range:
| usage: PDEC: Astrometric motion
| defau: 0.
| kwPAF: USER.DATA.omega_1 (USER.DATA.omega_2 ,USER.DATA.omega_3)
+----

* name : OMEGA_1(OMEGA_2, OMEGA_3)
* descr: Longitude of the ascending node or orbit 1,2,3 (previously called: OMEGA_deg)
| units: [deg]
| type : float
| range:
| usage: PDEC: Astrometric motion
| defau: 0.
| kwPAF: USER.DATA.OMEGA_1 (USER.DATA.OMEGA_2 ,USER.DATA.OMEGA_3)
+----


2>Past data measurement catalog :
Menu : File -> New Observing run

Follow the steps and choose :
-Date selection
-Baseline selection
-Star catalog selection
-Past data catalog selection
-Observing run definition


+----
| name : target
| descr: target object code
| units: no units
| type : string
| range: no range
| defau: no default, mandatory
*+----NOT NECESSARY
*| name : reference
*| descr: reference object code
*| units: no units
*| type : string
*| range: no range
*| defau: no default, mandatory
*+----
* name : jd
* descr: observation date in julian date
* units: [jd]
* type : double
| range: no range
| defau: no default, mandatory
+----
| name : Beast_m
* descr: Baseline vector component (east)
| units: [m]
| type : float
| range:
| defau: no default, mandatory
+----
| name : Bnorth_m
* descr: Baseline vector component (north)
| units: [m]
| type : float
| range:
| defau: no default, mandatory
+----
| name : Bup_m
* descr: Baseline vector component (up)
| units: [m]
| type : float
| range:
| defau: no default, mandatory
*+---- one can remove this
* name : Dphi_arcsec
* descr: Differential phase measurement
* units: [asec]
* type : float
* range:
* defau: no default, mandatory
+----
| name : errDphi_microarcsec
| descr: error on the differential phase measurement
| units: [asec]
| type : float
| range:
| defau: no default, mandatory
+----