c a read routine to convert a binary vgr file to ascii c 12/8/2022 c c Routine to read voyager mission tapes. c c The following parameters are returned: c real: ANS(150): Only selected elements of the standard c answer array is filled from the mission c tape record header. c ANS(5-7): Magnetic field components in S/C coordinates. c If LPLS(28) is false (no sedr connected which c is the default) then it will contain Bn,Bt, c and Br in that order. c ANS(8): The magnitude of the magnetic field. c ANS(13): The value 1 if read as an integer c ANS(38): Proton density in #/cc, moment c ANS(53): Proton thermal speed in km/s (fit) c ANS(59): Alpha density in #/cc, fit c ANS(96-98): RTN coordinates of magnetic field in gammas c ANS(99-101): RTN coordinates of proton velocity km/s c ANS(117): Alpha density in #/cc, moment c ANS(133): Proton thermal speed in km/s (moment) c c NOTE: The distance from the Sun could have been c also filled in but hasn't been yet. c Also, the ANS array is not filled for E1 and E2 modes. c c int*2: JTB(6): Time of the read spectra set with elements: c JTB(1): Year in 4 digit form (e.g. 1979) c JTB(2): Day of year c JTB(3): Hour of day c JTB(4): Minute of hour c JTB(5): Second of minute c JTB(6): mSecond of second (it increments by 4) c int*2: JDATA(512): Digital currents in channels. 64 elements c are filled for L mode, 512 for M, and 16 c for E1 and E2. The rest of the elements c are filled with -1's. c int*2: JNE: The number of channles for a cup: 128 for M mode, c and 16 for L, E1, and E2 modes. c int*4: LSTAT: Status word. Only one byte of the status word is stored on a c mission tape. It is copied twice at the bottom 2 bytes of c LSTAT. The upper half word is set to be 0. c The last 4 bits of the low order byte of the c status word has the following meaning: c XX Y Z: are the individual bits: c where XX: 00 = PLS reverse grid c 01 = PLS mod voltage monitor c 10 = PLS Current Calibration c 11 = PLS normal grid c Y: 1 = PLS; 0 = IDC c Z: Modulator 1= On; 0 = Off c int*2: JTLMOD: Mode type: 1 - L; 2 - M; 3 - E1; 4 - E2; c In case of an error it is set to 1. c int*2: JCLK: Cup integration time index: 1 - 30 ms; 2 - 210 ms; c 3 - 930 ms c real*4: TEMP(3): Not used. c int*4: IEOD: Error flag: 0 - ok; -1 - read 0 bytes, end of file; c -2 - read error from twait in bat.c c int*4: IL: Not used. c char*4: IDTYPE: 'VGRT' c c In this routine, elements of the common blocks CMODE and BFLDCM c are updated. c LOGICAL LSYS(32), LMAG(32), LPLS(32) include "vgrcom.i" COMMON /CCA/ LSYS, LMAG, LPLS ,IDUM(8), IDSC COMMON /CMODE/ IYR,IDOY,IHR,IMIN,SEC,ICLK 1 ,ISTATA,ICOMM,IDATAN(4,144),ITLMOD 2 ,TTMP(3),IENGDN(9),MODTAL,IKINDS,MINDEX,MODTLM c c The following elements of this common block are filled in this c routine: c int*4: IYR: 4 digit year of read spectra set. c int*4: IDOY: Day of year c int*4: IHR: Hour of day c int*4: IMIN: Minute of hour c real*4: SEC: Seconds of minute c int*4: ICLK: Cup integration time index (Same as JCLK above) c int*4: ITLMOD: Mode type (Same as JTLMOD above) c common /bfldcm/ xtbnew, xtbold, bxyz(3) c c The following elements of this common block are filled in this c routine: c real*8: XTBNEW: 5.5d+20 c equivalence (aone,iaone) real*8 xtbnew, xtbold equivalence (bxn,bxyz(1)) equivalence (byn,bxyz(2)) equivalence (bzn,bxyz(3)) integer iyr,idoy,ihr,imin,iclk,istata,icomm,idatan,itlmod integer iengdn,modtal,mindex, idum,idsc common /cvgrrew/ iu, iout,iconv, iave integer iu,iout,iconv, iave character*4 ikinds real sec, anstmp(12) integer il, ieod,lstat REAL ANS(150), TEMP(3) INTEGER*2 JTB(6),JDATA(512),JNE,JTLMOD,JCLK integer*2 jtbs(6) character*4 idtype, ical integer*2 jnea(8) data iaone /1/ c Channel number in a cup for L, M, E1 and E2 modes. c The upper 4 values are not used. data jnea / 16, 128, 2*16, 16, 0, 2*16/ data ical /'VGRT'/ ans(1) = preset call mvc( ans(1), ans(2), 4*148) IDTYPE = ICAL IEOD = 0 c c Read mission tape. ANSTMP still could be in IBM format. c For details see the inline documentation for vgrtrd.f c 1 call vgrtrd( anstmp, jtb, jdata, jne, lstat, jtlmod, jclk, ieod) c c If error is encountered, set mode to L and return. c if(ieod .ne. 0) go to 9998 c c Fill the CMODE element of the mode type flag and return if c it is outside of the meaningful range. c ITLMOD = jtlmod if (jtlmod .lt. 1 .or. jtlmod .gt. 8) return c c Unpack times. See mission tape doc for packing order. c jtb(1) = jtb(1) + 1900 c added by cw-laf 1/20/2000 if(jtb(1) .LT. 1970) jtb(1) = jtb(1) + 100 if (jtb(3) .lt. 100) go to 50 jtb(3) = jtb(3) - 100 jtb(2) = jtb(2) + 256 50 continue c Check if the mission tape was generated on a SUN or an IBM c if (jtb(3) .gt. 24) write(6,8899) jtb 8899 format("IBM!!!!",6i5) if (jtb(3) .gt. 24) then c statment below may be different for voyager 1 jtb(3) = jtb(3) - 25 iconv = 0 else iconv = 2 end if jtb(6) = jtb(6)*4 c if( jtb(2) .ne. 26) go to 1 c if(jtlmod .ne. 3) go to 1 idiff = (jtb(2)-jtbs(2))*1440*60+(jtb(3)-jtbs(3))*3600 * +(jtb(4) -jtbs(4))*60 +jtb(5)-jtbs(5) rmin = 1.*idiff/96. c write(6,1243) idiff,jtlmod,jtb,rmin c write(6,1209) idiff,rmin 1209 format("time ", i10,f10.3) do 1990 k = 1,6 1990 jtbs(k) = jtb(k) c write(6,1234) (jdata(k), k = 1,16) 1234 format(16I4) 1243 format(' readvgr ', 8i5,f10.3) c c If ICONV is 2 convert ibm to SUN floating point c If ICONV is 0 don't convert, tape was written by SUN. c Currently ICONV is initialized to 2 in the block data nxtvgrdata c and is stored in the CVGRREW common block. New mission tapes c are in SUN format. That info is packed in the time array. c See mission tape doc for more details. c c Only the floating data read by vgrtrd need conversion, that is c the 12 element array ANSTMP. c c if (iconv .gt. 1) call icvtf( anstmp, 12, anstmp) c c The mission tape contains only RTN components of the magnetic field. c If LPLS(28) of the CCA common block is .true. (it is default c to be .false.) then use SEDR info to convert the magnetic field c vector into S/C coordinates. Currently this calculation is done c later on and this option is not used. If LPLS(28) is .false., c RTNSns(8) = sqrt( bxn**2 + byn**2 + bzn**2 )CB just exchanges the first and third components of the c input vector. c c Setup variables and the PLSCOM common block for future use c of PLSEDMX routine. c call plsedm( jtb, ieod) c + (ANS,JTB,JDATA,JNE,LSTAT,JTLMOD,JCLK,TEMP,IEOD,IL,IDTYPE) c c Do the RTN -> S/C coord conversion if appropriate c call rtnscb( bxyz, anstmp( 9)) c c Fill the S/C coordinates of the magnetic field vector. If LPLS(28) c is .false., ANS(5-7)=Bn,Bt,Br in that order. c ans(5) = bxn ans(6) = byn ans(7) = bzn c c Calculate the magnitude of the field vector c ans(8) = sqrt( bxn**2 + byn**2 + bzn**2 ) c c Flag to GETFLD to use our B values c ans(13)=aone xtbnew = 5.5d+20 c c Fill the proton density and velocity RTN components c ans( 38) = anstmp(1) ans( 99) = anstmp(2) ans(100) = anstmp(3) ans(101) = anstmp(4) c c Fill the proton thermal speed from fit result c ans(53) = anstmp(6) c c Fill the proton thermal speed from moment calculations c NOTE: the sum of the moment thermal speeds in the 3 cups c is not divided by 3 on IBM mission tapes. c ans(133) = anstmp(5) if (iconv .eq. 2) ans(133)=ans(133)/3. c c Fill the alpha density from moment and fit calculations c ans(117) = anstmp(7) ans( 59) = anstmp(8) c c Fill the magnetic field RTN components c ans( 96) = anstmp(9) ans( 97) = anstmp(10) ans( 98) = anstmp(11) c c Fill elements of the CMODE common block c iclk = jclk jne = jnea(jtlmod) iyr = jtb(1) idoy = jtb(2) ihr = jtb(3) imin = jtb(4) sec = jtb(5) + jtb(6)/1000. c output to ascii write(6,1099) jtb,mindex,modtlm,lstat,jne,jtlmod,jclk 1099 Format(8i5,z9,3I5) write(6,1199) anstmp 1199 format(12e12.5) if(jtlmod.le.2) n5=4*jne if(jtlmod.gt.2) n5=16 write(6,1092) (jdata(k),k=1,n5) 1092 format(16i4) go to 1 9998 continue end c SUBROUTINE VGRREW(LBEGDS) LOGICAL LBEGDS character*4 UNIT integer iout COMMON /IO/ UNIT,BUF(10000),IBLKS,IBUFL,IBS ,NERR, A ILN,ILNP,INPREC,IPL,IML,ILREC,IMOD,IST,IOFF,ISTD,ICRHBL,iout INTEGER IBUF(10000) INTEGER*2 IHBUF(20000) EQUIVALENCE (BUF(1),IBUF(1)),(BUF(1),IHBUF(1)) COMMON /IOFFST/ IID,ITEL,ISCID,ITST,ITSP,IP,ITIM,NC A ,NE,INC,IIANS,ISTAT,ICOM,ID2,IDATA(4),ITYPE,ITLFMT B ,INE,IMSTAR,INREC,INWORD DATA UNIT /'ft32'/ IF (LBEGDS) GO TO 3000 CALL WAIT(UNIT, LEN, IEOD) MARK = 1 IF (IEOD .EQ. -1) MARK = 2 c CALL TSKIP(UNIT, .FALSE., -MARK, 0) CALL newreadbat(UNIT, BUF(1), 1) CALL newreadbat(UNIT, BUF(IBS), IBUFL*2) c CALL WAIT(UNIT, LEN, IEOD) RETURN 3000 WRITE(6,*)'REWINDING MISSION TAPE/FILE.' c CALL TCLOSEBAT(UNIT) RETURN END C 06/26/85 19:38:58 06/26/85 19:38:21 $380300.MJS c 6-28-89 gsg changed calling sequence for plsedmx c 10-25-89 gsg jr. pulled from nxtedr.f and modifier to get transformations c both ways C PLSEDM W/ENTRIES - SCRTNB, SCRTNV C SEDRB - DUMMY ROUTINE (THE VERSION OF "SEDRB" WHICH ACTUALLY C DOES ANYTHING IS AN ENTRY POINT - ALONG WITH "SCRTNB" C AND "SCRTNV" - IN THE SUBROUTINE "PLSEDG" LOADED IN C THE MODULE "NXTSUM"). subroutine plsedm( jjtbh, iieodc) integer*2 jtbh(6),jjtbh(6) common /plscom/ jtbh,ieodc real vi(3), vo(3) integer i data i /1/ do 10 j=1,6 jtbh(j) = jjtbh(j) 10 continue ieodc = iieodc call plsedmx( jtbh, ieodc, vo, vi, i) return end subroutine scrtnb( bo, bi) real bo(3), bi(3) common /plscom/ jtbh,ieodc integer*2 jtbh(6) integer i data i /2/ call plsedmx( jtbh, ieodc, bo, bi, i) return end subroutine scrtnv( vo, vi) real vo(3), vi(3) common /plscom/ jtbh,ieodc integer*2 jtbh(6) integer i data i /3/ call plsedmx( jtbh, ieodc, vo, vi, i) return end subroutine rtnscb( bo, bi) real bo(3), bi(3) common /plscom/ jtbh,ieodc integer*2 jtbh(6) integer i data i /4/ call plsedmx( jtbh, ieodc, bo, bi, i) return end subroutine rtnscv( vo, vi) real vo(3), vi(3) common /plscom/ jtbh,ieodc integer*2 jtbh(6) integer i data i /5/ call plsedmx( jtbh, ieodc, vo, vi, i) return end SUBROUTINE PLSEDMx(JTBH,IEODC, vo, vi, itype) C DATE JULY 1 1978 C c modified by gsg jr. to work with vgr tapes c C THE ENTRIES PLSEDM, SCRTNV, AND SCRTNB ARE TO BE USED WITH C THE EDR TAPE ANALYSIS PACKAGE AT MIT. THEY PERFORM THE C TRANSFORMATIONS FROM S/C COORDINATES TO RTN FOR VELOCITY C AND MAGNETIC FIELD VECTORS. PLSEDM IS CALLED FROM THE MAIN C ROUTINE TO PASS THE TIME ( JTBH AS I*2) AND UNIT NUMBER TO C READ THE CSEDR TAPE. THE TIME IS SAVED AND USED BY SCRTNV C AND SCRTNB TO DO THE TRANSFORMATIONS UNTIL A NEW TIME IS C SAVED BY ANOTHER CALL TO PLSEDM. SCRTNV AND SCRTNB ARE C CALLED WITH AN OUTPUT VECTOR ( VO), AND AN INPUT VECTOR C ( VI). THESE CALLS ARE THE SAME AS USED IN THE GSFC C PACKAGE. THE PACKAGE OF SUBROUTINES GETBLK, REDSED, VREAD, C AND ITIME ARE USED TO READ AND SET UP THE CSEDR TAPES. C THE TRANSFORMATIONS ARE DONE AS PER THE VOYAGER MEMO C NO. 33. C C NOTE -- C -------- C THE LAST ARGUMENT PASSED TO PLSEDM IS AN END OF DATA FLAG. C IT IS SET BY SCRTNB(V), AND IS RETURNED BY PLSEDM FOLLOWING C ITS NEXT CALL.. THIS ALLOWS FOR FINDING OUT ABOUT ERRORS C IN THE MAIN PROGRAM, INSTEAD OF IN PRANAL. IF AN EOR OR ERROR C OCCURRED DURING THE LAST TRANSFORMATION, THE ANALYSIS MAY BE C STOPPED PROPERLY. C C CLIFF HAFEN, 27 APR 78. C C ******************************************************************* C * * C * MODIFIED RLM 4/3/84 * C * CSEDR TAPES ARE NOW TOTALLY OBSOLETE. "PLSEDM" NOW CALLS * C * "SXRED" TO OBTAIN LINEARLY INTERPOLATED NAVIGATION AND * C * POINTING DATA AT THE TIME SPECIFIED BY 'JTB'. * C * * C ******************************************************************* C COMMON / CCA/ LSYS, LMAG, LPLS,dum(8),idscx logical LSYS(32), LMAG(32), LPLS(32) COMMON /PLCONS/ JDSRN(15) + /MITRUN/ ICUNIT(16), TJUMP, FACT, GAPSEC(20), FITMOM character*4 FITMOM COMMON/NVBUF/INAV(378) COMMON/PTBUF/IPNT(126) C INTEGER*2 JTBH(6), JDSRN C c LOGICAL NEWNAV, NEWPNT, FIRST, VORB LOGICAL FIRST c LOGICAL*4 LCSEDR ,LSEDR C DIMENSION VO(3), VI(3), JTB(6) + , APNT(22), ANAV(22) + , VT(3), AM5(3,3), AMTB(3,3), AMT(3,3) C EQUIVALENCE ( INAV(1), ANAV(1)), ( IPNT(1), APNT(1)) C DATA FIRST /.TRUE./, IEOD / 0 / c data LCSEDR /.FALSE./,LSEDR /.FALSE./ C go to ( 1000, 2000, 3000, 4000, 5000), itype write (0, *) ' error calling plsedmx. itype=',itype ieodc = -7 return c call exit 1000 continue IERROR = JDSRN(15) IUNIT = ICUNIT(7) DO 100 I = 1,6 JTB(I) = JTBH(I) 100 CONTINUE C IEODC = IEOD return C ********************************************************************* C * * C * ENTRY FOR MAGNETIC FIELD TRANSFORMATION. * C * * C ********************************************************************* c ENTRY SCRTNB ( VO, VI) 2000 continue C ********************************************************************* C * * C * ENTRY FOR VELOCITY TRANSFORMATION. * C * * C ********************************************************************* c ENTRY SCRTNV ( VO, VI) 3000 continue C ********************************************************************* C * * C * ENTRY FOR MAGNETIC FIELD TRANSFORMATION. * C * * C ********************************************************************* c ENTRY RTNSCB ( VO, VI) 4000 continue C ********************************************************************* C * * C * ENTRY FOR VELOCITY TRANSFORMATION. * C * * C ********************************************************************* c ENTRY RTNSCV ( VO, VI) 5000 continue C C CHECK FOR EOD -- USE LAST DATA ( IEOD.EQ.1 ) C 1 IF ( IEOD.EQ.1 ) GO TO 10 IF ( .NOT.LPLS(28)) GO TO 985 IF ( .NOT. FIRST ) GO TO 2 C C CALCULATE M5, WHICH DOESNT DEPEND ON NAV OR PNT BLKS. C C LONGITUDE OF THE ASCENDING NODE OF THE SOLAR EQUATORIAL PLANE C (WITH RESPECT TO ECL50 COORDINATES) = 75.07 DEGREES C INCLINATION OF THE SUN TO THE ECLIPTIC = 7.25 DEGREES C C ALTERNATIVE TECHNIQUE TO USE: C C CALL EULROT(75.07,7.25,0.0,AM5) C DR = 3.141593 / 180. PHI = 75.07 * DR CPHI = COS( PHI) SPHI = SIN( PHI) TH = 7.25 * DR CTH = COS( TH) STH = SIN( TH) AM5(1,1) = CPHI AM5(2,1) = SPHI AM5(3,1) = 0. AM5(1,2) = -SPHI * CTH AM5(2,2) = CPHI * CTH AM5(3,2) = STH AM5(1,3) = SPHI * STH AM5(2,3) = -CPHI * STH AM5(3,3) = CTH C C GET NAV AND PNT BLKS FOR TIME JTB. C 2 continue c CALL SXRED3 (IUNIT,IEOD,JTB) C C STOP HERE ONLY IF ERROR ON FIRST READ. C IF ( FIRST .AND. IEOD.NE.0 ) GO TO 980 FIRST = .FALSE. C C IF STILL SAME NAV BLK, USE SAME M(TH,BETA) C C ROTATE POSITION VECTOR OF S/C FROM SUN CENTERED ECL50 COORDINATES C TO HELIOGRAPHIC COORDINATES. ALTERNATIVE TECHNIQUE TO USE: C C CALL VTRANS(VT,AM5,ANAV(13)) C DO 4 I = 1,3 TMP = 0. DO 3 J = 1,3 TMP = TMP + AM5(J,I) * ANAV(J+12) 3 CONTINUE VT(I) = TMP 4 CONTINUE C C FIND SPHERICAL COORDINATE ANGLES OF S/C IN HELIOGRAPHIC COORDINATES. C ALTERNATIVE TECHNIQUE TO USE: C C CALL VSPHER(VT,TH,BETA) C BETA = ATAN2( VT(2), VT(1)) TH = ATAN2( VT(3), SQRT( VT(1)**2+VT(2)**2)) c range = sqrt( vt(1)**2 + vt(2)**2 + vt(3)**2) C C FIND ROTATION MATRIX FROM HELIOGRAPHIC TO "RTN" COORDINATES. C ALTERNATIVE TECHNIQUE TO USE: C C PHI=BETA+90. C THETA=90.-TH C CALL EULROT(PHI,-THETA,-90.,AMTB) C CBETA = COS(BETA) SBETA = SIN(BETA) CTH = COS( TH) STH = SIN( TH) AMTB(1,1) = CTH * CBETA AMTB(2,1) = CTH * SBETA AMTB(3,1) = STH AMTB(1,2) = -SBETA AMTB(2,2) = CBETA AMTB(3,2) = 0. AMTB(1,3) = -STH * CBETA AMTB(2,3) = -STH * SBETA AMTB(3,3) = CTH C C MAKE NEW AMT = AMTB * AM5. THIS IS BEST ONLY WHEN THERE ARE C MANY CALLS BETWEEN CHANGES OF NAV BLKS. C C FIND ROTATION MATRIX FROM ECL50 TO "RTN" COORDINATES. C ALTERNATIVE TECHNIQUE TO USE: C C CALL TENSOR(AMT,AMTB,AM5) C DO 8 I = 1,3 DO 7 J = 1,3 TMP = 0. DO 6 K = 1,3 TMP = TMP + AMTB(K,I) * AM5(J,K) 6 CONTINUE AMT(J,I) = TMP 7 CONTINUE 8 CONTINUE C C NOW USE M(P,EO) FROM PNT BLK AND S/C VX,VY,VZ FROM NAV BLK TO C TRANSFORM INPUT VECTOR FROM S/C TO SUN CENTERED ECL50 C COORDINATES. C ALTERNATIVE TECHNIQUE TO USE: C C IF ( itype .eq. 2) CALL VTRANS(VT, APNT(12),VI) C IF ( itype .eq. 3) CALL VTRANS(VT, APNT(12),VI,ANAV(16)) C if ( itype .gt. 3) go to 40 10 CONTINUE DO 20 I = 1,3 TMP = 0. DO 15 J = 1,3 TMP = TMP + APNT(I+11+3*(J-1)) * VI(J) 15 CONTINUE IF ( itype .eq. 3 ) TMP = TMP + ANAV( I+15) VT(I) = TMP 20 CONTINUE C C TRANSFORM VT FROM SUN CENTERED ECL50 COORDINATES TO "RTN" COORDINATES. C ALTERNATIVE TECHNIQUE TO USE: C C CALL VTRANS(VO,AMT,VT) C DO 30 I = 1,3 TMP = 0. DO 25 J = 1,3 TMP = TMP + AMT(J,I) * VT(J) 25 CONTINUE VO(I) = TMP 30 CONTINUE GO TO 990 C transforming in reverse direction C TRANSFORM VI TO SUN CENTERED ECL50 COORDINATES FROM "RTN" COORDINATES. C ALTERNATIVE TECHNIQUE TO USE: C C CALL VTRANS(Vt,AMTinv,Vi) C 40 continue DO 130 I = 1,3 TMP = 0. DO 125 J = 1,3 TMP = TMP + AMT(I,J) * VI(J) 125 CONTINUE VT(I) = TMP 130 CONTINUE C C NOW USE M(P,EO) FROM PNT BLK AND S/C VX,VY,VZ FROM NAV BLK TO C TRANSFORM VECTOR TO S/C FROM SUN CENTERED ECL50 C COORDINATES. C ALTERNATIVE TECHNIQUE TO USE: C C 110 CONTINUE IF ( itype .eq. 5 ) TMP = TMP - ANAV( I+15) if ( itype .ne. 5) go to 114 do 112 i=1,3 Vt(i) = Vt(i) - anav( i+15) 112 continue 114 continue DO 120 I = 1,3 TMP = 0. DO 115 J = 1,3 TMP = TMP + APNT(j+11+3*(i-1)) * Vt(J) 115 CONTINUE Vo(I) = TMP 120 CONTINUE GO TO 990 C C ERRORS FROM "SXRED" WHEN READING SEDR TAPE C 980 WRITE ( IERROR, 8001) 8001 FORMAT ( '0ERROR ON FIRST CALL TO PLSEDM, NO TRANSFORMATIONS ' + ,'DONE -- STOP') STOP C C LPLS(28) = .FALSE. ==> NO SEDR TAPE (THIS IS THE DEFAULT VALUE). C INTERCHANGE X AND Z COMPONENTS OF INPUT VECTOR IN THIS CASE. C 985 DO 987 J=1,3 VO(J) = VI(4-J) 987 CONTINUE C C RETURN TO CALLING ROUTINE: C 1) "VGRANL" IF CALL WAS TO "PLSEDM" C 2) "PRANAL" IF CALL WAS TO "SCRTNB" C 3) "PRANAL" IF CALL WAS TO "SCRTNV" C 990 CONTINUE RETURN END