HMI Ring Diagrams
Data Product Descriptions

sha.GONGmrcoy

Description

The publicly available GONG site data have a keyword PA for the position angle of solar north on the image, but it is uniformly set to 90.0. Additional information needed to correct the image position angle on a minute-to-minute basis is provided in a set of separately available coefficients for a polynomial expansion in the hour angle up to 5th order. These coefficents are contained in a separate set of files, one per day, containing the coefficients determined for each site, along with data for the Ronchi rulings during drift scans from which the coefficients are determined.

A minimal mrcoy file contains only the coefficients:

***** CAMINTERP: 00/07/30 18:20:48  GRASP V00.6.1 *****
Site  N       a0        a1        a2        a3        a4        a5
 LE   5    0.09266   0.08739  -0.05906  -0.01650   0.00000   0.00000   
 UD   5   -0.04103  -0.09536   0.09540  -0.01772   0.00000   0.00000   
 TD   5   -0.08568   0.29049   0.04197  -0.14017   0.00000   0.00000   
 CT   5    0.18466   0.23586   0.01149  -0.03835   0.00000   0.00000   
 TC   5    0.10404   0.09192   0.03245  -0.02850   0.00000   0.00000   
 BB   5    0.46990  -0.19868  -0.05450  -0.05112   0.00000   0.00000   
 ML   5   -0.01161  -0.24613  -0.02173   0.05717   0.00000   0.00000

Ronchi data are included in files since 2001.07.22:

   ******* CAMINTERP V2.50 ROFULL 05/09/08 11:54:06  GRASP V02.6 *******   
 GPS_Date Site  N       a0        a1        a2        a3        a4        a5
2001/07/22 LE   5    0.05380   0.01839  -0.01852   0.04026   0.00000   0.00000   
2001/07/22 UD   5    0.18050  -0.05550   0.07063  -0.02301   0.00000   0.00000   
2001/07/22 TD   5   -0.00465   0.12584  -0.04902  -0.02591  -0.01437   0.00000   
2001/07/22 CT   5    0.07134   0.24143   0.04437  -0.04923  -0.00104   0.00000   
2001/07/22 TC   5    0.03481   0.06334   0.06225  -0.03417   0.00000   0.00000   
2001/07/22 BB   5   -0.06774  -0.19807   0.00163   0.02857  -0.02256   0.00000   
2001/07/22 ML   5   -0.01279  -0.18097  -0.03766   0.01484   0.00000   0.00000   
                                                      
  Ronchi Information from: home$drift/Pre_030207_ronchi
 -------------------------------------------------------
SITE  PERIOD   AMPLITUDE   PHASE     MOTOR2   DATE RECORDED
 -------------------------------------------------------
LE    360.0   0.019960   0.136070     1790364    2003/03/21
LE     90.0   0.012370  -0.384220     1790364    2003/03/21
LE     10.0   0.004220   0.252420     1790364    2003/03/21
LE      5.0   0.001600   0.275530     1790364    2003/03/21
LE     30.0   0.000860   0.379450     1790364    2003/03/21
TD    360.0   0.012270  -0.373040     1737862    2001/07/25
TD     10.0   0.008350   0.363490     1737862    2001/07/25
TD     90.0   0.003250  -0.044180     1737862    2001/07/25
TD      5.0   0.001550  -0.081690     1737862    2001/07/25
TD     45.0   0.000930   0.039590     1737862    2001/07/25
TD    180.0   0.000900   0.200190     1737862    2001/07/25
TC     90.0   0.014530  -0.083320     2948790    2001/09/19
TC    360.0   0.006290  -0.346260     2948790    2001/09/19
TC     45.0   0.002540   0.435270     2948790    2001/09/19
TC      5.0   0.001420   0.046680     2948790    2001/09/19
TC     10.0   0.001400   0.050400     2948790    2001/09/19
TC     30.0   0.001170   0.078730     2948790    2001/09/19
ML    360.0   0.018470  -0.113760     1168205    2002/02/02
ML     90.0   0.013870  -0.405730     1168205    2002/02/02
ML     10.0   0.010420  -0.321310     1168205    2002/02/02
ML     45.0   0.003500  -0.350730     1168205    2002/02/02
ML    180.0   0.003000  -0.698010     1168205    2002/02/02
CT    360.0   0.020680   0.426050     1500997    2002/05/05
CT     90.0   0.009620   0.052450     1500997    2002/05/05
CT     10.0   0.004170   0.336720     1500997    2002/05/05
CT    180.0   0.003060  -0.488600     1500997    2002/05/05
CT     45.0   0.002220  -0.517830     1500997    2002/05/05
UD    360.0   0.017190  -0.157450      779115    2002/12/15
UD     90.0   0.007550  -0.509870      779115    2002/12/15
UD     10.0   0.004600   0.044790      779115    2002/12/15
UD     45.0   0.002760   0.308840      779115    2002/12/15
UD    180.0   0.002940  -0.413500      779115    2002/12/15
BB     10.0   0.007980   0.140110     1718390    2002/08/18
BB     90.0   0.003160   0.236890     1718390    2002/08/18

