C 06/23/84 09:52:20 06/22/84 14:52:55 $38 c GSG jr. July 8, 1994, changer Q, tranparency according to RLM memo of June 25, 1994 SUBROUTINE DCUR(DN,W,U,A,Z,NCHN,LDIST,DISTF) C C *** MODIFIED TO USE SINGLE PRECISION 5/22/84 JDR *** C C C THIS SUBROUTINE COMPUTES THE SIDE SENSOR RESPONSE OF THE C VOYAGER PLS EXPERIMENT OPERATING IN THE M-MODE TO A PLASMA WHOSE C DISTRIBUTION FUNCTION CAN BE MODELED AS A CONVECTED MAXWELLIAN. C IT USES AN ALGORITHM IN WHICH THE INTEGRATIONS OVER THE COMPONENTS C OF VELOCITY PERPENDICULAR TO THE CUP NORMAL ARE PERFORMED C ANALYTICALLY, WHILE THE INTEGRATION OVER THE COMPONENT OF VELOCITY C ALONG THE CUP NORMAL IS DONE NUMERICALLY. THE ALGORITHM IS C DESCRIBED IN DETAIL IN ALAN BARNETT'S DOCTORAL THESIS. C THE INTEGRATION OVER VZ IS DIVIDED INTO TWO REGIONS WHICH ARE C TREATED SEPARATELY. FOR A CHANNEL K, THE INTEGRATION OVER C VELOCITIES UP TO THE THRESHOLD VELOCITY FOR CHANNEL K+2 IS C EVALUATED BY A DIFFERENT LOOP FROM THE REMAINDER OF THE INTEGRAL. C THE REST OF THE RANGE OF VZ IS CALLED THE TAIL. THE C CONTRIBUTION FOR EACH VALUE OF VZ IS COMPUTED USING A TAYLOR C EXPANSION OF THE CURRENT AS A FUNCTION OF THE RESPONSE FUNCTION C PARAMETERS. THE TAIL IS FURTHER DIVIDED INTO TWO HALVES, THE NEAR C TAIL AND THE FAR TAIL. THE CURRENTS IN THE TAIL AND THE C DERIVATIVES OF THOSE CURRENTS WITH RESPECT TO THE RESPONSE C FUNCTION PARAMETERS ARE COMPUTED BY SUBROUTINE DSTCUR. C C THE INPUT VARIABLES FOR DCUR ARE C DN DENSITY (NUMBER PER CC) C W THERMAL SPEED (KM/SEC) C U(3) BULK VELOCITY IN CUP COORDINATES (KM/SEC) C A MASS OF ION SPECIES (AMU) C Z CHARGE OF ION SPECIES (PROTON CHARGES) C NCHN(2) THE LIMITING CHANNEL NUMBERS TO BE CALCULATED C LDIST LOGICAL FLAG; T-COMPUTE REDUCED DISTRIBUTION FCN C F-COMPUTE CURRENT C THE OUTPUT VARIABLE IS C DISTF(128) THE REDUCED DISTRIBUTION FUNCTION C c REAL*8 $$$DT(6) /'$$DATE$$','06/22/84','14 c | ' DCUR',' FORTRAN','MJ c LOGICAL*1 LDIST LOGICAL LDIST INTEGER*4 NCHN(2),NSTEP(129),NFIRST INTEGER*4 NTAIL(2),MFIRST C C THE INTEGER VARIABLES HAVE THE FOLLOWING MEANING C NSTEP(I) NUMBER OF STEPS IN THE NUMERICAL INTEGRATION C BETWEEN THE THESHOLD VOLTAGES FOR CHANNEL I AND I+1 C NFIRST(I) NUMBER OF THE FIRST ELEMENT OF TVZ INCLUDED C IN THE INTEGRATION OF THE NEAR TAIL FOR CHANNEL I C NTAIL(2) FIRST AND LAST ELEMENT OF VZ TO BE COMPUTED C BY DSTCUR C MFIRST(I) NUMBER OF FIRST ELEMENT OF TVZ INCLUDED IN C THE INTEGRATION OF THE FAR TAIL FOR CHANNEL I C REAL*4 AA,S,CC,DS REAL*4 AAAVZ,AAVZ,AVZ,AAADVZ,AADVZ,ADVZ,DVOLT REAL*4 F(3),D(3) REAL*4 A0,T0,ECHRGE,PI12,W,U(3) REAL*4 PRESET,DISTF(128),CUR1(241,5,2),DN,Z,A,X2,X,UT2 REAL*4 GAMMA,KAPPA,CURENT,UT,G12,G32,KAPPA2,VZ,CRR(129) REAL*4 X0,CONST,DVZ,G,ZZ,SS,Z0,Z1,Z10 C C THE VELOCITY SPACE INTEGRATION IS DONE IN CYLINDRICAL COORDINATES, C WITH THE CUP NORMAL POINTING IN THE Z- DIRECTION. THE C INTEGRATION OVER ANGLE IN THE VX-VY PLANE RESULTS IN THE C BESSEL FUNCTION I0; IN ORDER TO PERFORM THE NEXT INTEGRATION C ANALYTICALLY, IT IS NECESSARY TO APPROXIMATE THE BESSEL C FUNCTION BY A SUM OF EXPONENTIALS. D AND F ARE THE PARAMETERS C IN THIS APPROXIMATION. C C SOME OTHER REAL VARIABLES ARE: C A0 NOMINAL COLLECTING AREA OF DETECTOR C T0 NOMINAL GRID TRANSPARENCY AT NORMAL INCIDENCE C ECHRGE PROTON CHARGE IN COULOMBS C PI12 SQUARE ROOT OF PI C PRESET VALUE FOR MAXWELLIAN CUTOFF FLAG C C1,C2,C3 PARAMETERS FOR TRAPEZOIDAL APPROXIMATION FO C SENSITIVE AREA C COMMON/TRNPRD/AA(100,129,2),CC(100,129,2),S(100,129) COMMON/DSET/DS(241,4,2) COMMON/VZ/AAAVZ(22,5),AAVZ(4,40),AVZ(2,84),AAADVZ(22,5), , AADVZ(4,40),ADVZ(2,84),DVOLT(128),NFIRST(129),MFIRST(129) data F /.6876,.2044,.09153/,D /-.22131,.851562,.990971/ data A0/82.7/,T0/.68007/,ECHRGE/1.6022E-19/,PI12/1.772453851/ data PRESET/428244919/ data CRR /129*0.E0/ data Z0/.12E0/,Z1/1.82E0/,Z10/1.70E0/ data NSTEP /22,16,10,6,41*4,84*2/ C C COMMON BLOCKS TRNPRD, DSET, AND VZ ARE FILLED BY SUBROUTINE C CONRD, WHICH MUST BE CALLED BEFORE THE FIRST CALL TO DCUR. C THE VARIABLES IN THESE COMMON BLOCKS ARE; C AA CONSTANTS C CC WHICH DESCRIBE THE CUP C TRANSPARENCY C S THE SHIFT FUNCTION C THE FIRST INDEX OF THE PRECEDING THREE VARIABLES REFERS TO THE C STEP NUMBER IN THE VZ INTEGRATION. THE SECOND INDEX C REFERS TO THE MODULATOR STEP NUMBER. THE THIRD INDEX OF C AA AND CC DIFFERENTIATE TWO DIFFERENT CONSTANTS. C DS VALUES OF ABOVE USED IN INTEGERATION OF C THE TAIL C AAAVZ VALUES OF VZ FOR INTEGRATION ACROSS C CHANNELS 1-5 C AAVZ VALUES OF VZ FOR INTEGRATION ACROSS C CHANNELS 6-45 C AVZ VALUES OF VZ FOR INTEGRATION ACROSS C CHANNELS 46-129 C AAADVZ WEIGHTS FOR SIMPSON INTEGRATION ACROSS C CHANNELS 1-5 C AADVZ WEIGHTS FOR SIMPSON INTEGRATION ACROSS C CHANNELS 6-45 C ADVZ WEIGHTS FOR SIMPSON INTEGRATION ACROSS C CHANNELS 46-129 C DVOLT VOLTAGE WIDTHS OF THE CHANNELS C C INITIALIZE DISTF, DEFINE CONST C CALL DSTCUR TO COMPUTE CONTRIBUTION DUE TO ION FEEDTHROUGH C (TAIL). DSTCUR IS CALLED TWICE, ONCE FOR THE NEAR TAIL AND C ONCE FOR THE FAR TAIL. THE ACTUAL CONTRIBUTIONS ARE COMPUTED C BELOW USING A TAYLOR EXPANSION IN THE TRANSPARENCY PARAMETERS. C DO 1 I=1,128 1 DISTF(I)=0.D0 UT2=U(1)**2+U(2)**2 UT=SQRT(UT2) CONST=DN*2.*Z*ECHRGE*A0*T0/W**3/PI12*1.E20 NC1=NCHN(1) NC2=NCHN(2) NC3=NCHN(2)+1 NTAIL(1)=NFIRST(NC1) NTAIL(2)=MFIRST(NC2)-1 CALL DSTCUR(W,UT,U(3),A,Z,NTAIL,1,CUR1) NTAIL(1)=MFIRST(NC1) NTAIL(2)=99+NFIRST(NC2)-NSTEP(NC2) CALL DSTCUR(W,UT,U(3),A,Z,NTAIL,2,CUR1) C C INTEGRATE BETWEEN THRESHOLDS OF CONTIGUOUS CHANNELS C DO 2700 NCHAN=NC1,NC3 CURENT=0.E0 NS=NSTEP(NCHAN) DO 2600 JJ=1,NS G=0.E0 C C SELECT VALUE OF VZ,DVZ C IF(NCHAN .GE. 6 .AND. NCHAN .LE. 45)GO TO 10 IF(NCHAN .GE. 46)GO TO 20 VZ=(AAAVZ(JJ,NCHAN))*SQRT(Z/A) DVZ=AAADVZ(JJ,NCHAN)*SQRT(Z/A) GO TO 100 10 VZ=AAVZ(JJ,NCHAN-5)*SQRT(Z/A) DVZ=AADVZ(JJ,NCHAN-5)*SQRT(Z/A) GO TO 100 20 VZ=AVZ(JJ,NCHAN-45)*SQRT(Z/A) DVZ=ADVZ(JJ,NCHAN-45)*SQRT(Z/A) 100 CONTINUE C C CHECK FOR CUTOFF DUE TO MAXWELLIAN DEPENDENCE ON VZ C X0=((VZ-U(3))/W)**2 IF(X0 .GT. 16.0) GO TO 2600 X0=X0+UT2/W**2 C C EVALUATE INTEGRATION OVER VT ANALYTICALLY; C SUM OVER TERMS IN GRID TRANSPARENCY APPROXIMATION C DO 2500 I=1,2 GAMMA=((VZ/W)**2+(AA(JJ,NCHAN,I)))/(S(JJ,NCHAN))**2 G12=SQRT(GAMMA) C C SUM OVER TERMS IN APPROXIMATION TO BESSEL FUNCTION C DO 2500 J=1,3 C C SUM OVER TERMS IN APPROXIMATION TO BESSEL FUNCTION C KAPPA=(D(J)/S(JJ,NCHAN))*VZ*UT/W**2/G12 KAPPA2=KAPPA**2 X=X0-KAPPA2 IF(X .GT. 10)GO TO 2500 G32=G12**3 ZZ=2*G32*Z10 SS=(PI12*(KAPPA2-G12*KAPPA*Z0+.5)*terf(G12*Z0-KAPPA)- - PI12*(KAPPA2-G12*KAPPA*Z1+.5)*terf(G12*Z1-KAPPA))/ZZ+ + PI12*KAPPA*terf(KAPPA)/2.E0/GAMMA X2=(G12*Z0-KAPPA)**2 IF(X2 .LT. 10)SS=SS-KAPPA*EXP(-X2)/ZZ X2=(G12*Z1-KAPPA)**2 IF(X2 .LT. 10)SS=SS+KAPPA*EXP(-X2)/ZZ IF(KAPPA2 .LT. 10)SS=SS+EXP(-KAPPA2)/2.E0/GAMMA C C ADD TO SUM FOR INTEGRAND (MAXWELLIAN FACTOR INCLUDED LATER) C G=G+SS*(F(J)*CC(JJ,NCHAN,I))*EXP(-X) 2500 CONTINUE C C ADD TO SUM FOR SIMPSON INTEGRATION OVER VZ C CURENT=CURENT+G*(VZ/(S(JJ,NCHAN)))**2*DVZ*VZ 2600 CONTINUE CRR(NCHAN)=CURENT 2700 CONTINUE DO 3000 NCHAN=NC1,NC2 C C TAKE DIFFERENCE BETWEEN CONTRIBUTIONS FROM CONTIGUOUS CHANNELS. C FIRST STEP: INTEGRATION ACCROSS CHANNEL WIDTH C DISTF(NCHAN)=CRR(NCHAN)-CRR(NCHAN+1) NF=NFIRST(NCHAN) IF(NCHAN .LE. 4)GO TO 2750 NF1=NFIRST(NCHAN+1)-1 N=NSTEP(NCHAN)+1 DO 2725 I=NF,NF1 IF(CUR1(I,1,1) .EQ. PRESET) GO TO 3000 IF(CUR1(I,1,1) .EQ. 0.E0) GO TO 2725 C C CALCULATE FEEDTHROUGH CONTRIBUTION BY TAYLOR SERIES IN RESPONSE C FUNCTION PARAMETERS; CHANNEL K+1 C DISTF(NCHAN)=DISTF(NCHAN)+CUR1(I,1,1)+ + CUR1(I,2,1)*(S(N,NCHAN)-DS(I,1,1))+ + CUR1(I,3,1)*(AA(N,NCHAN,1)-DS(I,2,1))+ + CUR1(I,4,1)*(AA(N,NCHAN,2)-DS(I,3,1))+ + CUR1(I,5,1)*(CC(N,NCHAN,1)-DS(I,4,1)) N=N+1 2725 CONTINUE N1=N N2=NSTEP(NCHAN+1)+1 GO TO 2775 2750 CONTINUE I=1 N1=NSTEP(NCHAN)+1 N2=NSTEP(NCHAN+1)+1 2775 CONTINUE DO 2900 LL=N1,100 M=1 IF(I .GE. MFIRST(NCHAN))M=2 IF(CUR1(I,1,M) .EQ. 0.E0)GO TO 2900 IF(CUR1(I,1,M) .EQ. PRESET)GO TO 3000 C C CALCULATE CONTRIBUTION FROM REST OF TAIL C DISTF(NCHAN)=DISTF(NCHAN)+ + CUR1(I,2,M)*(S(LL,NCHAN)-S(N2,NCHAN+1))+ + CUR1(I,3,M)*(AA(LL,NCHAN,1)-AA(N2,NCHAN+1,1))+ + CUR1(I,4,M)*(AA(LL,NCHAN,2)-AA(N2,NCHAN+1,2))+ + CUR1(I,5,M)*(CC(LL,NCHAN,1)-CC(N2,NCHAN+1,1)) I=I+1 N2=N2+1 2900 CONTINUE 3000 CONTINUE 5000 CONTINUE C C IF FLAG LDIST=TRUE, DIVIDE CURRENT BY CHANNEL WIDTH. C DO 5001 NCHAN=1,128 IF(LDIST)DISTF(NCHAN)=DISTF(NCHAN)*CONST/(DVOLT(NCHAN)) IF(.NOT. LDIST)DISTF(NCHAN)=DISTF(NCHAN)*CONST 5001 CONTINUE RETURN END SUBROUTINE DSTCUR(W,UT,UZ,A,Z,NTAIL,M,CUR1) C C THIS PROGRAM COMPUTES THE CURRENTS IN THE TAIL AND THE DERIVATIVES C OF THOSE CURRENTS WITH RESPECT TO THE PARAMETERS C WHICH DESCRIBE THE RESPONSE FUNCTION C THE INPUT VARIABLES ARE C W THERMAL SPEED (KM/SEC) C UT COMPONENT OF BULK VELOCITY PERPENDICULAR C TO CUP NORMAL (KM/SEC) C UZ COMPONENT OF BULK VELOCITY ALONG CUP C NORMAL (KM/SEC) C A MASS OF IONS (AMU) C Z CHARGE OF IONS (PROTON CHARGES) C NTAIL(2) NUMBER OF THE FIRST AND LAST ELEMENTS OF C TVZ TO BE EVALUATED C M 1-NEAR TAIL, 2-FAR TAIL; C DETERMINES VALUE OF THIRD INDEX OF DS C THE OUTPUT VARIABLE IS C CUR1(I,J,K) CURRENTS AND THEIR DERIVATIVES C I REFERS TO INDEX OF TVZ C J=1 CURRENT C J=2 DERIVATIVE WRT S C J=3 DERIVATIVE WRT A1 C J=4 DERIVATIVE WRT A2 C J=5 DERIVATIVE WRT C C INTEGER NTAIL(2),M REAL*4 DS,TVZ,TDVZ REAL*4 F(3),D(3) REAL*4 A,Z,W,X0,X,G,G1,GD,ZZ,Z0,Z1,Z10 REAL*4 UZ,SS,PRESET,CUR1(241,5,2),DVZ REAL*4 PI12,DCUR(4) REAL*4 GAMMA,KAPPA,UT,G12,G32,KAPPA2,VZ,X2,AA(2),CC(2),S COMMON/DSET/DS(241,4,2) COMMON/TAIL/TVZ(241),TDVZ(241) data F/.6876,.2044,.09153/,D/-.22131,.851562,.990971/ data Z0/.12E0/,Z1/1.82E0/,Z10/1.7E0/ data PRESET/428244919/ data PI12/1.772453851E0/,DCUR/0.E0,.05E0,.001E0,.01E0/ C C COMMON BLOCKS TAIL AND DSET ARE FILLED BY SUBROUTINE CONRD C THE VARIABLES CONTAINED THEREIN ARE C DS RESPONSE FUNCTION CONSTANTS C TVZ VALUES OF VZ FOR EVALUATION C TDVZ WEIGHTS FOR NUMERICAL INTEGRATION C NT1=NTAIL(1) NT2=NTAIL(2) DO 3700 JJ=NT1,NT2 C C CHOOSE VZ AND DVZ C VZ=(TVZ(JJ))*SQRT(Z/A) DVZ=(TDVZ(JJ))*SQRT(Z/A) X0=(VZ-UZ)/W IF (X0 .LT. -4.E0) GO TO 3690 IF (X0 .GT. 4.E0) GO TO 3800 X0=X0**2+(UT/W)**2 C C EVALUATE THE INTEGRALS OVER VX AND VY AND THEIR DERIVATIVES C WITH RESPECT TO THE PARAMETERS OF THE RESPONSE FUNCTION C DO 3600 KK=1,4 C C ASSIGN PROPER VALUES TO RESPONSE PARAMETERS C G=0.E0 S=(DS(JJ,1,M)) AA(1)=(DS(JJ,2,M)) AA(2)=(DS(JJ,3,M)) CC(1)=(DS(JJ,4,M)) C C CHANGE VALUE OF EACH PARAMETER IN TURN TO EVALUATE THE DERIVATIVES C IF(KK .EQ. 2)S=S+DCUR(2) IF(KK .EQ. 3)AA(1)=AA(1)+DCUR(3) IF(KK .EQ. 4)AA(2)=AA(2)+DCUR(4) CC(2)=1.0E0-CC(1) C C SUM OVER TERMS IN GRID TRANSPARENCY APPROXIMATION C DO 3400 I=1,2 GAMMA=((VZ/W)**2+AA(I))/S**2 G12=SQRT(GAMMA) G1=0.E0 C C SUM OVER TERMS IN APPROXIMATION TO BESSEL FUNCTION C DO 3300 J=1,3 KAPPA=(D(J))/S*VZ*UT/W**2/G12 KAPPA2=KAPPA**2 X=X0-KAPPA2 IF(X .GT. 10)GO TO 3300 G32=G12**3 ZZ=2*G32*Z10 SS=(PI12*(KAPPA2-G12*KAPPA*Z0+.5)*terf(G12*Z0-KAPPA)- - PI12*(KAPPA2-G12*KAPPA*Z1+.5)*terf(G12*Z1-KAPPA))/ZZ+ + PI12*KAPPA*terf(KAPPA)/2.D0/GAMMA X2=(G12*Z0-KAPPA)**2 IF(X2 .LT. 10)SS=SS-KAPPA*EXP(-X2)/ZZ X2=(G12*Z1-KAPPA)**2 IF(X2 .LT. 10)SS=SS+KAPPA*EXP(-X2)/ZZ IF(KAPPA2 .LT. 10)SS=SS+EXP(-KAPPA2)/2.E0/GAMMA C C ADD LATEST TERM TO INTEGRAND (EXCEPT MAXWELLIAN FACTOR AND CC) C G1=G1+SS*(F(J))*EXP(-X) 3300 CONTINUE G=G+G1*CC(I) C C COMPUTE DERIVATIVE WITH RESPECT TO C ANALYTICALLY C IF (KK .NE. 1) GO TO 3400 IF (I .EQ. 1)GD=G1 IF (I .EQ. 2)GD=GD-G1 3400 CONTINUE 3500 CONTINUE C C COMPUTE DERIVATIVES WRT SFT,A1,A2 NUMERICALLY C CUR1(JJ,KK,M)=G*(VZ/S)**2*VZ*DVZ IF(KK .NE. 1)CUR1(JJ,KK,M)= = ((CUR1(JJ,KK,M)-CUR1(JJ,1,M))/DCUR(KK)) 3550 CONTINUE CUR1(JJ,5,M)=GD*(VZ/S)**2*VZ*DVZ 3600 CONTINUE GO TO 3700 3690 CONTINUE CUR1(JJ,1,M)=0.D0 3700 CONTINUE RETURN 3800 CONTINUE DO 3850 L=JJ,241 CUR1(L,1,M)=PRESET 3850 CONTINUE RETURN END