Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/geometry/magneticfield/src/G4MagIntegratorDriver.cc

Version: [ ReleaseNotes ] [ 1.0 ] [ 1.1 ] [ 2.0 ] [ 3.0 ] [ 3.1 ] [ 3.2 ] [ 4.0 ] [ 4.0.p1 ] [ 4.0.p2 ] [ 4.1 ] [ 4.1.p1 ] [ 5.0 ] [ 5.0.p1 ] [ 5.1 ] [ 5.1.p1 ] [ 5.2 ] [ 5.2.p1 ] [ 5.2.p2 ] [ 6.0 ] [ 6.0.p1 ] [ 6.1 ] [ 6.2 ] [ 6.2.p1 ] [ 6.2.p2 ] [ 7.0 ] [ 7.0.p1 ] [ 7.1 ] [ 7.1.p1 ] [ 8.0 ] [ 8.0.p1 ] [ 8.1 ] [ 8.1.p1 ] [ 8.1.p2 ] [ 8.2 ] [ 8.2.p1 ] [ 8.3 ] [ 8.3.p1 ] [ 8.3.p2 ] [ 9.0 ] [ 9.0.p1 ] [ 9.0.p2 ] [ 9.1 ] [ 9.1.p1 ] [ 9.1.p2 ] [ 9.1.p3 ] [ 9.2 ] [ 9.2.p1 ] [ 9.2.p2 ] [ 9.2.p3 ] [ 9.2.p4 ] [ 9.3 ] [ 9.3.p1 ] [ 9.3.p2 ] [ 9.4 ] [ 9.4.p1 ] [ 9.4.p2 ] [ 9.4.p3 ] [ 9.4.p4 ] [ 9.5 ] [ 9.5.p1 ] [ 9.5.p2 ] [ 9.6 ] [ 9.6.p1 ] [ 9.6.p2 ] [ 9.6.p3 ] [ 9.6.p4 ] [ 10.0 ] [ 10.0.p1 ] [ 10.0.p2 ] [ 10.0.p3 ] [ 10.0.p4 ] [ 10.1 ] [ 10.1.p1 ] [ 10.1.p2 ] [ 10.1.p3 ] [ 10.2 ] [ 10.2.p1 ] [ 10.2.p2 ] [ 10.2.p3 ] [ 10.3 ] [ 10.3.p1 ] [ 10.3.p2 ] [ 10.3.p3 ] [ 10.4 ] [ 10.4.p1 ] [ 10.4.p2 ] [ 10.4.p3 ] [ 10.5 ] [ 10.5.p1 ] [ 10.6 ] [ 10.6.p1 ] [ 10.6.p2 ] [ 10.6.p3 ] [ 10.7 ] [ 10.7.p1 ] [ 10.7.p2 ] [ 10.7.p3 ] [ 10.7.p4 ] [ 11.0 ] [ 11.0.p1 ] [ 11.0.p2 ] [ 11.0.p3, ] [ 11.0.p4 ] [ 11.1 ] [ 11.1.1 ] [ 11.1.2 ] [ 11.1.3 ] [ 11.2 ] [ 11.2.1 ] [ 11.2.2 ] [ 11.3.0 ]

Diff markup