The Ronchi information is not included in this data series, however, nor are the coefficients for the testing site TC.

The series contains only a single prime key, Date. All metadata are contained in 36 keys, one for each order 0–5 and for each of the six GONG sites (LE, UD, TD, CT, BB, ML): a0_LE, a1_LE, ..., a5_LE, a0_UD, ..., a5_ML. There are no segments for SUMS data associated with this series.

It may be noted that although the expansion coefficients are recorded to 5th order, the 5th order coefficients have always been 0.0 to date. Likewise, the a4 coefficients have been identically 0.0 for sites LE, UD, and ML, and are non-zero for a small fraction of the 8447 days included to date: 353 for TD, 676 for CT, and 10 for BB.

Processing Status

The records in this series have been populated from the mirrored GONG mrcoy files by the script ~rick/gong/updpacordb. using the module append_mrcoy

Records have been completely populated from 2000.01.01 (before the advent of GONG+ site data),a nd are regularly updated as mrcoy data become available, usually about twicea month.

A Note on metadata in the GONG pre-merge site data

The mrcoy coefficients are used to set an OFFSET keyword value for the corrected position angle for each site image. A comparison has been made of the keywords in the final pre-merge FITS files for Dopplergrams at five sites on 2023.03.25 with the comparable files from the mirrored site vzi data. The comparisons are based on the first and last common images for each site:

bbvzi230325t1733
bbvzi230325t2359
ctvzi230325t1142
ctvzi230325t2157
levzi230325t0010
levzi230325t0940
tdvzi230325t0812
tdvzi230325t1830
udvzi230325t0158
udvzi230325t1230

The following common keywords differ in value:

DATE
IRAFNAME
ORIGIN

The following common keywords differ only in format if at all, with consistent values, but possibly more precision, and never less, in the mirrored files:

A_5_
A_5__ERR
A_6_
A_6__ERR
A_7_
A_7__ERR
ELEV
GONGPLUS
IRAF-BPX
IRAF-MAX
IRAF-MIN
IRAFTYPE
LTM1_1
LTM2_2
LTM3_3
PIXLENX
PIXLENY
P_ANGLE
RIN
SKYVALUE

The following keywords in the mirrored files are dropped from the final pre-merge files:

BPOL
BPOLARTY
CAM_TEMP
ECLIPSE
EXPTIME
FRAMRATE
HISTORY
IPERMI
LIMBMEDN
LIMBPTCT
OBJECT
TFACTOR
THRSHCLC
WIND2DIR
WIND2MON
WIND2SET
WIND2SPD

The following keywords absent from the mirrored files are added in the final pre-merge files. Those marked with a C have a uniform value in all 10 sample files:

CDELT1		C	(and identically 0.00000 [solar radii/pixel]!)
CDELT2		C	(")
COMMENT		C
CRPIX1
CRPIX2
CRVAL1		C
CRVAL2		C
CTYPE1		C
CTYPE2		C
DATATYPE	C
EPH_B0			identical to B0
EPH_DEC			identical to DEC
EPH_L0			similar to L0 with two extra (meaningless) digits of precision
EPH_R0			differs from RADIUS at the level of 0.00000017 rad ~ 0.036 arcsec
EPH_RA			identical to RA
FITSWASH	C
GONGKEY1	C
GONGKEY2	C
GONGKEY3	C
IMGADV01
IMGKUR01
IMGMAX01
IMGMIN01
IMGMN01
IMGRMS01
IMGSKW01
IMGVAR01
IMG_MA			identical to C_MA (!= FNDLMBMA)
IMG_MI			identical to C_MI (!= FNDLMBMI)
IMG_X0			identical to FNDLMBXC
IMG_Y0			identical to FNDLMBYC
IMTYPE		C
OBS-SITE	C
OBS-URL		C
OFFSET
OFFSET_A
OFFSET_B
PLATFORM	C
RONCHI_1
RONCHI_2
RONCHI_3
RONCHI_4
RONCHI_5
RONCHI_6
TELESCOP	C
VUNIT		C
WAVELNTH	C
WCSNAME		C

The remaining keywords are identical:

ACCUM	 ANN_CTYP AN_ERR   AUTOCAL  AUTOCAL0 AUTOCAL1 AVPDATE  AVPENV   AVPUSER
AVPVER   A_1_     A_1__ERR A_2_     A_2__ERR A_3_     A_3__ERR A_4_     A_4__ERR
B0       BAROMET  BETA     BITPIX   BSCALE   BZERO    CAL_DONE CAL_LENS CAMX_MAX
CAMX_MIN CAMY_MAX CAMY_MIN CAM_TYPE CENTER   CENTROXC CENTROYC CHI2     CLKMODE
CMA_ERR  CMI_ERR  COMPRESS CONNECT  COUNT    C_MA     C_MI     DAS_STAT DATE-OBS
DEC      DELTA_L0 DIODAMPL DIODE1   DIODE2   DIODE3   DISTANCE DONUT    DRMIN
DTYPE    EAST     END      EPITCH   EROLL    EROTATOR EXTYPE   EXT_QUAL EXT_SLOP
FCOL     FLATTED  FNDLMBAN FNDLMBMA FNDLMBMI FNDLMBXC FNDLMBYC FROW     GHIST*
GPSSTAT  GRASPVER GUIDE    HA       HDBANK   HDLVL    HORIZON  HUM_INS  HUM_OUT
INSTMODE INSTTIME ITIME    J2000    L0       LAST_PM  LAT      LCOL     LHOFS0
LHOFS1   LHOFS2   LMB_GRAD LON      LONG     LROW     LST      MAGNETO  MAX_ITR
MAX_ZERO MA_ERR   MI_ERR   MOD_TYPE MOTOR0   MOTOR1   MOTOR2   MOTOR3   MOTOR4
MTF_FILE NAXIS    NAXIS1   NAXIS2   NTERMS   NZF_MA   NZF_MI   ORDER    OSC_DAC
PA       PHASE    PITCH    PMFLAG   RA       RADIUS   RADLIM   RAD_NET  REJECT
REPLACE  ROLL     ROTATOR  ROUT     RSCALE   SEARCH   SEMIDIAM SIMPLE   SITE
SITENAME SLR      SN_CAM   SN_DAS   SN_MOD   SN_ROT   SPT2DSK  SUNUP    TAPEBANK
TAPELVL  TEMP_INS TEMP_OUT TEMP_RAC TEMP_TBL THRESH   TIME-OBS TIMEZONE TYPE
VALID    VCOR1    VCOR2    VCOR3    VCOR4    VELOCITY VELSCALE VEL_BIAS VERSION
WAT0_001 WAT1_001 WAT2_001 WAT3_001 WAXMAP01 WCSDIM   WEST     WHEEL_1  WHEEL_2
WIND_DIR WIND_SPD XC_ERR   X_CENTER YC_ERR   Y_CENTER ZENITH

JSOC Series Definition

#=====Global Series Information=====
Seriesname:		sha.GONGmrcoy
Description:		"Derived GONG position angle rotation coefficients"
Author:			"Rick Bogart"
Unitsize:		1
Archive:		0
Retention:		90
StagingRetention:	3
Tapegroup:		0
PrimeKeys:       	Date

#=====Links=====

# ===== Keyword list ===== #
# Format:
#   Keyword: , link, , , 
# or
#   Keyword: , , {constant | variable}, {record | segment}, 
#            , , , 
       
Keyword: Date,  time,  variable, record, JD_0, 0, "UT", ""
Keyword: a0_LE, float, variable, record,     NaN, %.5f, " ", "a0: Learmonth"
Keyword: a1_LE, float, variable, record,     NaN, %.5f, " ", "a1: Learmonth"
Keyword: a2_LE, float, variable, record,     NaN, %.5f, " ", "a2: Learmonth"
Keyword: a3_LE, float, variable, record,     NaN, %.5f, " ", "a3: Learmonth"
Keyword: a4_LE, float, variable, record, 0.00000, %.5f, " ", "a4: Learmonth"
Keyword: a5_LE, float, variable, record, 0.00000, %.5f, " ", "a5: Learmonth"
Keyword: a0_UD, float, variable, record,     NaN, %.5f, " ", "a0: Udaipur"
Keyword: a1_UD, float, variable, record,     NaN, %.5f, " ", "a1: Udaipur"
Keyword: a2_UD, float, variable, record,     NaN, %.5f, " ", "a2: Udaipur"
Keyword: a3_UD, float, variable, record,     NaN, %.5f, " ", "a3: Udaipur"
Keyword: a4_UD, float, variable, record, 0.00000, %.5f, " ", "a4: Udaipur"
Keyword: a5_UD, float, variable, record, 0.00000, %.5f, " ", "a5: Udaipur"
Keyword: a0_TD, float, variable, record,     NaN, %.5f, " ", "a0: El Teide"
Keyword: a1_TD, float, variable, record,     NaN, %.5f, " ", "a1: El Teide"
Keyword: a2_TD, float, variable, record,     NaN, %.5f, " ", "a2: El Teide"
Keyword: a3_TD, float, variable, record,     NaN, %.5f, " ", "a3: El Teide"
Keyword: a4_TD, float, variable, record, 0.00000, %.5f, " ", "a4: El Teide"
Keyword: a5_TD, float, variable, record, 0.00000, %.5f, " ", "a5: El Teide"
Keyword: a0_CT, float, variable, record,     NaN, %.5f, " ", "a0: Cerro Tololo"
Keyword: a1_CT, float, variable, record,     NaN, %.5f, " ", "a1: Cerro Tololo"
Keyword: a2_CT, float, variable, record,     NaN, %.5f, " ", "a2: Cerro Tololo"
Keyword: a3_CT, float, variable, record,     NaN, %.5f, " ", "a3: Cerro Tololo"
Keyword: a4_CT, float, variable, record, 0.00000, %.5f, " ", "a4: Cerro Tololo"
Keyword: a5_CT, float, variable, record, 0.00000, %.5f, " ", "a5: Cerro Tololo"
Keyword: a0_BB, float, variable, record,     NaN, %.5f, " ", "a0: Big Bear"
Keyword: a1_BB, float, variable, record,     NaN, %.5f, " ", "a1: Big Bear"
Keyword: a2_BB, float, variable, record,     NaN, %.5f, " ", "a2: Big Bear"
Keyword: a3_BB, float, variable, record,     NaN, %.5f, " ", "a3: Big Bear"
Keyword: a4_BB, float, variable, record, 0.00000, %.5f, " ", "a4: Big Bear"
Keyword: a5_BB, float, variable, record, 0.00000, %.5f, " ", "a5: Big Bear"
Keyword: a0_ML, float, variable, record,     NaN, %.5f, " ", "a0: Mauna Loa"
Keyword: a1_ML, float, variable, record,     NaN, %.5f, " ", "a1: Mauna Loa"
Keyword: a2_ML, float, variable, record,     NaN, %.5f, " ", "a2: Mauna Loa"
Keyword: a3_ML, float, variable, record,     NaN, %.5f, " ", "a3: Mauna Loa"
Keyword: a4_ML, float, variable, record, 0.00000, %.5f, " ", "a4: Mauna Loa"
Keyword: a5_ML, float, variable, record, 0.00000, %.5f, " ", "a5: Mauna Loa"

#=====Segments=====

HMI Ring Diagrams

6 Feb 2024, 14:43-0800