Differences between /geometry/magneticfield/src/G4MagIntegratorDriver.cc (Version 11.3.0) and /geometry/magneticfield/src/G4MagIntegratorDriver.cc (Version 11.1.1)


  1 //                                                  1 //
  2 // *******************************************      2 // ********************************************************************
  3 // * License and Disclaimer                         3 // * License and Disclaimer                                           *
  4 // *                                                4 // *                                                                  *
  5 // * The  Geant4 software  is  copyright of th      5 // * The  Geant4 software  is  copyright of the Copyright Holders  of *
  6 // * the Geant4 Collaboration.  It is provided      6 // * the Geant4 Collaboration.  It is provided  under  the terms  and *
  7 // * conditions of the Geant4 Software License      7 // * conditions of the Geant4 Software License,  included in the file *
  8 // * LICENSE and available at  http://cern.ch/      8 // * LICENSE and available at  http://cern.ch/geant4/license .  These *
  9 // * include a list of copyright holders.           9 // * include a list of copyright holders.                             *
 10 // *                                               10 // *                                                                  *
 11 // * Neither the authors of this software syst     11 // * Neither the authors of this software system, nor their employing *
 12 // * institutes,nor the agencies providing fin     12 // * institutes,nor the agencies providing financial support for this *
 13 // * work  make  any representation or  warran     13 // * work  make  any representation or  warranty, express or implied, *
 14 // * regarding  this  software system or assum     14 // * regarding  this  software system or assume any liability for its *
 15 // * use.  Please see the license in the file      15 // * use.  Please see the license in the file  LICENSE  and URL above *
 16 // * for the full disclaimer and the limitatio     16 // * for the full disclaimer and the limitation of liability.         *
 17 // *                                               17 // *                                                                  *
 18 // * This  code  implementation is the result      18 // * This  code  implementation is the result of  the  scientific and *
 19 // * technical work of the GEANT4 collaboratio     19 // * technical work of the GEANT4 collaboration.                      *
 20 // * By using,  copying,  modifying or  distri     20 // * By using,  copying,  modifying or  distributing the software (or *
 21 // * any work based  on the software)  you  ag     21 // * any work based  on the software)  you  agree  to acknowledge its *
 22 // * use  in  resulting  scientific  publicati     22 // * use  in  resulting  scientific  publications,  and indicate your *
 23 // * acceptance of all terms of the Geant4 Sof     23 // * acceptance of all terms of the Geant4 Software license.          *
 24 // *******************************************     24 // ********************************************************************
 25 //                                                 25 //
 26 // G4MagInt_Driver implementation                  26 // G4MagInt_Driver implementation
 27 //                                                 27 //
 28 // V.Grichine, 07.10.1996 - Created                28 // V.Grichine, 07.10.1996 - Created
 29 // W.Wander, 28.01.1998 - Added ability for lo     29 // W.Wander, 28.01.1998 - Added ability for low order integrators
 30 // J.Apostolakis, 08.11.2001 - Respect minimum     30 // J.Apostolakis, 08.11.2001 - Respect minimum step in AccurateAdvance
 31 // -------------------------------------------     31 // --------------------------------------------------------------------
 32                                                    32 
 33 #include <iomanip>                                 33 #include <iomanip>
 34                                                    34 
 35 #include "globals.hh"                              35 #include "globals.hh"
 36 #include "G4SystemOfUnits.hh"                      36 #include "G4SystemOfUnits.hh"
 37 #include "G4GeometryTolerance.hh"                  37 #include "G4GeometryTolerance.hh"
 38 #include "G4MagIntegratorDriver.hh"                38 #include "G4MagIntegratorDriver.hh"
 39 #include "G4FieldTrack.hh"                         39 #include "G4FieldTrack.hh"
 40                                                    40 
 41 #ifdef   G4DEBUG_FIELD                             41 #ifdef   G4DEBUG_FIELD
 42 #include "G4DriverReporter.hh"                     42 #include "G4DriverReporter.hh"
 43 #endif                                             43 #endif
 44                                                    44 
 45 // -------------------------------------------     45 // ---------------------------------------------------------
 46                                                    46 
 47 //  Constructor                                    47 //  Constructor
 48 //                                                 48 //
 49 G4MagInt_Driver::G4MagInt_Driver( G4double         49 G4MagInt_Driver::G4MagInt_Driver( G4double                hminimum, 
 50                                   G4MagIntegra     50                                   G4MagIntegratorStepper* pStepper,
 51                                   G4int            51                                   G4int                   numComponents,
 52                                   G4int            52                                   G4int                   statisticsVerbose)
 53   : fNoIntegrationVariables(numComponents),        53   : fNoIntegrationVariables(numComponents), 
 54     fNoVars( std::max( fNoIntegrationVariables     54     fNoVars( std::max( fNoIntegrationVariables, fMinNoVars )),
 55     fStatisticsVerboseLevel(statisticsVerbose)     55     fStatisticsVerboseLevel(statisticsVerbose)
 56 {                                                  56 {  
 57   // In order to accomodate "Laboratory Time",     57   // In order to accomodate "Laboratory Time", which is [7], fMinNoVars=8
 58   // is required. For proper time of flight an     58   // is required. For proper time of flight and spin,  fMinNoVars must be 12
 59                                                    59 
 60   RenewStepperAndAdjust( pStepper );               60   RenewStepperAndAdjust( pStepper );
 61   fMinimumStep = hminimum;                         61   fMinimumStep = hminimum;
 62                                                    62 
 63   fMaxNoSteps = fMaxStepBase / pIntStepper->In     63   fMaxNoSteps = fMaxStepBase / pIntStepper->IntegratorOrder();
 64 #ifdef G4DEBUG_FIELD                               64 #ifdef G4DEBUG_FIELD
 65   fVerboseLevel=2;                                 65   fVerboseLevel=2;
 66 #endif                                             66 #endif
 67                                                    67 
 68   if( (fVerboseLevel > 0) || (fStatisticsVerbo     68   if( (fVerboseLevel > 0) || (fStatisticsVerboseLevel > 1) )
 69   {                                                69   {
 70     G4cout << "MagIntDriver version: Accur-Adv     70     G4cout << "MagIntDriver version: Accur-Adv: "
 71            << "invE_nS, QuickAdv-2sqrt with St     71            << "invE_nS, QuickAdv-2sqrt with Statistics "
 72 #ifdef G4FLD_STATS                                 72 #ifdef G4FLD_STATS
 73            << " enabled "                          73            << " enabled "
 74 #else                                              74 #else
 75            << " disabled "                         75            << " disabled "
 76 #endif                                             76 #endif
 77            << G4endl;                              77            << G4endl;
 78   }                                                78   }
 79 }                                                  79 }
 80                                                    80 
 81 // -------------------------------------------     81 // ---------------------------------------------------------
 82                                                    82 
 83 //  Destructor                                     83 //  Destructor
 84 //                                                 84 //
 85 G4MagInt_Driver::~G4MagInt_Driver()                85 G4MagInt_Driver::~G4MagInt_Driver()
 86 {                                                  86 { 
 87   if( fStatisticsVerboseLevel > 1 )                87   if( fStatisticsVerboseLevel > 1 )
 88   {                                                88   {
 89     PrintStatisticsReport();                       89     PrintStatisticsReport();
 90   }                                                90   }
 91 }                                                  91 }
 92                                                    92 
 93 // -------------------------------------------     93 // ---------------------------------------------------------
 94                                                    94 
 95 G4bool                                             95 G4bool
 96 G4MagInt_Driver::AccurateAdvance(G4FieldTrack&     96 G4MagInt_Driver::AccurateAdvance(G4FieldTrack& y_current,
 97                                  G4double          97                                  G4double      hstep,
 98                                  G4double          98                                  G4double      eps,
 99                                  G4double          99                                  G4double      hinitial )
100 {                                                 100 {
101   // Runge-Kutta driver with adaptive stepsize    101   // Runge-Kutta driver with adaptive stepsize control. Integrate starting
102   // values at y_current over hstep x2 with ac    102   // values at y_current over hstep x2 with accuracy eps. 
103   // On output ystart is replaced by values at    103   // On output ystart is replaced by values at the end of the integration 
104   // interval. RightHandSide is the right-hand    104   // interval. RightHandSide is the right-hand side of ODE system. 
105   // The source is similar to odeint routine f    105   // The source is similar to odeint routine from NRC p.721-722 .
106                                                   106 
107   G4int nstp, i;                                  107   G4int nstp, i;
108   G4double x, hnext, hdid, h;                     108   G4double x, hnext, hdid, h;
109                                                   109 
110 #ifdef G4DEBUG_FIELD                              110 #ifdef G4DEBUG_FIELD
111   G4int no_warnings = 0;                          111   G4int no_warnings = 0;
112   static G4int dbg = 1;                           112   static G4int dbg = 1;
113   static G4int nStpPr = 50;   // For debug pri    113   static G4int nStpPr = 50;   // For debug printing of long integrations
114   G4double ySubStepStart[G4FieldTrack::ncompSV    114   G4double ySubStepStart[G4FieldTrack::ncompSVEC];
115   G4FieldTrack  yFldTrkStart(y_current);          115   G4FieldTrack  yFldTrkStart(y_current);
116 #endif                                            116 #endif
117                                                   117 
118   G4double y[G4FieldTrack::ncompSVEC] = {0., 0 << 118   G4double y[G4FieldTrack::ncompSVEC], dydx[G4FieldTrack::ncompSVEC];
119   G4double dydx[G4FieldTrack::ncompSVEC] = {0. << 119   G4double ystart[G4FieldTrack::ncompSVEC], yEnd[G4FieldTrack::ncompSVEC]; 
120   G4double ystart[G4FieldTrack::ncompSVEC] = { << 
121   G4double yEnd[G4FieldTrack::ncompSVEC] = {0. << 
122   G4double  x1, x2;                               120   G4double  x1, x2;
123   G4bool succeeded = true;                        121   G4bool succeeded = true;
124                                                   122 
125   G4double startCurveLength;                      123   G4double startCurveLength;
126                                                   124 
127   const G4int nvar = fNoVars;                     125   const G4int nvar = fNoVars;
128                                                   126 
129   G4FieldTrack yStartFT(y_current);               127   G4FieldTrack yStartFT(y_current);
130                                                   128 
131   //  Ensure that hstep > 0                       129   //  Ensure that hstep > 0
132   //                                              130   //
133   if( hstep <= 0.0 )                              131   if( hstep <= 0.0 )
134   {                                               132   { 
135     if( hstep == 0.0 )                            133     if( hstep == 0.0 )
136     {                                             134     {
137       std::ostringstream message;                 135       std::ostringstream message;
138       message << "Proposed step is zero; hstep    136       message << "Proposed step is zero; hstep = " << hstep << " !";
139       G4Exception("G4MagInt_Driver::AccurateAd    137       G4Exception("G4MagInt_Driver::AccurateAdvance()", 
140                   "GeomField1001", JustWarning    138                   "GeomField1001", JustWarning, message);
141       return succeeded;                           139       return succeeded; 
142     }                                             140     }
143                                                << 141     else
144     std::ostringstream message;                << 142     { 
145     message << "Invalid run condition." << G4e << 143       std::ostringstream message;
146             << "Proposed step is negative; hst << 144       message << "Invalid run condition." << G4endl
147             << "Requested step cannot be negat << 145               << "Proposed step is negative; hstep = " << hstep << "." << G4endl
148     G4Exception("G4MagInt_Driver::AccurateAdva << 146               << "Requested step cannot be negative! Aborting event.";
149                 "GeomField0003", EventMustBeAb << 147       G4Exception("G4MagInt_Driver::AccurateAdvance()", 
150     return false;                              << 148                   "GeomField0003", EventMustBeAborted, message);
                                                   >> 149       return false;
                                                   >> 150     }
151   }                                               151   }
152                                                   152 
153   y_current.DumpToArray( ystart );                153   y_current.DumpToArray( ystart );
154                                                   154 
155   startCurveLength= y_current.GetCurveLength()    155   startCurveLength= y_current.GetCurveLength();
156   x1= startCurveLength;                           156   x1= startCurveLength; 
157   x2= x1 + hstep;                                 157   x2= x1 + hstep;
158                                                   158 
159   if ( (hinitial > 0.0) && (hinitial < hstep)     159   if ( (hinitial > 0.0) && (hinitial < hstep)
160     && (hinitial > perMillion * hstep) )          160     && (hinitial > perMillion * hstep) )
161   {                                               161   {
162      h = hinitial;                                162      h = hinitial;
163   }                                               163   }
164   else  //  Initial Step size "h" defaults to     164   else  //  Initial Step size "h" defaults to the full interval
165   {                                               165   {
166      h = hstep;                                   166      h = hstep;
167   }                                               167   }
168                                                   168 
169   x = x1;                                         169   x = x1;
170                                                   170 
171   for ( i=0; i<nvar; ++i)  { y[i] = ystart[i];    171   for ( i=0; i<nvar; ++i)  { y[i] = ystart[i]; }
172                                                   172 
173   G4bool lastStep= false;                         173   G4bool lastStep= false;
174   nstp = 1;                                       174   nstp = 1;
175                                                   175 
176   do                                              176   do
177   {                                               177   {
178     G4ThreeVector StartPos( y[0], y[1], y[2] )    178     G4ThreeVector StartPos( y[0], y[1], y[2] );
179                                                   179 
180 #ifdef G4DEBUG_FIELD                              180 #ifdef G4DEBUG_FIELD
181     G4double xSubStepStart= x;                    181     G4double xSubStepStart= x; 
182     for (i=0; i<nvar; ++i)  { ySubStepStart[i]    182     for (i=0; i<nvar; ++i)  { ySubStepStart[i] = y[i]; }
183     yFldTrkStart.LoadFromArray(y, fNoIntegrati    183     yFldTrkStart.LoadFromArray(y, fNoIntegrationVariables);
184     yFldTrkStart.SetCurveLength(x);               184     yFldTrkStart.SetCurveLength(x);
185 #endif                                            185 #endif
186                                                   186 
187     pIntStepper->RightHandSide( y, dydx );        187     pIntStepper->RightHandSide( y, dydx );
188     ++fNoTotalSteps;                              188     ++fNoTotalSteps;
189                                                   189 
190     // Perform the Integration                    190     // Perform the Integration
191     //                                            191     //      
192     if( h > fMinimumStep )                        192     if( h > fMinimumStep )
193     {                                             193     { 
194       OneGoodStep(y,dydx,x,h,eps,hdid,hnext) ;    194       OneGoodStep(y,dydx,x,h,eps,hdid,hnext) ;
195       //--------------------------------------    195       //--------------------------------------
196 #ifdef G4DEBUG_FIELD                              196 #ifdef G4DEBUG_FIELD
197       if (dbg>2)                                  197       if (dbg>2)
198       {                                           198       {
199          // PrintStatus( ySubStepStart, xSubSt    199          // PrintStatus( ySubStepStart, xSubStepStart, y, x, h,  nstp); // Only
200         G4DriverReporter::PrintStatus( ySubSte    200         G4DriverReporter::PrintStatus( ySubStepStart, xSubStepStart, y, x, h,  nstp, nvar);
201       }                                           201       }
202 #endif                                            202 #endif
203     }                                             203     }
204     else                                          204     else
205     {                                             205     {
206       G4FieldTrack yFldTrk( G4ThreeVector(0,0,    206       G4FieldTrack yFldTrk( G4ThreeVector(0,0,0), 
207                             G4ThreeVector(0,0,    207                             G4ThreeVector(0,0,0), 0., 0., 0., 0. );
208       G4double dchord_step, dyerr, dyerr_len;     208       G4double dchord_step, dyerr, dyerr_len;   // What to do with these ?
209       yFldTrk.LoadFromArray(y, fNoIntegrationV    209       yFldTrk.LoadFromArray(y, fNoIntegrationVariables); 
210       yFldTrk.SetCurveLength( x );                210       yFldTrk.SetCurveLength( x );
211                                                   211 
212       QuickAdvance( yFldTrk, dydx, h, dchord_s    212       QuickAdvance( yFldTrk, dydx, h, dchord_step, dyerr_len );
213       //--------------------------------------    213       //-----------------------------------------------------
214                                                   214 
215       yFldTrk.DumpToArray(y);                     215       yFldTrk.DumpToArray(y);    
216                                                   216 
217 #ifdef G4FLD_STATS                                217 #ifdef G4FLD_STATS
218       ++fNoSmallSteps;                            218       ++fNoSmallSteps; 
219       if ( dyerr_len > fDyerr_max )  { fDyerr_    219       if ( dyerr_len > fDyerr_max )  { fDyerr_max = dyerr_len; }
220       fDyerrPos_smTot += dyerr_len;               220       fDyerrPos_smTot += dyerr_len;
221       fSumH_sm += h;  // Length total for 'sma    221       fSumH_sm += h;  // Length total for 'small' steps
222       if (nstp==1)  { ++fNoInitialSmallSteps;     222       if (nstp==1)  { ++fNoInitialSmallSteps; }
223 #endif                                            223 #endif
224 #ifdef G4DEBUG_FIELD                              224 #ifdef G4DEBUG_FIELD
225       if (dbg>1)                                  225       if (dbg>1)
226       {                                           226       {
227         if(fNoSmallSteps<2) { PrintStatus(ySub    227         if(fNoSmallSteps<2) { PrintStatus(ySubStepStart, x1, y, x, h, -nstp); }
228         G4cout << "Another sub-min step, no "     228         G4cout << "Another sub-min step, no " << fNoSmallSteps 
229                << " of " << fNoTotalSteps << "    229                << " of " << fNoTotalSteps << " this time " << nstp << G4endl; 
230         PrintStatus( ySubStepStart, x1, y, x,     230         PrintStatus( ySubStepStart, x1, y, x, h,  nstp);   // Only this
231         G4cout << " dyerr= " << dyerr_len << "    231         G4cout << " dyerr= " << dyerr_len << " relative = " << dyerr_len / h 
232                << " epsilon= " << eps << " hst    232                << " epsilon= " << eps << " hstep= " << hstep 
233                << " h= " << h << " hmin= " <<     233                << " h= " << h << " hmin= " << fMinimumStep << G4endl;
234       }                                           234       }
235 #endif                                            235 #endif        
236       if( h == 0.0 )                              236       if( h == 0.0 )
237       {                                           237       { 
238         G4Exception("G4MagInt_Driver::Accurate    238         G4Exception("G4MagInt_Driver::AccurateAdvance()",
239                     "GeomField0003", FatalExce    239                     "GeomField0003", FatalException,
240                     "Integration Step became Z    240                     "Integration Step became Zero!"); 
241       }                                           241       }
242       dyerr = dyerr_len / h;                      242       dyerr = dyerr_len / h;
243       hdid = h;                                   243       hdid = h;
244       x += hdid;                                  244       x += hdid;
245                                                   245 
246       // Compute suggested new step               246       // Compute suggested new step
247       hnext = ComputeNewStepSize( dyerr/eps, h    247       hnext = ComputeNewStepSize( dyerr/eps, h);
248     }                                             248     }
249                                                   249 
250     G4ThreeVector EndPos( y[0], y[1], y[2] );     250     G4ThreeVector EndPos( y[0], y[1], y[2] );
251                                                   251 
252 #ifdef  G4DEBUG_FIELD                             252 #ifdef  G4DEBUG_FIELD
253     if( (dbg>0) && (dbg<=2) && (nstp>nStpPr))     253     if( (dbg>0) && (dbg<=2) && (nstp>nStpPr))
254     {                                             254     {
255       if( nstp==nStpPr )  { G4cout << "***** M    255       if( nstp==nStpPr )  { G4cout << "***** Many steps ****" << G4endl; }
256       G4cout << "MagIntDrv: " ;                   256       G4cout << "MagIntDrv: " ; 
257       G4cout << "hdid="  << std::setw(12) << h    257       G4cout << "hdid="  << std::setw(12) << hdid  << " "
258              << "hnext=" << std::setw(12) << h    258              << "hnext=" << std::setw(12) << hnext << " " 
259              << "hstep=" << std::setw(12) << h    259              << "hstep=" << std::setw(12) << hstep << " (requested) " 
260              << G4endl;                           260              << G4endl;
261       PrintStatus( ystart, x1, y, x, h, (nstp=    261       PrintStatus( ystart, x1, y, x, h, (nstp==nStpPr) ? -nstp: nstp); 
262     }                                             262     }
263 #endif                                            263 #endif
264                                                   264 
265     // Check the endpoint                         265     // Check the endpoint
266     G4double endPointDist= (EndPos-StartPos).m    266     G4double endPointDist= (EndPos-StartPos).mag(); 
267     if ( endPointDist >= hdid*(1.+perMillion)     267     if ( endPointDist >= hdid*(1.+perMillion) )
268     {                                             268     {
269       ++fNoBadSteps;                              269       ++fNoBadSteps;
270                                                   270 
271       // Issue a warning only for gross differ    271       // Issue a warning only for gross differences -
272       // we understand how small difference oc    272       // we understand how small difference occur.
273       if ( endPointDist >= hdid*(1.+perThousan    273       if ( endPointDist >= hdid*(1.+perThousand) )
274       {                                           274       { 
275 #ifdef G4DEBUG_FIELD                              275 #ifdef G4DEBUG_FIELD
276         if (dbg)                                  276         if (dbg)
277         {                                         277         {
278           WarnEndPointTooFar ( endPointDist, h    278           WarnEndPointTooFar ( endPointDist, hdid, eps, dbg ); 
279           G4cerr << "  Total steps:  bad " <<     279           G4cerr << "  Total steps:  bad " << fNoBadSteps
280                  << " current h= " << hdid <<     280                  << " current h= " << hdid << G4endl;
281           PrintStatus( ystart, x1, y, x, hstep    281           PrintStatus( ystart, x1, y, x, hstep, no_warnings?nstp:-nstp);  
282         }                                         282         }
283         ++no_warnings;                            283         ++no_warnings;
284 #endif                                            284 #endif
285       }                                           285       }
286     }                                             286     }
287                                                   287 
288     //  Avoid numerous small last steps           288     //  Avoid numerous small last steps
289     if( (h < eps * hstep) || (h < fSmallestFra    289     if( (h < eps * hstep) || (h < fSmallestFraction * startCurveLength) )
290     {                                             290     {
291       // No more integration -- the next step     291       // No more integration -- the next step will not happen
292       lastStep = true;                            292       lastStep = true;  
293     }                                             293     }
294     else                                          294     else
295     {                                             295     {
296       // Check the proposed next stepsize         296       // Check the proposed next stepsize
297       if(std::fabs(hnext) <= Hmin())              297       if(std::fabs(hnext) <= Hmin())
298       {                                           298       {
299 #ifdef  G4DEBUG_FIELD                             299 #ifdef  G4DEBUG_FIELD
300         // If simply a very small interval is     300         // If simply a very small interval is being integrated, do not warn
301         if( (x < x2 * (1-eps) ) &&        // T    301         if( (x < x2 * (1-eps) ) &&        // The last step can be small: OK
302             (std::fabs(hstep) > Hmin()) ) // a    302             (std::fabs(hstep) > Hmin()) ) // and if we are asked, it's OK
303         {                                         303         {
304           if(dbg>0)                               304           if(dbg>0)
305           {                                       305           {
306             WarnSmallStepSize( hnext, hstep, h    306             WarnSmallStepSize( hnext, hstep, h, x-x1, nstp );  
307             PrintStatus( ystart, x1, y, x, hst    307             PrintStatus( ystart, x1, y, x, hstep, no_warnings?nstp:-nstp);
308           }                                       308           }
309           ++no_warnings;                          309           ++no_warnings;
310         }                                         310         }
311 #endif                                            311 #endif
312         // Make sure that the next step is at     312         // Make sure that the next step is at least Hmin.
313         h = Hmin();                               313         h = Hmin();
314       }                                           314       }
315       else                                        315       else
316       {                                           316       {
317         h = hnext;                                317         h = hnext;
318       }                                           318       }
319                                                   319 
320       //  Ensure that the next step does not o    320       //  Ensure that the next step does not overshoot
321       if ( x+h > x2 )                             321       if ( x+h > x2 )
322       {                // When stepsize oversh    322       {                // When stepsize overshoots, decrease it!
323         h = x2 - x ;   // Must cope with diffi    323         h = x2 - x ;   // Must cope with difficult rounding-error
324       }                // issues if hstep << x    324       }                // issues if hstep << x2
325                                                   325 
326       if ( h == 0.0 )                             326       if ( h == 0.0 )
327       {                                           327       {
328         // Cannot progress - accept this as la    328         // Cannot progress - accept this as last step - by default
329         lastStep = true;                          329         lastStep = true;
330 #ifdef G4DEBUG_FIELD                              330 #ifdef G4DEBUG_FIELD
331         if (dbg>2)                                331         if (dbg>2)
332         {                                         332         {
333           int prec= G4cout.precision(12);         333           int prec= G4cout.precision(12); 
334           G4cout << "Warning: G4MagIntegratorD    334           G4cout << "Warning: G4MagIntegratorDriver::AccurateAdvance"
335                  << G4endl                        335                  << G4endl
336                  << "  Integration step 'h' be    336                  << "  Integration step 'h' became "
337                  << h << " due to roundoff. "     337                  << h << " due to roundoff. " << G4endl
338                  << " Calculated as difference    338                  << " Calculated as difference of x2= "<< x2 << " and x=" << x
339                  << "  Forcing termination of     339                  << "  Forcing termination of advance." << G4endl;
340           G4cout.precision(prec);                 340           G4cout.precision(prec);
341         }                                         341         }          
342 #endif                                            342 #endif
343       }                                           343       }
344     }                                             344     }
345   } while ( ((++nstp)<=fMaxNoSteps) && (x < x2    345   } while ( ((++nstp)<=fMaxNoSteps) && (x < x2) && (!lastStep) );
346   // Loop checking, 07.10.2016, J. Apostolakis    346   // Loop checking, 07.10.2016, J. Apostolakis
347                                                   347 
348      // Have we reached the end ?                 348      // Have we reached the end ?
349      // --> a better test might be x-x2 > an_e    349      // --> a better test might be x-x2 > an_epsilon
350                                                   350 
351   succeeded = (x>=x2);  // If it was a "forced    351   succeeded = (x>=x2);  // If it was a "forced" last step
352                                                   352 
353   for (i=0; i<nvar; ++i)  { yEnd[i] = y[i]; }     353   for (i=0; i<nvar; ++i)  { yEnd[i] = y[i]; }
354                                                   354 
355   // Put back the values.                         355   // Put back the values.
356   y_current.LoadFromArray( yEnd, fNoIntegratio    356   y_current.LoadFromArray( yEnd, fNoIntegrationVariables );
357   y_current.SetCurveLength( x );                  357   y_current.SetCurveLength( x );
358                                                   358 
359   if(nstp > fMaxNoSteps)                          359   if(nstp > fMaxNoSteps)
360   {                                               360   {
361     succeeded = false;                            361     succeeded = false;
362 #ifdef G4DEBUG_FIELD                              362 #ifdef G4DEBUG_FIELD
363     ++no_warnings;                                363     ++no_warnings;
364     if (dbg)                                      364     if (dbg)
365     {                                             365     {
366       WarnTooManyStep( x1, x2, x );  //  Issue    366       WarnTooManyStep( x1, x2, x );  //  Issue WARNING
367       PrintStatus( yEnd, x1, y, x, hstep, -nst    367       PrintStatus( yEnd, x1, y, x, hstep, -nstp);
368     }                                             368     }
369 #endif                                            369 #endif
370   }                                               370   }
371                                                   371 
372 #ifdef G4DEBUG_FIELD                              372 #ifdef G4DEBUG_FIELD
373   if( dbg && no_warnings )                        373   if( dbg && no_warnings )
374   {                                               374   {
375     G4cerr << "G4MagIntegratorDriver exit stat    375     G4cerr << "G4MagIntegratorDriver exit status: no-steps " << nstp << G4endl;
376     PrintStatus( yEnd, x1, y, x, hstep, nstp);    376     PrintStatus( yEnd, x1, y, x, hstep, nstp);
377   }                                               377   }
378 #endif                                            378 #endif
379                                                   379 
380   return succeeded;                               380   return succeeded;
381 }  // end of AccurateAdvance .................    381 }  // end of AccurateAdvance ...........................
382                                                   382 
383 // -------------------------------------------    383 // ---------------------------------------------------------
384                                                   384 
385 void                                              385 void
386 G4MagInt_Driver::WarnSmallStepSize( G4double h    386 G4MagInt_Driver::WarnSmallStepSize( G4double hnext, G4double hstep, 
387                                     G4double h    387                                     G4double h, G4double xDone,
388                                     G4int nstp    388                                     G4int nstp)
389 {                                                 389 {
390   static G4ThreadLocal G4int noWarningsIssued     390   static G4ThreadLocal G4int noWarningsIssued = 0;
391   const  G4int maxNoWarnings = 10;   // Number    391   const  G4int maxNoWarnings = 10;   // Number of verbose warnings
392   std::ostringstream message;                     392   std::ostringstream message;
393   if( (noWarningsIssued < maxNoWarnings) || fV    393   if( (noWarningsIssued < maxNoWarnings) || fVerboseLevel > 10 )
394   {                                               394   {
395     message << "The stepsize for the next iter    395     message << "The stepsize for the next iteration, " << hnext
396             << ", is too small - in Step numbe    396             << ", is too small - in Step number " << nstp << "." << G4endl
397             << "The minimum for the driver is     397             << "The minimum for the driver is " << Hmin()  << G4endl
398             << "Requested integr. length was "    398             << "Requested integr. length was " << hstep << " ." << G4endl
399             << "The size of this sub-step was     399             << "The size of this sub-step was " << h     << " ." << G4endl
400             << "The integrations has already g    400             << "The integrations has already gone " << xDone;
401   }                                               401   }
402   else                                            402   else
403   {                                               403   {
404     message << "Too small 'next' step " << hne    404     message << "Too small 'next' step " << hnext
405             << ", step-no: " << nstp << G4endl    405             << ", step-no: " << nstp << G4endl
406             << ", this sub-step: " << h           406             << ", this sub-step: " << h     
407             << ",  req_tot_len: " << hstep        407             << ",  req_tot_len: " << hstep 
408             << ", done: " << xDone << ", min:     408             << ", done: " << xDone << ", min: " << Hmin();
409   }                                               409   }
410   G4Exception("G4MagInt_Driver::WarnSmallStepS    410   G4Exception("G4MagInt_Driver::WarnSmallStepSize()", "GeomField1001",
411               JustWarning, message);              411               JustWarning, message);
412   ++noWarningsIssued;                             412   ++noWarningsIssued;
413 }                                                 413 }
414                                                   414 
415 // -------------------------------------------    415 // ---------------------------------------------------------
416                                                   416 
417 void                                              417 void
418 G4MagInt_Driver::WarnTooManyStep( G4double x1s    418 G4MagInt_Driver::WarnTooManyStep( G4double x1start, 
419                                   G4double x2e    419                                   G4double x2end, 
420                                   G4double xCu    420                                   G4double xCurrent )
421 {                                                 421 {
422    std::ostringstream message;                    422    std::ostringstream message;
423    message << "The number of steps used in the    423    message << "The number of steps used in the Integration driver"
424            << " (Runge-Kutta) is too many." <<    424            << " (Runge-Kutta) is too many." << G4endl
425            << "Integration of the interval was    425            << "Integration of the interval was not completed !" << G4endl
426            << "Only a " << (xCurrent-x1start)*    426            << "Only a " << (xCurrent-x1start)*100/(x2end-x1start)
427            << " % fraction of it was done.";      427            << " % fraction of it was done.";
428    G4Exception("G4MagInt_Driver::WarnTooManySt    428    G4Exception("G4MagInt_Driver::WarnTooManyStep()", "GeomField1001",
429                JustWarning, message);             429                JustWarning, message);
430 }                                                 430 }
431                                                   431 
432 // -------------------------------------------    432 // ---------------------------------------------------------
433                                                   433 
434 void                                              434 void
435 G4MagInt_Driver::WarnEndPointTooFar (G4double     435 G4MagInt_Driver::WarnEndPointTooFar (G4double endPointDist, 
436                                      G4double     436                                      G4double h , 
437                                      G4double     437                                      G4double eps,
438                                      G4int        438                                      G4int    dbg)
439 {                                                 439 {
440   static G4ThreadLocal G4double maxRelError =     440   static G4ThreadLocal G4double maxRelError = 0.0;
441   G4bool isNewMax, prNewMax;                      441   G4bool isNewMax, prNewMax;
442                                                   442 
443   isNewMax = endPointDist > (1.0 + maxRelError    443   isNewMax = endPointDist > (1.0 + maxRelError) * h;
444   prNewMax = endPointDist > (1.0 + 1.05 * maxR    444   prNewMax = endPointDist > (1.0 + 1.05 * maxRelError) * h;
445   if( isNewMax ) { maxRelError= endPointDist /    445   if( isNewMax ) { maxRelError= endPointDist / h - 1.0; }
446                                                   446 
447   if( (dbg != 0) && (h > G4GeometryTolerance:: << 447   if( dbg && (h > G4GeometryTolerance::GetInstance()->GetSurfaceTolerance()) 
448           && ( (dbg>1) || prNewMax || (endPoin    448           && ( (dbg>1) || prNewMax || (endPointDist >= h*(1.+eps) ) ) )
449   {                                               449   { 
450     static G4ThreadLocal G4int noWarnings = 0;    450     static G4ThreadLocal G4int noWarnings = 0;
451     std::ostringstream message;                   451     std::ostringstream message;
452     if( (noWarnings++ < 10) || (dbg>2) )          452     if( (noWarnings++ < 10) || (dbg>2) )
453     {                                             453     {
454       message << "The integration produced an     454       message << "The integration produced an end-point which " << G4endl
455               << "is further from the start-po    455               << "is further from the start-point than the curve length."
456               << G4endl;                          456               << G4endl;
457     }                                             457     }
458     message << "  Distance of endpoints = " <<    458     message << "  Distance of endpoints = " << endPointDist
459             << ", curve length = " << h << G4e    459             << ", curve length = " << h << G4endl
460             << "  Difference (curveLen-endpDis    460             << "  Difference (curveLen-endpDist)= " << (h - endPointDist)
461             << ", relative = " << (h-endPointD    461             << ", relative = " << (h-endPointDist) / h 
462             << ", epsilon =  " << eps;            462             << ", epsilon =  " << eps;
463     G4Exception("G4MagInt_Driver::WarnEndPoint    463     G4Exception("G4MagInt_Driver::WarnEndPointTooFar()", "GeomField1001",
464                 JustWarning, message);            464                 JustWarning, message);
465   }                                               465   }
466 }                                                 466 }
467                                                   467 
468 // -------------------------------------------    468 // ---------------------------------------------------------
469                                                   469 
470 void                                              470 void
471 G4MagInt_Driver::OneGoodStep(      G4double y[    471 G4MagInt_Driver::OneGoodStep(      G4double y[],        // InOut
472                              const G4double dy    472                              const G4double dydx[],
473                                    G4double& x    473                                    G4double& x,         // InOut
474                                    G4double ht    474                                    G4double htry,
475                                    G4double ep    475                                    G4double eps_rel_max,
476                                    G4double& h    476                                    G4double& hdid,      // Out
477                                    G4double& h    477                                    G4double& hnext )    // Out
478                                                   478 
479 // Driver for one Runge-Kutta Step with monito    479 // Driver for one Runge-Kutta Step with monitoring of local truncation error
480 // to ensure accuracy and adjust stepsize. Inp    480 // to ensure accuracy and adjust stepsize. Input are dependent variable
481 // array y[0,...,5] and its derivative dydx[0,    481 // array y[0,...,5] and its derivative dydx[0,...,5] at the
482 // starting value of the independent variable     482 // starting value of the independent variable x . Also input are stepsize
483 // to be attempted htry, and the required accu    483 // to be attempted htry, and the required accuracy eps. On output y and x
484 // are replaced by their new values, hdid is t    484 // are replaced by their new values, hdid is the stepsize that was actually
485 // accomplished, and hnext is the estimated ne    485 // accomplished, and hnext is the estimated next stepsize. 
486 // This is similar to the function rkqs from t    486 // This is similar to the function rkqs from the book:
487 // Numerical Recipes in C: The Art of Scientif    487 // Numerical Recipes in C: The Art of Scientific Computing (NRC), Second
488 // Edition, by William H. Press, Saul A. Teuko    488 // Edition, by William H. Press, Saul A. Teukolsky, William T.
489 // Vetterling, and Brian P. Flannery (Cambridg    489 // Vetterling, and Brian P. Flannery (Cambridge University Press 1992),
490 // 16.2 Adaptive StepSize Control for Runge-Ku    490 // 16.2 Adaptive StepSize Control for Runge-Kutta, p. 719
491                                                   491 
492 {                                                 492 {
493   G4double errmax_sq;                             493   G4double errmax_sq;
494   G4double h, htemp, xnew ;                       494   G4double h, htemp, xnew ;
495                                                   495 
496   G4double yerr[G4FieldTrack::ncompSVEC], ytem    496   G4double yerr[G4FieldTrack::ncompSVEC], ytemp[G4FieldTrack::ncompSVEC];
497                                                   497 
498   h = htry ; // Set stepsize to the initial tr    498   h = htry ; // Set stepsize to the initial trial value
499                                                   499 
500   G4double inv_eps_vel_sq = 1.0 / (eps_rel_max    500   G4double inv_eps_vel_sq = 1.0 / (eps_rel_max*eps_rel_max);
501                                                   501 
502   G4double errpos_sq = 0.0;    // square of di    502   G4double errpos_sq = 0.0;    // square of displacement error
503   G4double errvel_sq = 0.0;    // square of mo    503   G4double errvel_sq = 0.0;    // square of momentum vector difference
504   G4double errspin_sq = 0.0;   // square of sp    504   G4double errspin_sq = 0.0;   // square of spin vector difference
505                                                   505 
506   const G4int max_trials=100;                     506   const G4int max_trials=100; 
507                                                   507 
508   G4ThreeVector Spin(y[9],y[10],y[11]);           508   G4ThreeVector Spin(y[9],y[10],y[11]);
509   G4double spin_mag2 = Spin.mag2();               509   G4double spin_mag2 = Spin.mag2();
510   G4bool hasSpin = (spin_mag2 > 0.0);             510   G4bool hasSpin = (spin_mag2 > 0.0); 
511                                                   511 
512   for (G4int iter=0; iter<max_trials; ++iter)     512   for (G4int iter=0; iter<max_trials; ++iter)
513   {                                               513   {
514     pIntStepper-> Stepper(y,dydx,h,ytemp,yerr)    514     pIntStepper-> Stepper(y,dydx,h,ytemp,yerr); 
515     //            *******                         515     //            *******
516     G4double eps_pos = eps_rel_max * std::max(    516     G4double eps_pos = eps_rel_max * std::max(h, fMinimumStep); 
517     G4double inv_eps_pos_sq = 1.0 / (eps_pos*e    517     G4double inv_eps_pos_sq = 1.0 / (eps_pos*eps_pos); 
518                                                   518 
519     // Evaluate accuracy                          519     // Evaluate accuracy
520     //                                            520     //
521     errpos_sq =  sqr(yerr[0]) + sqr(yerr[1]) +    521     errpos_sq =  sqr(yerr[0]) + sqr(yerr[1]) + sqr(yerr[2]) ;
522     errpos_sq *= inv_eps_pos_sq; // Scale rela    522     errpos_sq *= inv_eps_pos_sq; // Scale relative to required tolerance
523                                                   523 
524     // Accuracy for momentum                      524     // Accuracy for momentum
525     G4double magvel_sq=  sqr(y[3]) + sqr(y[4])    525     G4double magvel_sq=  sqr(y[3]) + sqr(y[4]) + sqr(y[5]) ;
526     G4double sumerr_sq =  sqr(yerr[3]) + sqr(y    526     G4double sumerr_sq =  sqr(yerr[3]) + sqr(yerr[4]) + sqr(yerr[5]) ; 
527     if( magvel_sq > 0.0 )                         527     if( magvel_sq > 0.0 )
528     {                                             528     { 
529        errvel_sq = sumerr_sq / magvel_sq;         529        errvel_sq = sumerr_sq / magvel_sq; 
530     }                                             530     }
531     else                                          531     else
532     {                                             532     {
533        std::ostringstream message;                533        std::ostringstream message;
534        message << "Found case of zero momentum    534        message << "Found case of zero momentum." << G4endl
535                << "- iteration= " << iter << "    535                << "- iteration= " << iter << "; h= " << h;
536        G4Exception("G4MagInt_Driver::OneGoodSt    536        G4Exception("G4MagInt_Driver::OneGoodStep()",
537                    "GeomField1001", JustWarnin    537                    "GeomField1001", JustWarning, message);
538        errvel_sq = sumerr_sq;                     538        errvel_sq = sumerr_sq; 
539     }                                             539     }
540     errvel_sq *= inv_eps_vel_sq;                  540     errvel_sq *= inv_eps_vel_sq;
541     errmax_sq = std::max( errpos_sq, errvel_sq    541     errmax_sq = std::max( errpos_sq, errvel_sq ); // Square of maximum error
542                                                   542 
543     if( hasSpin )                                 543     if( hasSpin )
544     {                                             544     { 
545       // Accuracy for spin                        545       // Accuracy for spin
546       errspin_sq =  ( sqr(yerr[9]) + sqr(yerr[    546       errspin_sq =  ( sqr(yerr[9]) + sqr(yerr[10]) + sqr(yerr[11]) )
547                     /  spin_mag2; // ( sqr(y[9    547                     /  spin_mag2; // ( sqr(y[9]) + sqr(y[10]) + sqr(y[11]) );
548       errspin_sq *= inv_eps_vel_sq;               548       errspin_sq *= inv_eps_vel_sq;
549       errmax_sq = std::max( errmax_sq, errspin    549       errmax_sq = std::max( errmax_sq, errspin_sq ); 
550     }                                             550     }
551                                                   551 
552     if ( errmax_sq <= 1.0 )  { break; } // Ste    552     if ( errmax_sq <= 1.0 )  { break; } // Step succeeded. 
553                                                   553 
554     // Step failed; compute the size of retria    554     // Step failed; compute the size of retrial Step.
555     htemp = GetSafety() * h * std::pow( errmax    555     htemp = GetSafety() * h * std::pow( errmax_sq, 0.5*GetPshrnk() );
556                                                   556 
557     if (htemp >= 0.1*h)  { h = htemp; }  // Tr    557     if (htemp >= 0.1*h)  { h = htemp; }  // Truncation error too large,
558     else  { h = 0.1*h; }                 // re    558     else  { h = 0.1*h; }                 // reduce stepsize, but no more
559                                          // th    559                                          // than a factor of 10
560     xnew = x + h;                                 560     xnew = x + h;
561     if(xnew == x)                                 561     if(xnew == x)
562     {                                             562     {
563       std::ostringstream message;                 563       std::ostringstream message;
564       message << "Stepsize underflow in Steppe    564       message << "Stepsize underflow in Stepper !" << G4endl
565               << "- Step's start x=" << x << "    565               << "- Step's start x=" << x << " and end x= " << xnew 
566               << " are equal !! " << G4endl       566               << " are equal !! " << G4endl
567               << "  Due to step-size= " << h      567               << "  Due to step-size= " << h 
568               << ". Note that input step was "    568               << ". Note that input step was " << htry;
569       G4Exception("G4MagInt_Driver::OneGoodSte    569       G4Exception("G4MagInt_Driver::OneGoodStep()",
570                   "GeomField1001", JustWarning    570                   "GeomField1001", JustWarning, message);
571       break;                                      571       break;
572     }                                             572     }
573   }                                               573   }
574                                                   574 
575   // Compute size of next Step                    575   // Compute size of next Step
576   if (errmax_sq > errcon*errcon)                  576   if (errmax_sq > errcon*errcon)
577   {                                               577   { 
578     hnext = GetSafety()*h*std::pow(errmax_sq,     578     hnext = GetSafety()*h*std::pow(errmax_sq, 0.5*GetPgrow());
579   }                                               579   }
580   else                                            580   else
581   {                                               581   {
582     hnext = max_stepping_increase*h ; // No mo    582     hnext = max_stepping_increase*h ; // No more than a factor of 5 increase
583   }                                               583   }
584   x += (hdid = h);                                584   x += (hdid = h);
585                                                   585 
586   for(G4int k=0; k<fNoIntegrationVariables; ++    586   for(G4int k=0; k<fNoIntegrationVariables; ++k) { y[k] = ytemp[k]; }
587                                                   587 
588   return;                                         588   return;
589 }                                                 589 }
590                                                   590 
591 //--------------------------------------------    591 //----------------------------------------------------------------------
592                                                   592 
593 // QuickAdvance just tries one Step - it does     593 // QuickAdvance just tries one Step - it does not ensure accuracy
594 //                                                594 //
595 G4bool G4MagInt_Driver::QuickAdvance(G4FieldTr    595 G4bool G4MagInt_Driver::QuickAdvance(G4FieldTrack& y_posvel,    // INOUT
596                                const G4double     596                                const G4double      dydx[],  
597                                      G4double     597                                      G4double      hstep,       // In
598                                      G4double&    598                                      G4double&     dchord_step,
599                                      G4double&    599                                      G4double&     dyerr_pos_sq,
600                                      G4double&    600                                      G4double&     dyerr_mom_rel_sq )  
601 {                                                 601 {
602   G4Exception("G4MagInt_Driver::QuickAdvance()    602   G4Exception("G4MagInt_Driver::QuickAdvance()", "GeomField0001",
603               FatalException, "Not yet impleme    603               FatalException, "Not yet implemented."); 
604                                                   604 
605   // Use the parameters of this method, to ple    605   // Use the parameters of this method, to please compiler
606   //                                              606   //
607   dchord_step = dyerr_pos_sq = hstep * hstep *    607   dchord_step = dyerr_pos_sq = hstep * hstep * dydx[0]; 
608   dyerr_mom_rel_sq = y_posvel.GetPosition().ma    608   dyerr_mom_rel_sq = y_posvel.GetPosition().mag2();
609   return true;                                    609   return true;
610 }                                                 610 }
611                                                   611 
612 //--------------------------------------------    612 //----------------------------------------------------------------------
613                                                   613 
614 G4bool G4MagInt_Driver::QuickAdvance(G4FieldTr    614 G4bool G4MagInt_Driver::QuickAdvance(G4FieldTrack& y_posvel,    // INOUT
615                                const G4double     615                                const G4double      dydx[],  
616                                      G4double     616                                      G4double      hstep,       // In
617                                      G4double&    617                                      G4double&     dchord_step,
618                                      G4double&    618                                      G4double&     dyerr )
619 {                                                 619 {
620   G4double dyerr_pos_sq, dyerr_mom_rel_sq;        620   G4double dyerr_pos_sq, dyerr_mom_rel_sq;  
621   G4double yerr_vec[G4FieldTrack::ncompSVEC],     621   G4double yerr_vec[G4FieldTrack::ncompSVEC],
622            yarrin[G4FieldTrack::ncompSVEC], ya    622            yarrin[G4FieldTrack::ncompSVEC], yarrout[G4FieldTrack::ncompSVEC]; 
623   G4double s_start;                               623   G4double s_start;
624   G4double dyerr_mom_sq, vel_mag_sq, inv_vel_m    624   G4double dyerr_mom_sq, vel_mag_sq, inv_vel_mag_sq;
625                                                   625 
626   // Move data into array                         626   // Move data into array
627   y_posvel.DumpToArray( yarrin );      //  yar    627   y_posvel.DumpToArray( yarrin );      //  yarrin  <== y_posvel 
628   s_start = y_posvel.GetCurveLength();            628   s_start = y_posvel.GetCurveLength();
629                                                   629 
630   // Do an Integration Step                       630   // Do an Integration Step
631   pIntStepper-> Stepper(yarrin, dydx, hstep, y    631   pIntStepper-> Stepper(yarrin, dydx, hstep, yarrout, yerr_vec) ; 
632                                                   632 
633   // Estimate curve-chord distance                633   // Estimate curve-chord distance
634   dchord_step= pIntStepper-> DistChord();         634   dchord_step= pIntStepper-> DistChord();
635                                                   635 
636   // Put back the values.  yarrout ==> y_posve    636   // Put back the values.  yarrout ==> y_posvel
637   y_posvel.LoadFromArray( yarrout, fNoIntegrat    637   y_posvel.LoadFromArray( yarrout, fNoIntegrationVariables );
638   y_posvel.SetCurveLength( s_start + hstep );     638   y_posvel.SetCurveLength( s_start + hstep );
639                                                   639 
640 #ifdef  G4DEBUG_FIELD                             640 #ifdef  G4DEBUG_FIELD
641   if(fVerboseLevel>2)                             641   if(fVerboseLevel>2)
642   {                                               642   {
643     G4cout << "G4MagIntDrv: Quick Advance" <<     643     G4cout << "G4MagIntDrv: Quick Advance" << G4endl;
644     PrintStatus( yarrin, s_start, yarrout, s_s    644     PrintStatus( yarrin, s_start, yarrout, s_start+hstep, hstep,  1); 
645   }                                               645   }
646 #endif                                            646 #endif
647                                                   647 
648   // A single measure of the error                648   // A single measure of the error   
649   //      TO-DO :  account for  energy,  spin,    649   //      TO-DO :  account for  energy,  spin, ... ? 
650   vel_mag_sq   = ( sqr(yarrout[3])+sqr(yarrout    650   vel_mag_sq   = ( sqr(yarrout[3])+sqr(yarrout[4])+sqr(yarrout[5]) );
651   inv_vel_mag_sq = 1.0 / vel_mag_sq;              651   inv_vel_mag_sq = 1.0 / vel_mag_sq; 
652   dyerr_pos_sq = ( sqr(yerr_vec[0])+sqr(yerr_v    652   dyerr_pos_sq = ( sqr(yerr_vec[0])+sqr(yerr_vec[1])+sqr(yerr_vec[2]));
653   dyerr_mom_sq = ( sqr(yerr_vec[3])+sqr(yerr_v    653   dyerr_mom_sq = ( sqr(yerr_vec[3])+sqr(yerr_vec[4])+sqr(yerr_vec[5]));
654   dyerr_mom_rel_sq = dyerr_mom_sq * inv_vel_ma    654   dyerr_mom_rel_sq = dyerr_mom_sq * inv_vel_mag_sq;
655                                                   655 
656   // Calculate also the change in the momentum    656   // Calculate also the change in the momentum squared also ???
657   // G4double veloc_square = y_posvel.GetVeloc    657   // G4double veloc_square = y_posvel.GetVelocity().mag2();
658   // ...                                          658   // ...
659                                                   659 
660 #ifdef RETURN_A_NEW_STEP_LENGTH                   660 #ifdef RETURN_A_NEW_STEP_LENGTH
661   // The following step cannot be done here be    661   // The following step cannot be done here because "eps" is not known.
662   dyerr_len = std::sqrt( dyerr_len_sq );          662   dyerr_len = std::sqrt( dyerr_len_sq ); 
663   dyerr_len_sq /= eps ;                           663   dyerr_len_sq /= eps ;
664                                                   664 
665   // Look at the velocity deviation ?             665   // Look at the velocity deviation ?
666   //  sqr(yerr_vec[3])+sqr(yerr_vec[4])+sqr(ye    666   //  sqr(yerr_vec[3])+sqr(yerr_vec[4])+sqr(yerr_vec[5]));
667                                                   667 
668   // Set suggested new step                       668   // Set suggested new step
669   hstep = ComputeNewStepSize( dyerr_len, hstep    669   hstep = ComputeNewStepSize( dyerr_len, hstep);
670 #endif                                            670 #endif
671                                                   671 
672   if( dyerr_pos_sq > ( dyerr_mom_rel_sq * sqr(    672   if( dyerr_pos_sq > ( dyerr_mom_rel_sq * sqr(hstep) ) )
673   {                                               673   {
674     dyerr = std::sqrt(dyerr_pos_sq);              674     dyerr = std::sqrt(dyerr_pos_sq);
675   }                                               675   }
676   else                                            676   else
677   {                                               677   {
678     // Scale it to the current step size - for    678     // Scale it to the current step size - for now
679     dyerr = std::sqrt(dyerr_mom_rel_sq) * hste    679     dyerr = std::sqrt(dyerr_mom_rel_sq) * hstep;
680   }                                               680   }
681                                                   681 
682   return true;                                    682   return true;
683 }                                                 683 }
684                                                   684 
685 // -------------------------------------------    685 // --------------------------------------------------------------------------
686                                                   686 
687 #ifdef QUICK_ADV_ARRAY_IN_AND_OUT                 687 #ifdef QUICK_ADV_ARRAY_IN_AND_OUT
688 G4bool  G4MagInt_Driver::QuickAdvance(G4double    688 G4bool  G4MagInt_Driver::QuickAdvance(G4double  yarrin[],    // In
689                                 const G4double    689                                 const G4double  dydx[],  
690                                       G4double    690                                       G4double  hstep,       // In
691                                       G4double    691                                       G4double  yarrout[],
692                                       G4double    692                                       G4double& dchord_step,
693                                       G4double    693                                       G4double& dyerr )      // In length
694 {                                                 694 {
695   G4Exception("G4MagInt_Driver::QuickAdvance()    695   G4Exception("G4MagInt_Driver::QuickAdvance()", "GeomField0001",
696               FatalException, "Not yet impleme    696               FatalException, "Not yet implemented.");
697   dyerr = dchord_step = hstep * yarrin[0] * dy    697   dyerr = dchord_step = hstep * yarrin[0] * dydx[0];
698   yarrout[0]= yarrin[0];                          698   yarrout[0]= yarrin[0];
699 }                                                 699 }
700 #endif                                            700 #endif 
701                                                   701 
702 // -------------------------------------------    702 // --------------------------------------------------------------------------
703                                                   703 
704 // This method computes new step sizes - but d    704 // This method computes new step sizes - but does not limit changes to
705 // within  certain factors                        705 // within  certain factors
706 //                                                706 // 
707 G4double G4MagInt_Driver::                        707 G4double G4MagInt_Driver::
708 ComputeNewStepSize_WithoutReductionLimit(G4dou    708 ComputeNewStepSize_WithoutReductionLimit(G4double  errMaxNorm,    // max error  (normalised)
709                    G4double  hstepCurrent)  //    709                    G4double  hstepCurrent)  // current step size
710 {                                                 710 {
711   G4double hnew;                                  711   G4double hnew;
712                                                   712 
713   // Compute size of next Step for a failed st    713   // Compute size of next Step for a failed step
714   if(errMaxNorm > 1.0 )                           714   if(errMaxNorm > 1.0 )
715   {                                               715   {
716     // Step failed; compute the size of retria    716     // Step failed; compute the size of retrial Step.
717     hnew = GetSafety()*hstepCurrent*std::pow(e    717     hnew = GetSafety()*hstepCurrent*std::pow(errMaxNorm,GetPshrnk()) ;
718   }                                               718   }
719   else if(errMaxNorm > 0.0 )                      719   else if(errMaxNorm > 0.0 )
720   {                                               720   {
721     // Compute size of next Step for a success    721     // Compute size of next Step for a successful step
722     hnew = GetSafety()*hstepCurrent*std::pow(e    722     hnew = GetSafety()*hstepCurrent*std::pow(errMaxNorm,GetPgrow()) ;
723   }                                               723   }
724   else                                            724   else
725   {                                               725   {
726     // if error estimate is zero (possible) or    726     // if error estimate is zero (possible) or negative (dubious)
727     hnew = max_stepping_increase * hstepCurren    727     hnew = max_stepping_increase * hstepCurrent; 
728   }                                               728   }
729                                                   729 
730   return hnew;                                    730   return hnew;
731 }                                                 731 }
732                                                   732 
733 // -------------------------------------------    733 // ---------------------------------------------------------------------------
734                                                   734 
735 G4double                                          735 G4double 
736 G4MagInt_Driver::ComputeNewStepSize(              736 G4MagInt_Driver::ComputeNewStepSize(
737                           G4double  errMaxNorm    737                           G4double  errMaxNorm,    // max error  (normalised)
738                           G4double  hstepCurre    738                           G4double  hstepCurrent)  // current step size
739 {                                                 739 {
740    // Legacy behaviour:                           740    // Legacy behaviour:
741    return ComputeNewStepSize_WithoutReductionL    741    return ComputeNewStepSize_WithoutReductionLimit( errMaxNorm, hstepCurrent );
742    // 'Improved' behaviour - at least more con    742    // 'Improved' behaviour - at least more consistent with other step estimates:
743    // return ComputeNewStepSize_WithinLimits(     743    // return ComputeNewStepSize_WithinLimits( errMaxNorm, hstepCurrent );
744 }                                                 744 }
745                                                   745 
746 // This method computes new step sizes limitin    746 // This method computes new step sizes limiting changes within certain factors
747 //                                                747 // 
748 // It shares its logic with AccurateAdvance.      748 // It shares its logic with AccurateAdvance.
749 // They are kept separate currently for optimi    749 // They are kept separate currently for optimisation.
750 //                                                750 //
751 G4double                                          751 G4double 
752 G4MagInt_Driver::ComputeNewStepSize_WithinLimi    752 G4MagInt_Driver::ComputeNewStepSize_WithinLimits( 
753                           G4double  errMaxNorm    753                           G4double  errMaxNorm,    // max error  (normalised)
754                           G4double  hstepCurre    754                           G4double  hstepCurrent)  // current step size
755 {                                                 755 {
756   G4double hnew;                                  756   G4double hnew;
757                                                   757 
758   // Compute size of next Step for a failed st    758   // Compute size of next Step for a failed step
759   if (errMaxNorm > 1.0 )                          759   if (errMaxNorm > 1.0 )
760   {                                               760   {
761     // Step failed; compute the size of retria    761     // Step failed; compute the size of retrial Step.
762     hnew = GetSafety()*hstepCurrent*std::pow(e    762     hnew = GetSafety()*hstepCurrent*std::pow(errMaxNorm,GetPshrnk()) ;
763                                                   763   
764     if (hnew < max_stepping_decrease*hstepCurr    764     if (hnew < max_stepping_decrease*hstepCurrent)
765     {                                             765     {
766       hnew = max_stepping_decrease*hstepCurren    766       hnew = max_stepping_decrease*hstepCurrent ;
767                          // reduce stepsize, b    767                          // reduce stepsize, but no more
768                          // than this factor (    768                          // than this factor (value= 1/10)
769     }                                             769     }
770   }                                               770   }
771   else                                            771   else
772   {                                               772   {
773     // Compute size of next Step for a success    773     // Compute size of next Step for a successful step
774     if (errMaxNorm > errcon)                      774     if (errMaxNorm > errcon)
775      { hnew = GetSafety()*hstepCurrent*std::po    775      { hnew = GetSafety()*hstepCurrent*std::pow(errMaxNorm,GetPgrow()); }
776     else  // No more than a factor of 5 increa    776     else  // No more than a factor of 5 increase
777      { hnew = max_stepping_increase * hstepCur    777      { hnew = max_stepping_increase * hstepCurrent; }
778   }                                               778   }
779   return hnew;                                    779   return hnew;
780 }                                                 780 }
781                                                   781 
782 // -------------------------------------------    782 // ---------------------------------------------------------------------------
783                                                   783 
784 void G4MagInt_Driver::PrintStatus( const G4dou    784 void G4MagInt_Driver::PrintStatus( const G4double* StartArr,  
785                                          G4dou    785                                          G4double  xstart,
786                                    const G4dou    786                                    const G4double* CurrentArr, 
787                                          G4dou    787                                          G4double  xcurrent,
788                                          G4dou    788                                          G4double  requestStep, 
789                                          G4int    789                                          G4int     subStepNo )
790   // Potentially add as arguments:                790   // Potentially add as arguments:  
791   //                                 <dydx>       791   //                                 <dydx>           - as Initial Force
792   //                                 stepTaken    792   //                                 stepTaken(hdid)  - last step taken
793   //                                 nextStep     793   //                                 nextStep (hnext) - proposal for size
794 {                                                 794 {
795    G4FieldTrack  StartFT(G4ThreeVector(0,0,0),    795    G4FieldTrack  StartFT(G4ThreeVector(0,0,0),
796                  G4ThreeVector(0,0,0), 0., 0.,    796                  G4ThreeVector(0,0,0), 0., 0., 0., 0. );
797    G4FieldTrack  CurrentFT (StartFT);             797    G4FieldTrack  CurrentFT (StartFT);
798                                                   798 
799    StartFT.LoadFromArray( StartArr, fNoIntegra    799    StartFT.LoadFromArray( StartArr, fNoIntegrationVariables); 
800    StartFT.SetCurveLength( xstart);               800    StartFT.SetCurveLength( xstart);
801    CurrentFT.LoadFromArray( CurrentArr, fNoInt    801    CurrentFT.LoadFromArray( CurrentArr, fNoIntegrationVariables); 
802    CurrentFT.SetCurveLength( xcurrent );          802    CurrentFT.SetCurveLength( xcurrent );
803                                                   803 
804    PrintStatus(StartFT, CurrentFT, requestStep    804    PrintStatus(StartFT, CurrentFT, requestStep, subStepNo ); 
805 }                                                 805 }
806                                                   806 
807 // -------------------------------------------    807 // ---------------------------------------------------------------------------
808                                                   808 
809 void G4MagInt_Driver::PrintStatus(const G4Fiel    809 void G4MagInt_Driver::PrintStatus(const G4FieldTrack& StartFT,
810                                   const G4Fiel    810                                   const G4FieldTrack& CurrentFT, 
811                                         G4doub    811                                         G4double      requestStep, 
812                                         G4int     812                                         G4int         subStepNo)
813 {                                                 813 {
814     G4int verboseLevel= fVerboseLevel;            814     G4int verboseLevel= fVerboseLevel;
815     const G4int noPrecision = 5;                  815     const G4int noPrecision = 5;
816     G4long oldPrec= G4cout.precision(noPrecisi    816     G4long oldPrec= G4cout.precision(noPrecision);
817     // G4cout.setf(ios_base::fixed,ios_base::f    817     // G4cout.setf(ios_base::fixed,ios_base::floatfield);
818                                                   818 
819     const G4ThreeVector StartPosition=       S    819     const G4ThreeVector StartPosition=       StartFT.GetPosition();
820     const G4ThreeVector StartUnitVelocity=   S    820     const G4ThreeVector StartUnitVelocity=   StartFT.GetMomentumDir();
821     const G4ThreeVector CurrentPosition=     C    821     const G4ThreeVector CurrentPosition=     CurrentFT.GetPosition();
822     const G4ThreeVector CurrentUnitVelocity= C    822     const G4ThreeVector CurrentUnitVelocity= CurrentFT.GetMomentumDir();
823                                                   823 
824     G4double  DotStartCurrentVeloc= StartUnitV    824     G4double  DotStartCurrentVeloc= StartUnitVelocity.dot(CurrentUnitVelocity);
825                                                   825 
826     G4double step_len= CurrentFT.GetCurveLengt    826     G4double step_len= CurrentFT.GetCurveLength() - StartFT.GetCurveLength();
827     G4double subStepSize = step_len;              827     G4double subStepSize = step_len;
828                                                   828      
829     if( (subStepNo <= 1) || (verboseLevel > 3)    829     if( (subStepNo <= 1) || (verboseLevel > 3) )
830     {                                             830     {
831        subStepNo = - subStepNo;        // To a    831        subStepNo = - subStepNo;        // To allow printing banner
832                                                   832 
833        G4cout << std::setw( 6)  << " " << std:    833        G4cout << std::setw( 6)  << " " << std::setw( 25)
834               << " G4MagInt_Driver: Current Po    834               << " G4MagInt_Driver: Current Position  and  Direction" << " "
835               << G4endl;                          835               << G4endl; 
836        G4cout << std::setw( 5) << "Step#" << "    836        G4cout << std::setw( 5) << "Step#" << " "
837               << std::setw( 7) << "s-curve" <<    837               << std::setw( 7) << "s-curve" << " "
838               << std::setw( 9) << "X(mm)" << "    838               << std::setw( 9) << "X(mm)" << " "
839               << std::setw( 9) << "Y(mm)" << "    839               << std::setw( 9) << "Y(mm)" << " "  
840               << std::setw( 9) << "Z(mm)" << "    840               << std::setw( 9) << "Z(mm)" << " "
841               << std::setw( 8) << " N_x " << "    841               << std::setw( 8) << " N_x " << " "
842               << std::setw( 8) << " N_y " << "    842               << std::setw( 8) << " N_y " << " "
843               << std::setw( 8) << " N_z " << "    843               << std::setw( 8) << " N_z " << " "
844               << std::setw( 8) << " N^2-1 " <<    844               << std::setw( 8) << " N^2-1 " << " "
845               << std::setw(10) << " N(0).N " <    845               << std::setw(10) << " N(0).N " << " "
846               << std::setw( 7) << "KinEner " <    846               << std::setw( 7) << "KinEner " << " "
847               << std::setw(12) << "Track-l" <<    847               << std::setw(12) << "Track-l" << " "   // Add the Sub-step ??
848               << std::setw(12) << "Step-len" <    848               << std::setw(12) << "Step-len" << " " 
849               << std::setw(12) << "Step-len" <    849               << std::setw(12) << "Step-len" << " " 
850               << std::setw( 9) << "ReqStep" <<    850               << std::setw( 9) << "ReqStep" << " "  
851               << G4endl;                          851               << G4endl;
852     }                                             852     }
853                                                   853 
854     if( (subStepNo <= 0) )                        854     if( (subStepNo <= 0) )
855     {                                             855     {
856       PrintStat_Aux( StartFT,  requestStep, 0.    856       PrintStat_Aux( StartFT,  requestStep, 0., 
857                        0,        0.0,             857                        0,        0.0,         1.0);
858     }                                             858     }
859                                                   859 
860     if( verboseLevel <= 3 )                       860     if( verboseLevel <= 3 )
861     {                                             861     {
862       G4cout.precision(noPrecision);              862       G4cout.precision(noPrecision);
863       PrintStat_Aux( CurrentFT, requestStep, s    863       PrintStat_Aux( CurrentFT, requestStep, step_len, 
864                      subStepNo, subStepSize, D    864                      subStepNo, subStepSize, DotStartCurrentVeloc );
865     }                                             865     }
866                                                   866 
867     G4cout.precision(oldPrec);                    867     G4cout.precision(oldPrec);
868 }                                                 868 }
869                                                   869 
870 // -------------------------------------------    870 // ---------------------------------------------------------------------------
871                                                   871 
872 void G4MagInt_Driver::PrintStat_Aux(const G4Fi    872 void G4MagInt_Driver::PrintStat_Aux(const G4FieldTrack& aFieldTrack,
873                                           G4do    873                                           G4double      requestStep, 
874                                           G4do    874                                           G4double      step_len,
875                                           G4in    875                                           G4int         subStepNo,
876                                           G4do    876                                           G4double      subStepSize,
877                                           G4do    877                                           G4double      dotVeloc_StartCurr)
878 {                                                 878 {
879     const G4ThreeVector Position = aFieldTrack    879     const G4ThreeVector Position = aFieldTrack.GetPosition();
880     const G4ThreeVector UnitVelocity = aFieldT    880     const G4ThreeVector UnitVelocity = aFieldTrack.GetMomentumDir();
881                                                   881  
882     if( subStepNo >= 0)                           882     if( subStepNo >= 0)
883     {                                             883     {
884        G4cout << std::setw( 5) << subStepNo <<    884        G4cout << std::setw( 5) << subStepNo << " ";
885     }                                             885     }
886     else                                          886     else
887     {                                             887     {
888        G4cout << std::setw( 5) << "Start" << "    888        G4cout << std::setw( 5) << "Start" << " ";
889     }                                             889     }
890     G4double curveLen= aFieldTrack.GetCurveLen    890     G4double curveLen= aFieldTrack.GetCurveLength();
891     G4cout << std::setw( 7) << curveLen;          891     G4cout << std::setw( 7) << curveLen;
892     G4cout << std::setw( 9) << Position.x() <<    892     G4cout << std::setw( 9) << Position.x() << " "
893            << std::setw( 9) << Position.y() <<    893            << std::setw( 9) << Position.y() << " "
894            << std::setw( 9) << Position.z() <<    894            << std::setw( 9) << Position.z() << " "
895            << std::setw( 8) << UnitVelocity.x(    895            << std::setw( 8) << UnitVelocity.x() << " "
896            << std::setw( 8) << UnitVelocity.y(    896            << std::setw( 8) << UnitVelocity.y() << " "
897            << std::setw( 8) << UnitVelocity.z(    897            << std::setw( 8) << UnitVelocity.z() << " ";
898     G4long oldprec= G4cout.precision(3);          898     G4long oldprec= G4cout.precision(3);
899     G4cout << std::setw( 8) << UnitVelocity.ma    899     G4cout << std::setw( 8) << UnitVelocity.mag2()-1.0 << " ";
900     G4cout.precision(6);                          900     G4cout.precision(6);
901     G4cout << std::setw(10) << dotVeloc_StartC    901     G4cout << std::setw(10) << dotVeloc_StartCurr << " ";
902     G4cout.precision(oldprec);                    902     G4cout.precision(oldprec);
903     G4cout << std::setw( 7) << aFieldTrack.Get    903     G4cout << std::setw( 7) << aFieldTrack.GetKineticEnergy();
904     G4cout << std::setw(12) << step_len << " "    904     G4cout << std::setw(12) << step_len << " ";
905                                                   905 
906     static G4ThreadLocal G4double oldCurveLeng    906     static G4ThreadLocal G4double oldCurveLength = 0.0;
907     static G4ThreadLocal G4double oldSubStepLe    907     static G4ThreadLocal G4double oldSubStepLength = 0.0;
908     static G4ThreadLocal G4int oldSubStepNo =     908     static G4ThreadLocal G4int oldSubStepNo = -1;
909                                                   909 
910     G4double subStep_len = 0.0;                   910     G4double subStep_len = 0.0;
911     if( curveLen > oldCurveLength )               911     if( curveLen > oldCurveLength )
912     {                                             912     {
913       subStep_len= curveLen - oldCurveLength;     913       subStep_len= curveLen - oldCurveLength;
914     }                                             914     }
915     else if (subStepNo == oldSubStepNo)           915     else if (subStepNo == oldSubStepNo)
916     {                                             916     {
917       subStep_len= oldSubStepLength;              917       subStep_len= oldSubStepLength;
918     }                                             918     }
919     oldCurveLength= curveLen;                     919     oldCurveLength= curveLen;
920     oldSubStepLength= subStep_len;                920     oldSubStepLength= subStep_len;
921                                                   921 
922     G4cout << std::setw(12) << subStep_len <<     922     G4cout << std::setw(12) << subStep_len << " "; 
923     G4cout << std::setw(12) << subStepSize <<     923     G4cout << std::setw(12) << subStepSize << " "; 
924     if( requestStep != -1.0 )                     924     if( requestStep != -1.0 )
925     {                                             925     {
926       G4cout << std::setw( 9) << requestStep <    926       G4cout << std::setw( 9) << requestStep << " ";
927     }                                             927     }
928     else                                          928     else
929     {                                             929     {
930        G4cout << std::setw( 9) << " InitialSte    930        G4cout << std::setw( 9) << " InitialStep " << " ";
931     }                                             931     }
932     G4cout << G4endl;                             932     G4cout << G4endl;
933 }                                                 933 }
934                                                   934 
935 // -------------------------------------------    935 // ---------------------------------------------------------------------------
936                                                   936 
937 void G4MagInt_Driver::PrintStatisticsReport()     937 void G4MagInt_Driver::PrintStatisticsReport()
938 {                                                 938 {
939   G4int noPrecBig = 6;                            939   G4int noPrecBig = 6;
940   G4long oldPrec = G4cout.precision(noPrecBig)    940   G4long oldPrec = G4cout.precision(noPrecBig);
941                                                   941 
942   G4cout << "G4MagInt_Driver Statistics of ste    942   G4cout << "G4MagInt_Driver Statistics of steps undertaken. " << G4endl;
943   G4cout << "G4MagInt_Driver: Number of Steps:    943   G4cout << "G4MagInt_Driver: Number of Steps: "
944          << " Total= " <<  fNoTotalSteps          944          << " Total= " <<  fNoTotalSteps
945          << " Bad= "   <<  fNoBadSteps            945          << " Bad= "   <<  fNoBadSteps 
946          << " Small= " <<  fNoSmallSteps          946          << " Small= " <<  fNoSmallSteps 
947          << " Non-initial small= " << (fNoSmal    947          << " Non-initial small= " << (fNoSmallSteps-fNoInitialSmallSteps)
948          << G4endl;                               948          << G4endl;
949  G4cout.precision(oldPrec);                       949  G4cout.precision(oldPrec);
950 }                                                 950 }
951                                                   951  
952 // -------------------------------------------    952 // ---------------------------------------------------------------------------
953                                                   953 
954 void G4MagInt_Driver::SetSmallestFraction(G4do    954 void G4MagInt_Driver::SetSmallestFraction(G4double newFraction)
955 {                                                 955 {
956   if( (newFraction > 1.e-16) && (newFraction <    956   if( (newFraction > 1.e-16) && (newFraction < 1e-8) )
957   {                                               957   {
958     fSmallestFraction= newFraction;               958     fSmallestFraction= newFraction;
959   }                                               959   }
960   else                                            960   else
961   {                                               961   { 
962     std::ostringstream message;                   962     std::ostringstream message;
963     message << "Smallest Fraction not changed.    963     message << "Smallest Fraction not changed. " << G4endl
964             << "  Proposed value was " << newF    964             << "  Proposed value was " << newFraction << G4endl
965             << "  Value must be between 1.e-8     965             << "  Value must be between 1.e-8 and 1.e-16";
966     G4Exception("G4MagInt_Driver::SetSmallestF    966     G4Exception("G4MagInt_Driver::SetSmallestFraction()",
967                 "GeomField1001", JustWarning,     967                 "GeomField1001", JustWarning, message);
968   }                                               968   }
969 }                                                 969 }
970                                                   970 
971 void G4MagInt_Driver::                            971 void G4MagInt_Driver::
972 GetDerivatives(const G4FieldTrack& y_curr, G4d    972 GetDerivatives(const G4FieldTrack& y_curr, G4double* dydx) const
973 {                                                 973 {
974     G4double ytemp[G4FieldTrack::ncompSVEC];      974     G4double ytemp[G4FieldTrack::ncompSVEC];
975     y_curr.DumpToArray(ytemp);                    975     y_curr.DumpToArray(ytemp);
976     pIntStepper->RightHandSide(ytemp, dydx);      976     pIntStepper->RightHandSide(ytemp, dydx);
977       // Avoid virtual call for GetStepper        977       // Avoid virtual call for GetStepper
978       // Was: GetStepper()->ComputeRightHandSi    978       // Was: GetStepper()->ComputeRightHandSide(ytemp, dydx);
979 }                                                 979 }
980                                                   980 
981 void G4MagInt_Driver::GetDerivatives(const G4F    981 void G4MagInt_Driver::GetDerivatives(const G4FieldTrack& track,
982                                      G4double     982                                      G4double dydx[],
983                                      G4double     983                                      G4double field[]) const
984 {                                                 984 {
985     G4double ytemp[G4FieldTrack::ncompSVEC];      985     G4double ytemp[G4FieldTrack::ncompSVEC];
986     track.DumpToArray(ytemp);                     986     track.DumpToArray(ytemp);
987     pIntStepper->RightHandSide(ytemp, dydx, fi    987     pIntStepper->RightHandSide(ytemp, dydx, field);
988 }                                                 988 }
989                                                   989 
990 G4EquationOfMotion* G4MagInt_Driver::GetEquati    990 G4EquationOfMotion* G4MagInt_Driver::GetEquationOfMotion()
991 {                                                 991 {
992     return pIntStepper->GetEquationOfMotion();    992     return pIntStepper->GetEquationOfMotion();
993 }                                                 993 }
994                                                   994 
995 void G4MagInt_Driver::SetEquationOfMotion(G4Eq    995 void G4MagInt_Driver::SetEquationOfMotion(G4EquationOfMotion *equation)
996 {                                                 996 {
997     pIntStepper->SetEquationOfMotion(equation)    997     pIntStepper->SetEquationOfMotion(equation);
998 }                                                 998 }
999                                                   999 
1000 const G4MagIntegratorStepper* G4MagInt_Driver    1000 const G4MagIntegratorStepper* G4MagInt_Driver::GetStepper() const
1001 {                                                1001 {
1002     return pIntStepper;                          1002     return pIntStepper;
1003 }                                                1003 }
1004                                                  1004 
1005 G4MagIntegratorStepper* G4MagInt_Driver::GetS    1005 G4MagIntegratorStepper* G4MagInt_Driver::GetStepper()
1006 {                                                1006 {
1007     return pIntStepper;                          1007     return pIntStepper;
1008 }                                                1008 }
1009                                                  1009 
1010 void G4MagInt_Driver::                           1010 void G4MagInt_Driver::
1011 RenewStepperAndAdjust(G4MagIntegratorStepper*    1011 RenewStepperAndAdjust(G4MagIntegratorStepper* pItsStepper)
1012 {                                                1012 {  
1013     pIntStepper = pItsStepper;                   1013     pIntStepper = pItsStepper;
1014     ReSetParameters();                           1014     ReSetParameters();
1015 }                                                1015 }
1016                                                  1016 
1017 void G4MagInt_Driver::StreamInfo( std::ostrea    1017 void G4MagInt_Driver::StreamInfo( std::ostream& os ) const
1018 {                                                1018 {
1019     os << "State of G4MagInt_Driver: " << std    1019     os << "State of G4MagInt_Driver: " << std::endl;
1020     os << "  Max number of Steps = " << fMaxN    1020     os << "  Max number of Steps = " << fMaxNoSteps
1021        << "    (base # = " << fMaxStepBase <<    1021        << "    (base # = " << fMaxStepBase << " )" << std::endl;
1022     os << "  Safety factor       = " << safet    1022     os << "  Safety factor       = " << safety  << std::endl;
1023     os << "  Power - shrink      = " << pshrn    1023     os << "  Power - shrink      = " << pshrnk << std::endl;
1024     os << "  Power - grow        = " << pgrow    1024     os << "  Power - grow        = " << pgrow << std::endl;
1025     os << "  threshold (errcon)  = " << errco    1025     os << "  threshold (errcon)  = " << errcon << std::endl;
1026                                                  1026 
1027     os << "    fMinimumStep =      " << fMini    1027     os << "    fMinimumStep =      " << fMinimumStep  << std::endl;
1028     os << "    Smallest Fraction = " << fSmal    1028     os << "    Smallest Fraction = " << fSmallestFraction << std::endl;
1029                                                  1029 
1030     os << "    No Integrat Vars  = " << fNoIn    1030     os << "    No Integrat Vars  = " << fNoIntegrationVariables << std::endl;
1031     os << "    Min No Vars       = " << fMinN    1031     os << "    Min No Vars       = " << fMinNoVars << std::endl;
1032     os << "    Num-Vars          = " << fNoVa    1032     os << "    Num-Vars          = " << fNoVars << std::endl;
1033                                                  1033     
1034     os << "    verbose level     = " << fVerb    1034     os << "    verbose level     = " << fVerboseLevel << std::endl;
1035     os << "    Reintegrates      = " << DoesR    1035     os << "    Reintegrates      = " << DoesReIntegrate() << std::endl;
1036 }                                                1036 }
1037                                                  1037 
1038 void PrintInfo( const G4MagInt_Driver & magDr    1038 void PrintInfo( const G4MagInt_Driver & magDrv, std::ostream& os )
1039 {                                                1039 {
1040     os << "State of G4MagInt_Driver: " << std    1040     os << "State of G4MagInt_Driver: " << std::endl;
1041     os << "  Max number of Steps = " << magDr    1041     os << "  Max number of Steps = " << magDrv.GetMaxNoSteps();
1042     //   << "    (base # = " << magDrv.fMaxSt    1042     //   << "    (base # = " << magDrv.fMaxStepBase << " )" << std::endl;
1043     os << "  Safety factor       = " << magDr    1043     os << "  Safety factor       = " << magDrv.GetSafety()  << std::endl;
1044     os << "  Power - shrink      = " << magDr    1044     os << "  Power - shrink      = " << magDrv.GetPshrnk() << std::endl;
1045     os << "  Power - grow        = " << magDr    1045     os << "  Power - grow        = " << magDrv.GetPgrow() << std::endl;
1046     os << "  threshold (errcon)  = " << magDr    1046     os << "  threshold (errcon)  = " << magDrv.GetErrcon() << std::endl;
1047                                                  1047 
1048     os << "    fMinimumStep =      " << magDr    1048     os << "    fMinimumStep =      " << magDrv.GetHmin()  << std::endl;
1049     os << "    Smallest Fraction = " << magDr    1049     os << "    Smallest Fraction = " << magDrv.GetSmallestFraction() << std::endl;
1050                                                  1050 
1051     /*****                                       1051     /*****
1052     os << "    No Integrat Vars  = " << magDr    1052     os << "    No Integrat Vars  = " << magDrv.GetNoIntegrationVariables << std::endl;
1053     os << "    Min No Vars       = " << magDr    1053     os << "    Min No Vars       = " << magDrv.GetMinNoVars << std::endl;
1054     os << "    Num-Vars          = " << magDr    1054     os << "    Num-Vars          = " << magDrv.GetNoVars << std::endl;
1055     *****/                                       1055     *****/
1056     os << "    verbose level     = " << magDr    1056     os << "    verbose level     = " << magDrv.GetVerboseLevel() << std::endl;
1057     os << "    Reintegrates      = " << magDr    1057     os << "    Reintegrates      = " << magDrv.DoesReIntegrate() << std::endl;
1058 }                                                1058 }
1059                                                  1059