18a381b04SJed Brown /* 28a381b04SJed Brown Code for timestepping with additive Runge-Kutta IMEX method 38a381b04SJed Brown 48a381b04SJed Brown Notes: 58a381b04SJed Brown The general system is written as 68a381b04SJed Brown 7f9c1d6abSBarry Smith F(t,U,Udot) = G(t,U) 88a381b04SJed Brown 98a381b04SJed Brown where F represents the stiff part of the physics and G represents the non-stiff part. 108a381b04SJed Brown 118a381b04SJed Brown */ 12b45d2f2cSJed Brown #include <petsc-private/tsimpl.h> /*I "petscts.h" I*/ 131e25c274SJed Brown #include <petscdm.h> 148a381b04SJed Brown 1519fd82e9SBarry Smith static TSARKIMEXType TSARKIMEXDefault = TSARKIMEX3; 168a381b04SJed Brown static PetscBool TSARKIMEXRegisterAllCalled; 178a381b04SJed Brown static PetscBool TSARKIMEXPackageInitialized; 18e817cc15SEmil Constantinescu static PetscInt explicit_stage_time_id; 1956dcabbaSDebojyoti Ghosh static PetscErrorCode TSExtrapolate_ARKIMEX(TS,PetscReal,Vec); 208a381b04SJed Brown 218a381b04SJed Brown typedef struct _ARKTableau *ARKTableau; 228a381b04SJed Brown struct _ARKTableau { 238a381b04SJed Brown char *name; 244f385281SJed Brown PetscInt order; /* Classical approximation order of the method */ 254f385281SJed Brown PetscInt s; /* Number of stages */ 26e817cc15SEmil Constantinescu PetscBool stiffly_accurate; /* The implicit part is stiffly accurate*/ 27e817cc15SEmil Constantinescu PetscBool FSAL_implicit; /* The implicit part is FSAL*/ 28e817cc15SEmil Constantinescu PetscBool explicit_first_stage; /* The implicit part has an explicit first stage*/ 294f385281SJed Brown PetscInt pinterp; /* Interpolation order */ 304f385281SJed Brown PetscReal *At,*bt,*ct; /* Stiff tableau */ 318a381b04SJed Brown PetscReal *A,*b,*c; /* Non-stiff tableau */ 32108c343cSJed Brown PetscReal *bembedt,*bembed; /* Embedded formula of order one less (order-1) */ 33cd652676SJed Brown PetscReal *binterpt,*binterp; /* Dense output formula */ 34108c343cSJed Brown PetscReal ccfl; /* Placeholder for CFL coefficient relative to forward Euler */ 358a381b04SJed Brown }; 368a381b04SJed Brown typedef struct _ARKTableauLink *ARKTableauLink; 378a381b04SJed Brown struct _ARKTableauLink { 388a381b04SJed Brown struct _ARKTableau tab; 398a381b04SJed Brown ARKTableauLink next; 408a381b04SJed Brown }; 418a381b04SJed Brown static ARKTableauLink ARKTableauList; 428a381b04SJed Brown 438a381b04SJed Brown typedef struct { 448a381b04SJed Brown ARKTableau tableau; 458a381b04SJed Brown Vec *Y; /* States computed during the step */ 468a381b04SJed Brown Vec *YdotI; /* Time derivatives for the stiff part */ 478a381b04SJed Brown Vec *YdotRHS; /* Function evaluations for the non-stiff part */ 489eef816dSJed Brown PetscBool prev_step_valid; /* Stored previous step (Y_prev, YdotI_prev, YdotRHS_prev) is valid */ 4956dcabbaSDebojyoti Ghosh Vec *Y_prev; /* States computed during the previous time step */ 5056dcabbaSDebojyoti Ghosh Vec *YdotI_prev; /* Time derivatives for the stiff part for the previous time step*/ 5156dcabbaSDebojyoti Ghosh Vec *YdotRHS_prev; /* Function evaluations for the non-stiff part for the previous time step*/ 52e817cc15SEmil Constantinescu Vec Ydot0; /* Holds the slope from the previous step in FSAL case */ 538a381b04SJed Brown Vec Ydot; /* Work vector holding Ydot during residual evaluation */ 548a381b04SJed Brown Vec Work; /* Generic work vector */ 558a381b04SJed Brown Vec Z; /* Ydot = shift(Y-Z) */ 568a381b04SJed Brown PetscScalar *work; /* Scalar work */ 57b296d7d5SJed Brown PetscReal scoeff; /* shift = scoeff/dt */ 588a381b04SJed Brown PetscReal stage_time; 594cc180ffSJed Brown PetscBool imex; 6056dcabbaSDebojyoti Ghosh PetscBool init_guess_extrp; /* Extrapolate initial guess from previous time-step stage values */ 61108c343cSJed Brown TSStepStatus status; 628a381b04SJed Brown } TS_ARKIMEX; 631f80e275SEmil Constantinescu /*MC 641f80e275SEmil Constantinescu TSARKIMEXARS122 - Second order ARK IMEX scheme. 658a381b04SJed Brown 661f80e275SEmil Constantinescu This method has one explicit stage and one implicit stage. 671f80e275SEmil Constantinescu 681f80e275SEmil Constantinescu References: 69d0685a90SJed Brown U. Ascher, S. Ruuth, R. J. Spiteri, Implicit-explicit Runge-Kutta methods for time dependent Partial Differential Equations. Appl. Numer. Math. 25, (1997), pp. 151-167. 701f80e275SEmil Constantinescu 711f80e275SEmil Constantinescu Level: advanced 721f80e275SEmil Constantinescu 731f80e275SEmil Constantinescu .seealso: TSARKIMEX 741f80e275SEmil Constantinescu M*/ 751f80e275SEmil Constantinescu /*MC 761f80e275SEmil Constantinescu TSARKIMEXA2 - Second order ARK IMEX scheme with A-stable implicit part. 771f80e275SEmil Constantinescu 781f80e275SEmil Constantinescu This method has an explicit stage and one implicit stage, and has an A-stable implicit scheme. This method was provided by Emil Constantinescu. 791f80e275SEmil Constantinescu 801f80e275SEmil Constantinescu Level: advanced 811f80e275SEmil Constantinescu 821f80e275SEmil Constantinescu .seealso: TSARKIMEX 831f80e275SEmil Constantinescu M*/ 841f80e275SEmil Constantinescu /*MC 851f80e275SEmil Constantinescu TSARKIMEXL2 - Second order ARK IMEX scheme with L-stable implicit part. 861f80e275SEmil Constantinescu 871f80e275SEmil Constantinescu This method has two implicit stages, and L-stable implicit scheme. 881f80e275SEmil Constantinescu 891f80e275SEmil Constantinescu References: 901f80e275SEmil Constantinescu L. Pareschi, G. Russo, Implicit-Explicit Runge-Kutta schemes and applications to hyperbolic systems with relaxations. Journal of Scientific Computing Volume: 25, Issue: 1, October, 2005, pp. 129-155 911f80e275SEmil Constantinescu 921f80e275SEmil Constantinescu Level: advanced 931f80e275SEmil Constantinescu 941f80e275SEmil Constantinescu .seealso: TSARKIMEX 951f80e275SEmil Constantinescu M*/ 961f80e275SEmil Constantinescu /*MC 97e817cc15SEmil Constantinescu TSARKIMEX1BEE - First order Backward Euler represented as an ARK IMEX scheme with extrapolation as error estimator. This is a 3-stage method. 98e817cc15SEmil Constantinescu 99e817cc15SEmil Constantinescu This method is aimed at starting the integration of implicit DAEs when explicit first-stage ARK methods are used. 100e817cc15SEmil Constantinescu 101e817cc15SEmil Constantinescu Level: advanced 102e817cc15SEmil Constantinescu 103e817cc15SEmil Constantinescu .seealso: TSARKIMEX 104e817cc15SEmil Constantinescu M*/ 105e817cc15SEmil Constantinescu /*MC 1061f80e275SEmil Constantinescu TSARKIMEX2C - Second order ARK IMEX scheme with L-stable implicit part. 1071f80e275SEmil Constantinescu 1081f80e275SEmil Constantinescu This method has one explicit stage and two implicit stages. The implicit part is the same as in TSARKIMEX2D and TSARKIMEX2E, but the explicit part has a larger stability region on the negative real axis. This method was provided by Emil Constantinescu. 1091f80e275SEmil Constantinescu 1101f80e275SEmil Constantinescu Level: advanced 1111f80e275SEmil Constantinescu 1121f80e275SEmil Constantinescu .seealso: TSARKIMEX 1131f80e275SEmil Constantinescu M*/ 11464f491ddSJed Brown /*MC 11564f491ddSJed Brown TSARKIMEX2D - Second order ARK IMEX scheme with L-stable implicit part. 11664f491ddSJed Brown 117617a39beSEmil Constantinescu This method has one explicit stage and two implicit stages. The stability function is independent of the explicit part in the infinity limit of the implict component. This method was provided by Emil Constantinescu. 11864f491ddSJed Brown 119b330ce4dSSatish Balay Level: advanced 120b330ce4dSSatish Balay 12164f491ddSJed Brown .seealso: TSARKIMEX 12264f491ddSJed Brown M*/ 12364f491ddSJed Brown /*MC 12464f491ddSJed Brown TSARKIMEX2E - Second order ARK IMEX scheme with L-stable implicit part. 12564f491ddSJed Brown 12664f491ddSJed Brown This method has one explicit stage and two implicit stages. It is is an optimal method developed by Emil Constantinescu. 12764f491ddSJed Brown 128b330ce4dSSatish Balay Level: advanced 129b330ce4dSSatish Balay 13064f491ddSJed Brown .seealso: TSARKIMEX 13164f491ddSJed Brown M*/ 13264f491ddSJed Brown /*MC 1336cf0794eSJed Brown TSARKIMEXPRSSP2 - Second order SSP ARK IMEX scheme. 1346cf0794eSJed Brown 1356cf0794eSJed Brown This method has three implicit stages. 1366cf0794eSJed Brown 1376cf0794eSJed Brown References: 1386cf0794eSJed Brown L. Pareschi, G. Russo, Implicit-Explicit Runge-Kutta schemes and applications to hyperbolic systems with relaxations. Journal of Scientific Computing Volume: 25, Issue: 1, October, 2005, pp. 129-155 1396cf0794eSJed Brown 1406cf0794eSJed Brown This method is referred to as SSP2-(3,3,2) in http://arxiv.org/abs/1110.4375 1416cf0794eSJed Brown 1426cf0794eSJed Brown Level: advanced 1436cf0794eSJed Brown 1446cf0794eSJed Brown .seealso: TSARKIMEX 1456cf0794eSJed Brown M*/ 1466cf0794eSJed Brown /*MC 14764f491ddSJed Brown TSARKIMEX3 - Third order ARK IMEX scheme with L-stable implicit part. 14864f491ddSJed Brown 14964f491ddSJed Brown This method has one explicit stage and three implicit stages. 15064f491ddSJed Brown 15164f491ddSJed Brown References: 15264f491ddSJed Brown Kennedy and Carpenter 2003. 15364f491ddSJed Brown 154b330ce4dSSatish Balay Level: advanced 155b330ce4dSSatish Balay 15664f491ddSJed Brown .seealso: TSARKIMEX 15764f491ddSJed Brown M*/ 15864f491ddSJed Brown /*MC 1596cf0794eSJed Brown TSARKIMEXARS443 - Third order ARK IMEX scheme. 1606cf0794eSJed Brown 1616cf0794eSJed Brown This method has one explicit stage and four implicit stages. 1626cf0794eSJed Brown 1636cf0794eSJed Brown References: 164d0685a90SJed Brown U. Ascher, S. Ruuth, R. J. Spiteri, Implicit-explicit Runge-Kutta methods for time dependent Partial Differential Equations. Appl. Numer. Math. 25, (1997), pp. 151-167. 1656cf0794eSJed Brown 1666cf0794eSJed Brown This method is referred to as ARS(4,4,3) in http://arxiv.org/abs/1110.4375 1676cf0794eSJed Brown 1686cf0794eSJed Brown Level: advanced 1696cf0794eSJed Brown 1706cf0794eSJed Brown .seealso: TSARKIMEX 1716cf0794eSJed Brown M*/ 1726cf0794eSJed Brown /*MC 1736cf0794eSJed Brown TSARKIMEXBPR3 - Third order ARK IMEX scheme. 1746cf0794eSJed Brown 1756cf0794eSJed Brown This method has one explicit stage and four implicit stages. 1766cf0794eSJed Brown 1776cf0794eSJed Brown References: 1786cf0794eSJed Brown This method is referred to as ARK3 in http://arxiv.org/abs/1110.4375 1796cf0794eSJed Brown 1806cf0794eSJed Brown Level: advanced 1816cf0794eSJed Brown 1826cf0794eSJed Brown .seealso: TSARKIMEX 1836cf0794eSJed Brown M*/ 1846cf0794eSJed Brown /*MC 18564f491ddSJed Brown TSARKIMEX4 - Fourth order ARK IMEX scheme with L-stable implicit part. 18664f491ddSJed Brown 18764f491ddSJed Brown This method has one explicit stage and four implicit stages. 18864f491ddSJed Brown 18964f491ddSJed Brown References: 19064f491ddSJed Brown Kennedy and Carpenter 2003. 19164f491ddSJed Brown 192b330ce4dSSatish Balay Level: advanced 193b330ce4dSSatish Balay 19464f491ddSJed Brown .seealso: TSARKIMEX 19564f491ddSJed Brown M*/ 19664f491ddSJed Brown /*MC 19764f491ddSJed Brown TSARKIMEX5 - Fifth order ARK IMEX scheme with L-stable implicit part. 19864f491ddSJed Brown 19964f491ddSJed Brown This method has one explicit stage and five implicit stages. 20064f491ddSJed Brown 20164f491ddSJed Brown References: 20264f491ddSJed Brown Kennedy and Carpenter 2003. 20364f491ddSJed Brown 204b330ce4dSSatish Balay Level: advanced 205b330ce4dSSatish Balay 20664f491ddSJed Brown .seealso: TSARKIMEX 20764f491ddSJed Brown M*/ 20864f491ddSJed Brown 2098a381b04SJed Brown #undef __FUNCT__ 2108a381b04SJed Brown #define __FUNCT__ "TSARKIMEXRegisterAll" 2118a381b04SJed Brown /*@C 2128a381b04SJed Brown TSARKIMEXRegisterAll - Registers all of the additive Runge-Kutta implicit-explicit methods in TSARKIMEX 2138a381b04SJed Brown 214fca742c7SJed Brown Not Collective, but should be called by all processes which will need the schemes to be registered 2158a381b04SJed Brown 2168a381b04SJed Brown Level: advanced 2178a381b04SJed Brown 2188a381b04SJed Brown .keywords: TS, TSARKIMEX, register, all 2198a381b04SJed Brown 2208a381b04SJed Brown .seealso: TSARKIMEXRegisterDestroy() 2218a381b04SJed Brown @*/ 2228a381b04SJed Brown PetscErrorCode TSARKIMEXRegisterAll(void) 2238a381b04SJed Brown { 2248a381b04SJed Brown PetscErrorCode ierr; 2258a381b04SJed Brown 2268a381b04SJed Brown PetscFunctionBegin; 2278a381b04SJed Brown if (TSARKIMEXRegisterAllCalled) PetscFunctionReturn(0); 2288a381b04SJed Brown TSARKIMEXRegisterAllCalled = PETSC_TRUE; 229e817cc15SEmil Constantinescu 230e817cc15SEmil Constantinescu { 231e817cc15SEmil Constantinescu const PetscReal 232e817cc15SEmil Constantinescu A[3][3] = {{0.0,0.0,0.0}, 233e817cc15SEmil Constantinescu {0.0,0.0,0.0}, 234748ad121SEmil Constantinescu {0.0,0.5,0.0}}, 235e817cc15SEmil Constantinescu At[3][3] = {{1.0,0.0,0.0}, 236e817cc15SEmil Constantinescu {0.0,0.5,0.0}, 237e817cc15SEmil Constantinescu {0.0,0.5,0.5}}, 238e817cc15SEmil Constantinescu b[3] = {0.0,0.5,0.5}, 239e817cc15SEmil Constantinescu bembedt[3] = {1.0,0.0,0.0}; 2400298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEX1BEE,2,3,&At[0][0],b,NULL,&A[0][0],b,NULL,bembedt,bembedt,1,b,NULL);CHKERRQ(ierr); 241e817cc15SEmil Constantinescu } 2428a381b04SJed Brown { 2438a381b04SJed Brown const PetscReal 2441f80e275SEmil Constantinescu A[2][2] = {{0.0,0.0}, 2451f80e275SEmil Constantinescu {0.5,0.0}}, 2461f80e275SEmil Constantinescu At[2][2] = {{0.0,0.0}, 2471f80e275SEmil Constantinescu {0.0,0.5}}, 2481f80e275SEmil Constantinescu b[2] = {0.0,1.0}, 2491f80e275SEmil Constantinescu bembedt[2] = {0.5,0.5}; 2501f80e275SEmil Constantinescu /* binterpt[2][2] = {{1.0,-1.0},{0.0,1.0}}; second order dense output has poor stability properties and hence it is not currently in use*/ 2510298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEXARS122,2,2,&At[0][0],b,NULL,&A[0][0],b,NULL,bembedt,bembedt,1,b,NULL);CHKERRQ(ierr); 2521f80e275SEmil Constantinescu } 2531f80e275SEmil Constantinescu { 2541f80e275SEmil Constantinescu const PetscReal 2551f80e275SEmil Constantinescu A[2][2] = {{0.0,0.0}, 2561f80e275SEmil Constantinescu {1.0,0.0}}, 2571f80e275SEmil Constantinescu At[2][2] = {{0.0,0.0}, 2581f80e275SEmil Constantinescu {0.5,0.5}}, 2591f80e275SEmil Constantinescu b[2] = {0.5,0.5}, 2601f80e275SEmil Constantinescu bembedt[2] = {0.0,1.0}; 2611f80e275SEmil Constantinescu /* binterpt[2][2] = {{1.0,-0.5},{0.0,0.5}} second order dense output has poor stability properties and hence it is not currently in use*/ 2620298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEXA2,2,2,&At[0][0],b,NULL,&A[0][0],b,NULL,bembedt,bembedt,1,b,NULL);CHKERRQ(ierr); 2631f80e275SEmil Constantinescu } 2641f80e275SEmil Constantinescu { 265da80777bSKarl Rupp /* const PetscReal us2 = 1.0-1.0/PetscSqrtReal((PetscReal)2.0); Direct evaluation: 0.2928932188134524755992. Used below to ensure all values are available at compile time */ 2661f80e275SEmil Constantinescu const PetscReal 2671f80e275SEmil Constantinescu A[2][2] = {{0.0,0.0}, 2681f80e275SEmil Constantinescu {1.0,0.0}}, 269da80777bSKarl Rupp At[2][2] = {{0.2928932188134524755992,0.0}, 270da80777bSKarl Rupp {1.0-2.0*0.2928932188134524755992,0.2928932188134524755992}}, 2711f80e275SEmil Constantinescu b[2] = {0.5,0.5}, 2721f80e275SEmil Constantinescu bembedt[2] = {0.0,1.0}, 273da80777bSKarl Rupp binterpt[2][2] = {{ (0.2928932188134524755992-1.0)/(2.0*0.2928932188134524755992-1.0),-1/(2.0*(1.0-2.0*0.2928932188134524755992))}, 274da80777bSKarl Rupp {1-(0.2928932188134524755992-1.0)/(2.0*0.2928932188134524755992-1.0),-1/(2.0*(1.0-2.0*0.2928932188134524755992))}}, 2751f80e275SEmil Constantinescu binterp[2][2] = {{1.0,-0.5},{0.0,0.5}}; 2760298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEXL2,2,2,&At[0][0],b,NULL,&A[0][0],b,NULL,bembedt,bembedt,2,binterpt[0],binterp[0]);CHKERRQ(ierr); 2771f80e275SEmil Constantinescu } 2781f80e275SEmil Constantinescu { 279da80777bSKarl Rupp /* const PetscReal s2 = PetscSqrtReal((PetscReal)2.0), Direct evaluation: 1.414213562373095048802. Used below to ensure all values are available at compile time */ 280da80777bSKarl Rupp const PetscReal 2818a381b04SJed Brown A[3][3] = {{0,0,0}, 282da80777bSKarl Rupp {2-1.414213562373095048802,0,0}, 283617a39beSEmil Constantinescu {0.5,0.5,0}}, 284da80777bSKarl Rupp At[3][3] = {{0,0,0}, 285da80777bSKarl Rupp {1-1/1.414213562373095048802,1-1/1.414213562373095048802,0}, 286da80777bSKarl Rupp {1/(2*1.414213562373095048802),1/(2*1.414213562373095048802),1-1/1.414213562373095048802}}, 287da80777bSKarl Rupp bembedt[3] = {(4.-1.414213562373095048802)/8.,(4.-1.414213562373095048802)/8.,1/(2.*1.414213562373095048802)}, 288da80777bSKarl Rupp binterpt[3][2] = {{1.0/1.414213562373095048802,-1.0/(2.0*1.414213562373095048802)}, 289da80777bSKarl Rupp {1.0/1.414213562373095048802,-1.0/(2.0*1.414213562373095048802)}, 290da80777bSKarl Rupp {1.0-1.414213562373095048802,1.0/1.414213562373095048802}}; 2910298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEX2C,2,3,&At[0][0],NULL,NULL,&A[0][0],NULL,NULL,bembedt,bembedt,2,binterpt[0],NULL);CHKERRQ(ierr); 2921f80e275SEmil Constantinescu } 2931f80e275SEmil Constantinescu { 294da80777bSKarl Rupp /* const PetscReal s2 = PetscSqrtReal((PetscReal)2.0), Direct evaluation: 1.414213562373095048802. Used below to ensure all values are available at compile time */ 295da80777bSKarl Rupp const PetscReal 2961f80e275SEmil Constantinescu A[3][3] = {{0,0,0}, 297da80777bSKarl Rupp {2-1.414213562373095048802,0,0}, 2988a381b04SJed Brown {0.75,0.25,0}}, 299da80777bSKarl Rupp At[3][3] = {{0,0,0}, 300da80777bSKarl Rupp {1-1/1.414213562373095048802,1-1/1.414213562373095048802,0}, 301da80777bSKarl Rupp {1/(2*1.414213562373095048802),1/(2*1.414213562373095048802),1-1/1.414213562373095048802}}, 302da80777bSKarl Rupp bembedt[3] = {(4.-1.414213562373095048802)/8.,(4.-1.414213562373095048802)/8.,1/(2.*1.414213562373095048802)}, 303da80777bSKarl Rupp binterpt[3][2] = {{1.0/1.414213562373095048802,-1.0/(2.0*1.414213562373095048802)}, 304da80777bSKarl Rupp {1.0/1.414213562373095048802,-1.0/(2.0*1.414213562373095048802)}, 305da80777bSKarl Rupp {1.0-1.414213562373095048802,1.0/1.414213562373095048802}}; 3060298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEX2D,2,3,&At[0][0],NULL,NULL,&A[0][0],NULL,NULL,bembedt,bembedt,2,binterpt[0],NULL);CHKERRQ(ierr); 3078a381b04SJed Brown } 30806db7b1cSJed Brown { /* Optimal for linear implicit part */ 309da80777bSKarl Rupp /* const PetscReal s2 = PetscSqrtReal((PetscReal)2.0), Direct evaluation: 1.414213562373095048802. Used below to ensure all values are available at compile time */ 310da80777bSKarl Rupp const PetscReal 311da80777bSKarl Rupp A[3][3] = {{0,0,0}, 312da80777bSKarl Rupp {2-1.414213562373095048802,0,0}, 313da80777bSKarl Rupp {(3-2*1.414213562373095048802)/6,(3+2*1.414213562373095048802)/6,0}}, 314da80777bSKarl Rupp At[3][3] = {{0,0,0}, 315da80777bSKarl Rupp {1-1/1.414213562373095048802,1-1/1.414213562373095048802,0}, 316da80777bSKarl Rupp {1/(2*1.414213562373095048802),1/(2*1.414213562373095048802),1-1/1.414213562373095048802}}, 317da80777bSKarl Rupp bembedt[3] = {(4.-1.414213562373095048802)/8.,(4.-1.414213562373095048802)/8.,1/(2.*1.414213562373095048802)}, 318da80777bSKarl Rupp binterpt[3][2] = {{1.0/1.414213562373095048802,-1.0/(2.0*1.414213562373095048802)}, 319da80777bSKarl Rupp {1.0/1.414213562373095048802,-1.0/(2.0*1.414213562373095048802)}, 320da80777bSKarl Rupp {1.0-1.414213562373095048802,1.0/1.414213562373095048802}}; 3210298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEX2E,2,3,&At[0][0],NULL,NULL,&A[0][0],NULL,NULL,bembedt,bembedt,2,binterpt[0],NULL);CHKERRQ(ierr); 322a3a57f36SJed Brown } 3236cf0794eSJed Brown { /* Optimal for linear implicit part */ 3246cf0794eSJed Brown const PetscReal 3256cf0794eSJed Brown A[3][3] = {{0,0,0}, 3266cf0794eSJed Brown {0.5,0,0}, 3276cf0794eSJed Brown {0.5,0.5,0}}, 3286cf0794eSJed Brown At[3][3] = {{0.25,0,0}, 3296cf0794eSJed Brown {0,0.25,0}, 3306cf0794eSJed Brown {1./3,1./3,1./3}}; 3310298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEXPRSSP2,2,3,&At[0][0],NULL,NULL,&A[0][0],NULL,NULL,NULL,NULL,0,NULL,NULL);CHKERRQ(ierr); 3326cf0794eSJed Brown } 333a3a57f36SJed Brown { 334a3a57f36SJed Brown const PetscReal 335a3a57f36SJed Brown A[4][4] = {{0,0,0,0}, 3364040e9f2SJed Brown {1767732205903./2027836641118.,0,0,0}, 3374040e9f2SJed Brown {5535828885825./10492691773637.,788022342437./10882634858940.,0,0}, 3384040e9f2SJed Brown {6485989280629./16251701735622.,-4246266847089./9704473918619.,10755448449292./10357097424841.,0}}, 339a3a57f36SJed Brown At[4][4] = {{0,0,0,0}, 3404040e9f2SJed Brown {1767732205903./4055673282236.,1767732205903./4055673282236.,0,0}, 3414040e9f2SJed Brown {2746238789719./10658868560708.,-640167445237./6845629431997.,1767732205903./4055673282236.,0}, 3424040e9f2SJed Brown {1471266399579./7840856788654.,-4482444167858./7529755066697.,11266239266428./11593286722821.,1767732205903./4055673282236.}}, 343cc46b9d1SJed Brown bembedt[4] = {2756255671327./12835298489170.,-10771552573575./22201958757719.,9247589265047./10645013368117.,2193209047091./5459859503100.}, 3444040e9f2SJed Brown binterpt[4][2] = {{4655552711362./22874653954995., -215264564351./13552729205753.}, 3454040e9f2SJed Brown {-18682724506714./9892148508045.,17870216137069./13817060693119.}, 3464040e9f2SJed Brown {34259539580243./13192909600954.,-28141676662227./17317692491321.}, 3474040e9f2SJed Brown {584795268549./6622622206610., 2508943948391./7218656332882.}}; 3480298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEX3,3,4,&At[0][0],NULL,NULL,&A[0][0],NULL,NULL,bembedt,bembedt,2,binterpt[0],NULL);CHKERRQ(ierr); 349a3a57f36SJed Brown } 350a3a57f36SJed Brown { 351a3a57f36SJed Brown const PetscReal 352e74514c0SSatish Balay A[5][5] = {{0,0,0,0,0}, 3536cf0794eSJed Brown {1./2,0,0,0,0}, 3546cf0794eSJed Brown {11./18,1./18,0,0,0}, 3556cf0794eSJed Brown {5./6,-5./6,.5,0,0}, 3566cf0794eSJed Brown {1./4,7./4,3./4,-7./4,0}}, 3576cf0794eSJed Brown At[5][5] = {{0,0,0,0,0}, 3586cf0794eSJed Brown {0,1./2,0,0,0}, 3596cf0794eSJed Brown {0,1./6,1./2,0,0}, 3606cf0794eSJed Brown {0,-1./2,1./2,1./2,0}, 361108c343cSJed Brown {0,3./2,-3./2,1./2,1./2}}, 3620298fd71SBarry Smith *bembedt = NULL; 3630298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEXARS443,3,5,&At[0][0],NULL,NULL,&A[0][0],NULL,NULL,bembedt,bembedt,0,NULL,NULL);CHKERRQ(ierr); 3646cf0794eSJed Brown } 3656cf0794eSJed Brown { 3666cf0794eSJed Brown const PetscReal 367e74514c0SSatish Balay A[5][5] = {{0,0,0,0,0}, 3686cf0794eSJed Brown {1,0,0,0,0}, 3696cf0794eSJed Brown {4./9,2./9,0,0,0}, 3706cf0794eSJed Brown {1./4,0,3./4,0,0}, 3716cf0794eSJed Brown {1./4,0,3./5,0,0}}, 372e74514c0SSatish Balay At[5][5] = {{0,0,0,0,0}, 3736cf0794eSJed Brown {.5,.5,0,0,0}, 3746cf0794eSJed Brown {5./18,-1./9,.5,0,0}, 3756cf0794eSJed Brown {.5,0,0,.5,0}, 376108c343cSJed Brown {.25,0,.75,-.5,.5}}, 3770298fd71SBarry Smith *bembedt = NULL; 3780298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEXBPR3,3,5,&At[0][0],NULL,NULL,&A[0][0],NULL,NULL,bembedt,bembedt,0,NULL,NULL);CHKERRQ(ierr); 3796cf0794eSJed Brown } 3806cf0794eSJed Brown { 3816cf0794eSJed Brown const PetscReal 382a3a57f36SJed Brown A[6][6] = {{0,0,0,0,0,0}, 383a3a57f36SJed Brown {1./2,0,0,0,0,0}, 3844040e9f2SJed Brown {13861./62500.,6889./62500.,0,0,0,0}, 3854040e9f2SJed Brown {-116923316275./2393684061468.,-2731218467317./15368042101831.,9408046702089./11113171139209.,0,0,0}, 3864040e9f2SJed Brown {-451086348788./2902428689909.,-2682348792572./7519795681897.,12662868775082./11960479115383.,3355817975965./11060851509271.,0,0}, 3874040e9f2SJed Brown {647845179188./3216320057751.,73281519250./8382639484533.,552539513391./3454668386233.,3354512671639./8306763924573.,4040./17871.,0}}, 388a3a57f36SJed Brown At[6][6] = {{0,0,0,0,0,0}, 389a3a57f36SJed Brown {1./4,1./4,0,0,0,0}, 3904040e9f2SJed Brown {8611./62500.,-1743./31250.,1./4,0,0,0}, 3914040e9f2SJed Brown {5012029./34652500.,-654441./2922500.,174375./388108.,1./4,0,0}, 3924040e9f2SJed Brown {15267082809./155376265600.,-71443401./120774400.,730878875./902184768.,2285395./8070912.,1./4,0}, 3934040e9f2SJed Brown {82889./524892.,0,15625./83664.,69875./102672.,-2260./8211,1./4}}, 394cc46b9d1SJed Brown bembedt[6] = {4586570599./29645900160.,0,178811875./945068544.,814220225./1159782912.,-3700637./11593932.,61727./225920.}, 3954040e9f2SJed Brown binterpt[6][3] = {{6943876665148./7220017795957.,-54480133./30881146.,6818779379841./7100303317025.}, 396cd652676SJed Brown {0,0,0}, 3974040e9f2SJed Brown {7640104374378./9702883013639.,-11436875./14766696.,2173542590792./12501825683035.}, 3984040e9f2SJed Brown {-20649996744609./7521556579894.,174696575./18121608.,-31592104683404./5083833661969.}, 3994040e9f2SJed Brown {8854892464581./2390941311638.,-12120380./966161.,61146701046299./7138195549469.}, 4004040e9f2SJed Brown {-11397109935349./6675773540249.,3843./706.,-17219254887155./4939391667607.}}; 4010298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEX4,4,6,&At[0][0],NULL,NULL,&A[0][0],NULL,NULL,bembedt,bembedt,3,binterpt[0],NULL);CHKERRQ(ierr); 402a3a57f36SJed Brown } 403a3a57f36SJed Brown { 404a3a57f36SJed Brown const PetscReal 405a3a57f36SJed Brown A[8][8] = {{0,0,0,0,0,0,0,0}, 406a3a57f36SJed Brown {41./100,0,0,0,0,0,0,0}, 4074040e9f2SJed Brown {367902744464./2072280473677.,677623207551./8224143866563.,0,0,0,0,0,0}, 4084040e9f2SJed Brown {1268023523408./10340822734521.,0,1029933939417./13636558850479.,0,0,0,0,0}, 4094040e9f2SJed Brown {14463281900351./6315353703477.,0,66114435211212./5879490589093.,-54053170152839./4284798021562.,0,0,0,0}, 4104040e9f2SJed Brown {14090043504691./34967701212078.,0,15191511035443./11219624916014.,-18461159152457./12425892160975.,-281667163811./9011619295870.,0,0,0}, 4114040e9f2SJed Brown {19230459214898./13134317526959.,0,21275331358303./2942455364971.,-38145345988419./4862620318723.,-1./8,-1./8,0,0}, 4124040e9f2SJed Brown {-19977161125411./11928030595625.,0,-40795976796054./6384907823539.,177454434618887./12078138498510.,782672205425./8267701900261.,-69563011059811./9646580694205.,7356628210526./4942186776405.,0}}, 413a3a57f36SJed Brown At[8][8] = {{0,0,0,0,0,0,0,0}, 4144040e9f2SJed Brown {41./200.,41./200.,0,0,0,0,0,0}, 4154040e9f2SJed Brown {41./400.,-567603406766./11931857230679.,41./200.,0,0,0,0,0}, 4164040e9f2SJed Brown {683785636431./9252920307686.,0,-110385047103./1367015193373.,41./200.,0,0,0,0}, 4174040e9f2SJed Brown {3016520224154./10081342136671.,0,30586259806659./12414158314087.,-22760509404356./11113319521817.,41./200.,0,0,0}, 4184040e9f2SJed Brown {218866479029./1489978393911.,0,638256894668./5436446318841.,-1179710474555./5321154724896.,-60928119172./8023461067671.,41./200.,0,0}, 4194040e9f2SJed Brown {1020004230633./5715676835656.,0,25762820946817./25263940353407.,-2161375909145./9755907335909.,-211217309593./5846859502534.,-4269925059573./7827059040749.,41./200,0}, 4204040e9f2SJed Brown {-872700587467./9133579230613.,0,0,22348218063261./9555858737531.,-1143369518992./8141816002931.,-39379526789629./19018526304540.,32727382324388./42900044865799.,41./200.}}, 421cc46b9d1SJed Brown bembedt[8] = {-975461918565./9796059967033.,0,0,78070527104295./32432590147079.,-548382580838./3424219808633.,-33438840321285./15594753105479.,3629800801594./4656183773603.,4035322873751./18575991585200.}, 4224040e9f2SJed Brown binterpt[8][3] = {{-17674230611817./10670229744614., 43486358583215./12773830924787., -9257016797708./5021505065439.}, 423cd652676SJed Brown {0, 0, 0 }, 424cd652676SJed Brown {0, 0, 0 }, 4254040e9f2SJed Brown {65168852399939./7868540260826., -91478233927265./11067650958493., 26096422576131./11239449250142.}, 4264040e9f2SJed Brown {15494834004392./5936557850923., -79368583304911./10890268929626., 92396832856987./20362823103730.}, 4274040e9f2SJed Brown {-99329723586156./26959484932159., -12239297817655./9152339842473., 30029262896817./10175596800299.}, 4284040e9f2SJed Brown {-19024464361622./5461577185407., 115839755401235./10719374521269., -26136350496073./3983972220547.}, 4294040e9f2SJed Brown {-6511271360970./6095937251113., 5843115559534./2180450260947., -5289405421727./3760307252460. }}; 4300298fd71SBarry Smith ierr = TSARKIMEXRegister(TSARKIMEX5,5,8,&At[0][0],NULL,NULL,&A[0][0],NULL,NULL,bembedt,bembedt,3,binterpt[0],NULL);CHKERRQ(ierr); 431a3a57f36SJed Brown } 4328a381b04SJed Brown PetscFunctionReturn(0); 4338a381b04SJed Brown } 4348a381b04SJed Brown 4358a381b04SJed Brown #undef __FUNCT__ 4368a381b04SJed Brown #define __FUNCT__ "TSARKIMEXRegisterDestroy" 4378a381b04SJed Brown /*@C 4388a381b04SJed Brown TSARKIMEXRegisterDestroy - Frees the list of schemes that were registered by TSARKIMEXRegister(). 4398a381b04SJed Brown 4408a381b04SJed Brown Not Collective 4418a381b04SJed Brown 4428a381b04SJed Brown Level: advanced 4438a381b04SJed Brown 4448a381b04SJed Brown .keywords: TSARKIMEX, register, destroy 445607a6623SBarry Smith .seealso: TSARKIMEXRegister(), TSARKIMEXRegisterAll() 4468a381b04SJed Brown @*/ 4478a381b04SJed Brown PetscErrorCode TSARKIMEXRegisterDestroy(void) 4488a381b04SJed Brown { 4498a381b04SJed Brown PetscErrorCode ierr; 4508a381b04SJed Brown ARKTableauLink link; 4518a381b04SJed Brown 4528a381b04SJed Brown PetscFunctionBegin; 4538a381b04SJed Brown while ((link = ARKTableauList)) { 4548a381b04SJed Brown ARKTableau t = &link->tab; 4558a381b04SJed Brown ARKTableauList = link->next; 4568a381b04SJed Brown ierr = PetscFree6(t->At,t->bt,t->ct,t->A,t->b,t->c);CHKERRQ(ierr); 457108c343cSJed Brown ierr = PetscFree2(t->bembedt,t->bembed);CHKERRQ(ierr); 458cd652676SJed Brown ierr = PetscFree2(t->binterpt,t->binterp);CHKERRQ(ierr); 4598a381b04SJed Brown ierr = PetscFree(t->name);CHKERRQ(ierr); 4608a381b04SJed Brown ierr = PetscFree(link);CHKERRQ(ierr); 4618a381b04SJed Brown } 4628a381b04SJed Brown TSARKIMEXRegisterAllCalled = PETSC_FALSE; 4638a381b04SJed Brown PetscFunctionReturn(0); 4648a381b04SJed Brown } 4658a381b04SJed Brown 4668a381b04SJed Brown #undef __FUNCT__ 4678a381b04SJed Brown #define __FUNCT__ "TSARKIMEXInitializePackage" 4688a381b04SJed Brown /*@C 4698a381b04SJed Brown TSARKIMEXInitializePackage - This function initializes everything in the TSARKIMEX package. It is called 4708a381b04SJed Brown from PetscDLLibraryRegister() when using dynamic libraries, and on the first call to TSCreate_ARKIMEX() 4718a381b04SJed Brown when using static libraries. 4728a381b04SJed Brown 4738a381b04SJed Brown Level: developer 4748a381b04SJed Brown 4758a381b04SJed Brown .keywords: TS, TSARKIMEX, initialize, package 4768a381b04SJed Brown .seealso: PetscInitialize() 4778a381b04SJed Brown @*/ 478607a6623SBarry Smith PetscErrorCode TSARKIMEXInitializePackage(void) 4798a381b04SJed Brown { 4808a381b04SJed Brown PetscErrorCode ierr; 4818a381b04SJed Brown 4828a381b04SJed Brown PetscFunctionBegin; 4838a381b04SJed Brown if (TSARKIMEXPackageInitialized) PetscFunctionReturn(0); 4848a381b04SJed Brown TSARKIMEXPackageInitialized = PETSC_TRUE; 4858a381b04SJed Brown ierr = TSARKIMEXRegisterAll();CHKERRQ(ierr); 486e817cc15SEmil Constantinescu ierr = PetscObjectComposedDataRegister(&explicit_stage_time_id);CHKERRQ(ierr); 4878a381b04SJed Brown ierr = PetscRegisterFinalize(TSARKIMEXFinalizePackage);CHKERRQ(ierr); 4888a381b04SJed Brown PetscFunctionReturn(0); 4898a381b04SJed Brown } 4908a381b04SJed Brown 4918a381b04SJed Brown #undef __FUNCT__ 4928a381b04SJed Brown #define __FUNCT__ "TSARKIMEXFinalizePackage" 4938a381b04SJed Brown /*@C 4948a381b04SJed Brown TSARKIMEXFinalizePackage - This function destroys everything in the TSARKIMEX package. It is 4958a381b04SJed Brown called from PetscFinalize(). 4968a381b04SJed Brown 4978a381b04SJed Brown Level: developer 4988a381b04SJed Brown 4998a381b04SJed Brown .keywords: Petsc, destroy, package 5008a381b04SJed Brown .seealso: PetscFinalize() 5018a381b04SJed Brown @*/ 5028a381b04SJed Brown PetscErrorCode TSARKIMEXFinalizePackage(void) 5038a381b04SJed Brown { 5048a381b04SJed Brown PetscErrorCode ierr; 5058a381b04SJed Brown 5068a381b04SJed Brown PetscFunctionBegin; 5078a381b04SJed Brown TSARKIMEXPackageInitialized = PETSC_FALSE; 5088a381b04SJed Brown ierr = TSARKIMEXRegisterDestroy();CHKERRQ(ierr); 5098a381b04SJed Brown PetscFunctionReturn(0); 5108a381b04SJed Brown } 5118a381b04SJed Brown 5128a381b04SJed Brown #undef __FUNCT__ 5138a381b04SJed Brown #define __FUNCT__ "TSARKIMEXRegister" 514cd652676SJed Brown /*@C 515cd652676SJed Brown TSARKIMEXRegister - register an ARK IMEX scheme by providing the entries in the Butcher tableau and optionally embedded approximations and interpolation 516cd652676SJed Brown 517cd652676SJed Brown Not Collective, but the same schemes should be registered on all processes on which they will be used 518cd652676SJed Brown 519cd652676SJed Brown Input Parameters: 520cd652676SJed Brown + name - identifier for method 521cd652676SJed Brown . order - approximation order of method 522cd652676SJed Brown . s - number of stages, this is the dimension of the matrices below 523cd652676SJed Brown . At - Butcher table of stage coefficients for stiff part (dimension s*s, row-major) 5240298fd71SBarry Smith . bt - Butcher table for completing the stiff part of the step (dimension s; NULL to use the last row of At) 5250298fd71SBarry Smith . ct - Abscissa of each stiff stage (dimension s, NULL to use row sums of At) 526cd652676SJed Brown . A - Non-stiff stage coefficients (dimension s*s, row-major) 5270298fd71SBarry Smith . b - Non-stiff step completion table (dimension s; NULL to use last row of At) 5280298fd71SBarry Smith . c - Non-stiff abscissa (dimension s; NULL to use row sums of A) 5290298fd71SBarry Smith . bembedt - Stiff part of completion table for embedded method (dimension s; NULL if not available) 5300298fd71SBarry Smith . bembed - Non-stiff part of completion table for embedded method (dimension s; NULL to use bembedt if provided) 531cd652676SJed Brown . pinterp - Order of the interpolation scheme, equal to the number of columns of binterpt and binterp 532cd652676SJed Brown . binterpt - Coefficients of the interpolation formula for the stiff part (dimension s*pinterp) 5330298fd71SBarry Smith - binterp - Coefficients of the interpolation formula for the non-stiff part (dimension s*pinterp; NULL to reuse binterpt) 534cd652676SJed Brown 535cd652676SJed Brown Notes: 536cd652676SJed Brown Several ARK IMEX methods are provided, this function is only needed to create new methods. 537cd652676SJed Brown 538cd652676SJed Brown Level: advanced 539cd652676SJed Brown 540cd652676SJed Brown .keywords: TS, register 541cd652676SJed Brown 542cd652676SJed Brown .seealso: TSARKIMEX 543cd652676SJed Brown @*/ 54419fd82e9SBarry Smith PetscErrorCode TSARKIMEXRegister(TSARKIMEXType name,PetscInt order,PetscInt s, 5458a381b04SJed Brown const PetscReal At[],const PetscReal bt[],const PetscReal ct[], 546cd652676SJed Brown const PetscReal A[],const PetscReal b[],const PetscReal c[], 547108c343cSJed Brown const PetscReal bembedt[],const PetscReal bembed[], 548cd652676SJed Brown PetscInt pinterp,const PetscReal binterpt[],const PetscReal binterp[]) 5498a381b04SJed Brown { 5508a381b04SJed Brown PetscErrorCode ierr; 5518a381b04SJed Brown ARKTableauLink link; 5528a381b04SJed Brown ARKTableau t; 5538a381b04SJed Brown PetscInt i,j; 5548a381b04SJed Brown 5558a381b04SJed Brown PetscFunctionBegin; 5561795a4d1SJed Brown ierr = PetscCalloc1(1,&link);CHKERRQ(ierr); 5578a381b04SJed Brown t = &link->tab; 5588a381b04SJed Brown ierr = PetscStrallocpy(name,&t->name);CHKERRQ(ierr); 5598a381b04SJed Brown t->order = order; 5608a381b04SJed Brown t->s = s; 561dcca6d9dSJed Brown ierr = PetscMalloc6(s*s,&t->At,s,&t->bt,s,&t->ct,s*s,&t->A,s,&t->b,s,&t->c);CHKERRQ(ierr); 5628a381b04SJed Brown ierr = PetscMemcpy(t->At,At,s*s*sizeof(At[0]));CHKERRQ(ierr); 5638a381b04SJed Brown ierr = PetscMemcpy(t->A,A,s*s*sizeof(A[0]));CHKERRQ(ierr); 5648a381b04SJed Brown if (bt) { ierr = PetscMemcpy(t->bt,bt,s*sizeof(bt[0]));CHKERRQ(ierr); } 5658a381b04SJed Brown else for (i=0; i<s; i++) t->bt[i] = At[(s-1)*s+i]; 5668a381b04SJed Brown if (b) { ierr = PetscMemcpy(t->b,b,s*sizeof(b[0]));CHKERRQ(ierr); } 5675dceddf7SDebojyoti Ghosh else for (i=0; i<s; i++) t->b[i] = t->bt[i]; 5688a381b04SJed Brown if (ct) { ierr = PetscMemcpy(t->ct,ct,s*sizeof(ct[0]));CHKERRQ(ierr); } 5698a381b04SJed Brown else for (i=0; i<s; i++) for (j=0,t->ct[i]=0; j<s; j++) t->ct[i] += At[i*s+j]; 5708a381b04SJed Brown if (c) { ierr = PetscMemcpy(t->c,c,s*sizeof(c[0]));CHKERRQ(ierr); } 5718a381b04SJed Brown else for (i=0; i<s; i++) for (j=0,t->c[i]=0; j<s; j++) t->c[i] += A[i*s+j]; 572e817cc15SEmil Constantinescu t->stiffly_accurate = PETSC_TRUE; 573e817cc15SEmil Constantinescu for (i=0; i<s; i++) if (t->At[(s-1)*s+i] != t->bt[i]) t->stiffly_accurate = PETSC_FALSE; 574e817cc15SEmil Constantinescu t->explicit_first_stage = PETSC_TRUE; 575e817cc15SEmil Constantinescu for (i=0; i<s; i++) if (t->At[i] != 0.0) t->explicit_first_stage = PETSC_FALSE; 576e817cc15SEmil Constantinescu /*def of FSAL can be made more precise*/ 5774e9d4bf5SJed Brown t->FSAL_implicit = (PetscBool)(t->explicit_first_stage && t->stiffly_accurate); 578108c343cSJed Brown if (bembedt) { 579dcca6d9dSJed Brown ierr = PetscMalloc2(s,&t->bembedt,s,&t->bembed);CHKERRQ(ierr); 580108c343cSJed Brown ierr = PetscMemcpy(t->bembedt,bembedt,s*sizeof(bembedt[0]));CHKERRQ(ierr); 581108c343cSJed Brown ierr = PetscMemcpy(t->bembed,bembed ? bembed : bembedt,s*sizeof(bembed[0]));CHKERRQ(ierr); 582108c343cSJed Brown } 583108c343cSJed Brown 5844f385281SJed Brown t->pinterp = pinterp; 585dcca6d9dSJed Brown ierr = PetscMalloc2(s*pinterp,&t->binterpt,s*pinterp,&t->binterp);CHKERRQ(ierr); 586cd652676SJed Brown ierr = PetscMemcpy(t->binterpt,binterpt,s*pinterp*sizeof(binterpt[0]));CHKERRQ(ierr); 587cd652676SJed Brown ierr = PetscMemcpy(t->binterp,binterp ? binterp : binterpt,s*pinterp*sizeof(binterpt[0]));CHKERRQ(ierr); 5888a381b04SJed Brown link->next = ARKTableauList; 5898a381b04SJed Brown ARKTableauList = link; 5908a381b04SJed Brown PetscFunctionReturn(0); 5918a381b04SJed Brown } 5928a381b04SJed Brown 5938a381b04SJed Brown #undef __FUNCT__ 594108c343cSJed Brown #define __FUNCT__ "TSEvaluateStep_ARKIMEX" 595108c343cSJed Brown /* 596108c343cSJed Brown The step completion formula is 597108c343cSJed Brown 598108c343cSJed Brown x1 = x0 - h bt^T YdotI + h b^T YdotRHS 599108c343cSJed Brown 600108c343cSJed Brown This function can be called before or after ts->vec_sol has been updated. 601108c343cSJed Brown Suppose we have a completion formula (bt,b) and an embedded formula (bet,be) of different order. 602108c343cSJed Brown We can write 603108c343cSJed Brown 604108c343cSJed Brown x1e = x0 - h bet^T YdotI + h be^T YdotRHS 605108c343cSJed Brown = x1 + h bt^T YdotI - h b^T YdotRHS - h bet^T YdotI + h be^T YdotRHS 606108c343cSJed Brown = x1 - h (bet - bt)^T YdotI + h (be - b)^T YdotRHS 607108c343cSJed Brown 608108c343cSJed Brown so we can evaluate the method with different order even after the step has been optimistically completed. 609108c343cSJed Brown */ 610108c343cSJed Brown static PetscErrorCode TSEvaluateStep_ARKIMEX(TS ts,PetscInt order,Vec X,PetscBool *done) 611108c343cSJed Brown { 612108c343cSJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 613108c343cSJed Brown ARKTableau tab = ark->tableau; 614108c343cSJed Brown PetscScalar *w = ark->work; 615108c343cSJed Brown PetscReal h; 616108c343cSJed Brown PetscInt s = tab->s,j; 617108c343cSJed Brown PetscErrorCode ierr; 618108c343cSJed Brown 619108c343cSJed Brown PetscFunctionBegin; 620108c343cSJed Brown switch (ark->status) { 621108c343cSJed Brown case TS_STEP_INCOMPLETE: 622108c343cSJed Brown case TS_STEP_PENDING: 623108c343cSJed Brown h = ts->time_step; break; 624108c343cSJed Brown case TS_STEP_COMPLETE: 625108c343cSJed Brown h = ts->time_step_prev; break; 626ce94432eSBarry Smith default: SETERRQ(PetscObjectComm((PetscObject)ts),PETSC_ERR_PLIB,"Invalid TSStepStatus"); 627108c343cSJed Brown } 628108c343cSJed Brown if (order == tab->order) { 629e817cc15SEmil Constantinescu if (ark->status == TS_STEP_INCOMPLETE) { 630740132f1SEmil Constantinescu if (!ark->imex && tab->stiffly_accurate) { /* Only the stiffly accurate implicit formula is used */ 631e817cc15SEmil Constantinescu ierr = VecCopy(ark->Y[s-1],X);CHKERRQ(ierr); 632e817cc15SEmil Constantinescu } else { /* Use the standard completion formula (bt,b) */ 633108c343cSJed Brown ierr = VecCopy(ts->vec_sol,X);CHKERRQ(ierr); 634e817cc15SEmil Constantinescu for (j=0; j<s; j++) w[j] = h*tab->bt[j]; 635108c343cSJed Brown ierr = VecMAXPY(X,s,w,ark->YdotI);CHKERRQ(ierr); 636e817cc15SEmil Constantinescu if (ark->imex) { /* Method is IMEX, complete the explicit formula */ 637108c343cSJed Brown for (j=0; j<s; j++) w[j] = h*tab->b[j]; 638108c343cSJed Brown ierr = VecMAXPY(X,s,w,ark->YdotRHS);CHKERRQ(ierr); 639e817cc15SEmil Constantinescu } 640e817cc15SEmil Constantinescu } 641108c343cSJed Brown } else {ierr = VecCopy(ts->vec_sol,X);CHKERRQ(ierr);} 642108c343cSJed Brown if (done) *done = PETSC_TRUE; 643108c343cSJed Brown PetscFunctionReturn(0); 644108c343cSJed Brown } else if (order == tab->order-1) { 645108c343cSJed Brown if (!tab->bembedt) goto unavailable; 646108c343cSJed Brown if (ark->status == TS_STEP_INCOMPLETE) { /* Complete with the embedded method (bet,be) */ 647108c343cSJed Brown ierr = VecCopy(ts->vec_sol,X);CHKERRQ(ierr); 648e817cc15SEmil Constantinescu for (j=0; j<s; j++) w[j] = h*tab->bembedt[j]; 649108c343cSJed Brown ierr = VecMAXPY(X,s,w,ark->YdotI);CHKERRQ(ierr); 650108c343cSJed Brown for (j=0; j<s; j++) w[j] = h*tab->bembed[j]; 651108c343cSJed Brown ierr = VecMAXPY(X,s,w,ark->YdotRHS);CHKERRQ(ierr); 652108c343cSJed Brown } else { /* Rollback and re-complete using (bet-be,be-b) */ 653108c343cSJed Brown ierr = VecCopy(ts->vec_sol,X);CHKERRQ(ierr); 654e817cc15SEmil Constantinescu for (j=0; j<s; j++) w[j] = h*(tab->bembedt[j] - tab->bt[j]); 655108c343cSJed Brown ierr = VecMAXPY(X,tab->s,w,ark->YdotI);CHKERRQ(ierr); 656108c343cSJed Brown for (j=0; j<s; j++) w[j] = h*(tab->bembed[j] - tab->b[j]); 657108c343cSJed Brown ierr = VecMAXPY(X,s,w,ark->YdotRHS);CHKERRQ(ierr); 658108c343cSJed Brown } 659108c343cSJed Brown if (done) *done = PETSC_TRUE; 660108c343cSJed Brown PetscFunctionReturn(0); 661108c343cSJed Brown } 662108c343cSJed Brown unavailable: 663108c343cSJed Brown if (done) *done = PETSC_FALSE; 664ce94432eSBarry Smith else SETERRQ3(PetscObjectComm((PetscObject)ts),PETSC_ERR_SUP,"ARKIMEX '%s' of order %D cannot evaluate step at order %D",tab->name,tab->order,order); 665108c343cSJed Brown PetscFunctionReturn(0); 666108c343cSJed Brown } 667108c343cSJed Brown 668108c343cSJed Brown #undef __FUNCT__ 66924655328SShri #define __FUNCT__ "TSRollBack_ARKIMEX" 67024655328SShri static PetscErrorCode TSRollBack_ARKIMEX(TS ts) 67124655328SShri { 67224655328SShri TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 67324655328SShri ARKTableau tab = ark->tableau; 67424655328SShri const PetscInt s = tab->s; 67524655328SShri const PetscReal *bt = tab->bt,*b = tab->b; 67624655328SShri PetscScalar *w = ark->work; 67724655328SShri Vec *YdotI = ark->YdotI,*YdotRHS = ark->YdotRHS; 67824655328SShri PetscInt j; 67924655328SShri PetscReal h=ts->time_step; 68024655328SShri PetscErrorCode ierr; 68124655328SShri 68224655328SShri PetscFunctionBegin; 68324655328SShri for (j=0; j<s; j++) w[j] = -h*bt[j]; 68424655328SShri ierr = VecMAXPY(ts->vec_sol,s,w,YdotI);CHKERRQ(ierr); 68524655328SShri for (j=0; j<s; j++) w[j] = -h*b[j]; 68624655328SShri ierr = VecMAXPY(ts->vec_sol,s,w,YdotRHS);CHKERRQ(ierr); 68724655328SShri ark->status = TS_STEP_INCOMPLETE; 68824655328SShri PetscFunctionReturn(0); 68924655328SShri } 69024655328SShri 69124655328SShri #undef __FUNCT__ 6928a381b04SJed Brown #define __FUNCT__ "TSStep_ARKIMEX" 6938a381b04SJed Brown static PetscErrorCode TSStep_ARKIMEX(TS ts) 6948a381b04SJed Brown { 6958a381b04SJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 6968a381b04SJed Brown ARKTableau tab = ark->tableau; 6978a381b04SJed Brown const PetscInt s = tab->s; 69824655328SShri const PetscReal *At = tab->At,*A = tab->A,*ct = tab->ct,*c = tab->c; 699406d0ec2SJed Brown PetscScalar *w = ark->work; 700e817cc15SEmil Constantinescu Vec *Y = ark->Y,*YdotI = ark->YdotI,*YdotRHS = ark->YdotRHS,Ydot = ark->Ydot,Ydot0 = ark->Ydot0,W = ark->Work,Z = ark->Z; 70156dcabbaSDebojyoti Ghosh PetscBool init_guess_extrp = ark->init_guess_extrp; 702108c343cSJed Brown TSAdapt adapt; 7038a381b04SJed Brown SNES snes; 704108c343cSJed Brown PetscInt i,j,its,lits,reject,next_scheme; 705108c343cSJed Brown PetscReal t; 70624655328SShri PetscReal next_time_step; 707108c343cSJed Brown PetscBool accept; 7088a381b04SJed Brown PetscErrorCode ierr; 7098a381b04SJed Brown 7108a381b04SJed Brown PetscFunctionBegin; 711e817cc15SEmil Constantinescu if (ts->equation_type >= TS_EQ_IMPLICIT && tab->explicit_first_stage) { 712e817cc15SEmil Constantinescu PetscReal valid_time; 713e817cc15SEmil Constantinescu PetscBool isvalid; 71460427346SBarry Smith ierr = PetscObjectComposedDataGetReal((PetscObject)ts->vec_sol,explicit_stage_time_id,valid_time,isvalid);CHKERRQ(ierr); 715e817cc15SEmil Constantinescu if (!isvalid || valid_time != ts->ptime) { 716e817cc15SEmil Constantinescu TS ts_start; 71719436ca2SJed Brown 718*e5168f73SEmil Constantinescu ierr = TSClone(PetscObjectComm((PetscObject)ts),ts,&ts_start);CHKERRQ(ierr); 719bbd56ea5SKarl Rupp 720e817cc15SEmil Constantinescu ierr = TSSetSolution(ts_start,ts->vec_sol);CHKERRQ(ierr); 721e817cc15SEmil Constantinescu ierr = TSSetTime(ts_start,ts->ptime);CHKERRQ(ierr); 722eb082435SEmil Constantinescu ierr = TSSetDuration(ts_start,1,ts->ptime+ts->time_step);CHKERRQ(ierr); 723740132f1SEmil Constantinescu ierr = TSSetTimeStep(ts_start,ts->time_step);CHKERRQ(ierr); 724e817cc15SEmil Constantinescu ierr = TSSetType(ts_start,TSARKIMEX);CHKERRQ(ierr); 725740132f1SEmil Constantinescu ierr = TSARKIMEXSetFullyImplicit(ts_start,PETSC_TRUE);CHKERRQ(ierr); 726e817cc15SEmil Constantinescu ierr = TSARKIMEXSetType(ts_start,TSARKIMEX1BEE);CHKERRQ(ierr); 72734561852SEmil Constantinescu 728e817cc15SEmil Constantinescu ierr = TSSolve(ts_start,ts->vec_sol);CHKERRQ(ierr); 729e817cc15SEmil Constantinescu ierr = TSGetTime(ts_start,&ts->ptime);CHKERRQ(ierr); 730bbd56ea5SKarl Rupp 731740132f1SEmil Constantinescu ts->time_step = ts_start->time_step; 732740132f1SEmil Constantinescu ts->steps++; 733e817cc15SEmil Constantinescu ierr = VecCopy(((TS_ARKIMEX*)ts_start->data)->Ydot0,Ydot0);CHKERRQ(ierr); 73434561852SEmil Constantinescu 735*e5168f73SEmil Constantinescu //PetscInt cnt; 736*e5168f73SEmil Constantinescu //PetscObjectGetReference((PetscObject)ts->snes,&cnt); 737*e5168f73SEmil Constantinescu //printf("Ref count: %d\n",cnt); 73834561852SEmil Constantinescu 739*e5168f73SEmil Constantinescu /*I don't understand why this needs to be here*/ 740*e5168f73SEmil Constantinescu SNES snes_dup=NULL; 741*e5168f73SEmil Constantinescu ierr = TSGetSNES(ts,&snes_dup);CHKERRQ(ierr); 742*e5168f73SEmil Constantinescu ts_start->snes=NULL; 743*e5168f73SEmil Constantinescu ierr = TSSetSNES(ts,snes_dup);CHKERRQ(ierr); 744*e5168f73SEmil Constantinescu ierr = SNESDestroy(&snes_dup);CHKERRQ(ierr); 745*e5168f73SEmil Constantinescu /* END */ 746*e5168f73SEmil Constantinescu ierr = TSDestroy(&ts_start);CHKERRQ(ierr); 747e817cc15SEmil Constantinescu } 748e817cc15SEmil Constantinescu } 749e817cc15SEmil Constantinescu 7508a381b04SJed Brown ierr = TSGetSNES(ts,&snes);CHKERRQ(ierr); 7518a381b04SJed Brown t = ts->ptime; 75224655328SShri next_time_step = ts->time_step; 753108c343cSJed Brown accept = PETSC_TRUE; 754108c343cSJed Brown ark->status = TS_STEP_INCOMPLETE; 7558a381b04SJed Brown 756e817cc15SEmil Constantinescu 75797335746SJed Brown for (reject=0; reject<ts->max_reject && !ts->reason; reject++,ts->reject++) { 758108c343cSJed Brown PetscReal h = ts->time_step; 759b8123daeSJed Brown ierr = TSPreStep(ts);CHKERRQ(ierr); 7608a381b04SJed Brown for (i=0; i<s; i++) { 7619be3e283SDebojyoti Ghosh ark->stage_time = t + h*ct[i]; 7628a381b04SJed Brown if (At[i*s+i] == 0) { /* This stage is explicit */ 763c58d1302SEmil Constantinescu if(i!=0 && ts->equation_type>=TS_EQ_IMPLICIT){ 764c58d1302SEmil Constantinescu /* Throw error: "Explicit stages other than the first one are not supported for implicit problems" */ 765c58d1302SEmil Constantinescu } 7668a381b04SJed Brown ierr = VecCopy(ts->vec_sol,Y[i]);CHKERRQ(ierr); 767e817cc15SEmil Constantinescu for (j=0; j<i; j++) w[j] = h*At[i*s+j]; 7688a381b04SJed Brown ierr = VecMAXPY(Y[i],i,w,YdotI);CHKERRQ(ierr); 7698a381b04SJed Brown for (j=0; j<i; j++) w[j] = h*A[i*s+j]; 7708a381b04SJed Brown ierr = VecMAXPY(Y[i],i,w,YdotRHS);CHKERRQ(ierr); 7718a381b04SJed Brown } else { 772b296d7d5SJed Brown ark->scoeff = 1./At[i*s+i]; 773b8123daeSJed Brown ierr = TSPreStage(ts,ark->stage_time);CHKERRQ(ierr); 7748a381b04SJed Brown /* Affine part */ 7758a381b04SJed Brown ierr = VecZeroEntries(W);CHKERRQ(ierr); 776c58d1302SEmil Constantinescu /*for (j=0; j<i; j++) w[j] = h*A[i*s+j]; 7778a381b04SJed Brown ierr = VecMAXPY(W,i,w,YdotRHS);CHKERRQ(ierr); 778c58d1302SEmil Constantinescu ierr = VecScale(W, ark->scoeff/h);CHKERRQ(ierr);*/ 779f16577ceSEmil Constantinescu 7808a381b04SJed Brown /* Ydot = shift*(Y-Z) */ 7818a381b04SJed Brown ierr = VecCopy(ts->vec_sol,Z);CHKERRQ(ierr); 782e817cc15SEmil Constantinescu for (j=0; j<i; j++) w[j] = h*At[i*s+j]; 7834f385281SJed Brown ierr = VecMAXPY(Z,i,w,YdotI);CHKERRQ(ierr); 784c58d1302SEmil Constantinescu for (j=0; j<i; j++) w[j] = h*A[i*s+j]; 785c58d1302SEmil Constantinescu ierr = VecMAXPY(Z,i,w,YdotRHS);CHKERRQ(ierr); 786f16577ceSEmil Constantinescu 7879eef816dSJed Brown if (init_guess_extrp && ark->prev_step_valid) { 78856dcabbaSDebojyoti Ghosh /* Initial guess extrapolated from previous time step stage values */ 78956dcabbaSDebojyoti Ghosh ierr = TSExtrapolate_ARKIMEX(ts,c[i],Y[i]);CHKERRQ(ierr); 79056dcabbaSDebojyoti Ghosh } else { 7918a381b04SJed Brown /* Initial guess taken from last stage */ 7928a381b04SJed Brown ierr = VecCopy(i>0 ? Y[i-1] : ts->vec_sol,Y[i]);CHKERRQ(ierr); 79356dcabbaSDebojyoti Ghosh } 7948a381b04SJed Brown ierr = SNESSolve(snes,W,Y[i]);CHKERRQ(ierr); 7958a381b04SJed Brown ierr = SNESGetIterationNumber(snes,&its);CHKERRQ(ierr); 7968a381b04SJed Brown ierr = SNESGetLinearSolveIterations(snes,&lits);CHKERRQ(ierr); 7975ef26d82SJed Brown ts->snes_its += its; ts->ksp_its += lits; 798552698daSJed Brown ierr = TSGetAdapt(ts,&adapt);CHKERRQ(ierr); 79997335746SJed Brown ierr = TSAdaptCheckStage(adapt,ts,&accept);CHKERRQ(ierr); 8001be93e3eSJed Brown if (!accept) { 8011be93e3eSJed Brown /* We are likely rejecting the step because of solver or function domain problems so we should not attempt to 8021be93e3eSJed Brown * use extrapolation to initialize the solves on the next attempt. */ 8031be93e3eSJed Brown ark->prev_step_valid = PETSC_FALSE; 8041be93e3eSJed Brown goto reject_step; 8051be93e3eSJed Brown } 8068a381b04SJed Brown } 8079be3e283SDebojyoti Ghosh ierr = TSPostStage(ts,ark->stage_time,i,Y); CHKERRQ(ierr); 808e817cc15SEmil Constantinescu if (ts->equation_type>=TS_EQ_IMPLICIT) { 809e817cc15SEmil Constantinescu if (i==0 && tab->explicit_first_stage) { 810e817cc15SEmil Constantinescu ierr = VecCopy(Ydot0,YdotI[0]);CHKERRQ(ierr); 811e817cc15SEmil Constantinescu } else { 812e817cc15SEmil Constantinescu ierr = VecAXPBYPCZ(YdotI[i],-ark->scoeff/h,ark->scoeff/h,0,Z,Y[i]);CHKERRQ(ierr); /* Ydot = shift*(X-Z) */ 813e817cc15SEmil Constantinescu } 814e817cc15SEmil Constantinescu } else { 8158a381b04SJed Brown ierr = VecZeroEntries(Ydot);CHKERRQ(ierr); 8164cc180ffSJed Brown ierr = TSComputeIFunction(ts,t+h*ct[i],Y[i],Ydot,YdotI[i],ark->imex);CHKERRQ(ierr); 817e817cc15SEmil Constantinescu ierr = VecScale(YdotI[i], -1.0);CHKERRQ(ierr); 8184cc180ffSJed Brown if (ark->imex) { 8198a381b04SJed Brown ierr = TSComputeRHSFunction(ts,t+h*c[i],Y[i],YdotRHS[i]);CHKERRQ(ierr); 8204cc180ffSJed Brown } else { 8214cc180ffSJed Brown ierr = VecZeroEntries(YdotRHS[i]);CHKERRQ(ierr); 8224cc180ffSJed Brown } 8238a381b04SJed Brown } 824e817cc15SEmil Constantinescu } 8250298fd71SBarry Smith ierr = TSEvaluateStep(ts,tab->order,ts->vec_sol,NULL);CHKERRQ(ierr); 826108c343cSJed Brown ark->status = TS_STEP_PENDING; 8278a381b04SJed Brown 828108c343cSJed Brown /* Register only the current method as a candidate because we're not supporting multiple candidates yet. */ 829552698daSJed Brown ierr = TSGetAdapt(ts,&adapt);CHKERRQ(ierr); 830108c343cSJed Brown ierr = TSAdaptCandidatesClear(adapt);CHKERRQ(ierr); 831108c343cSJed Brown ierr = TSAdaptCandidateAdd(adapt,tab->name,tab->order,1,tab->ccfl,1.*tab->s,PETSC_TRUE);CHKERRQ(ierr); 832108c343cSJed Brown ierr = TSAdaptChoose(adapt,ts,ts->time_step,&next_scheme,&next_time_step,&accept);CHKERRQ(ierr); 833108c343cSJed Brown if (accept) { 834108c343cSJed Brown /* ignore next_scheme for now */ 8358a381b04SJed Brown ts->ptime += ts->time_step; 836cdbf8f93SLisandro Dalcin ts->time_step = next_time_step; 8378a381b04SJed Brown ts->steps++; 838e817cc15SEmil Constantinescu if (ts->equation_type>=TS_EQ_IMPLICIT) { /* save the initial slope for the next step*/ 839e817cc15SEmil Constantinescu ierr = VecCopy(YdotI[s-1],Ydot0);CHKERRQ(ierr); 840e817cc15SEmil Constantinescu } 841108c343cSJed Brown ark->status = TS_STEP_COMPLETE; 842e817cc15SEmil Constantinescu if (tab->explicit_first_stage) { 843e817cc15SEmil Constantinescu ierr = PetscObjectComposedDataSetReal((PetscObject)ts->vec_sol,explicit_stage_time_id,ts->ptime);CHKERRQ(ierr); 844e817cc15SEmil Constantinescu } 84564b5d2f7SDebojyoti Ghosh /* Save the Y, YdotI, YdotRHS for extrapolation initial guess */ 84664b5d2f7SDebojyoti Ghosh if (ark->init_guess_extrp) { 84764b5d2f7SDebojyoti Ghosh for (i = 0; i<s; i++) { 84864b5d2f7SDebojyoti Ghosh ierr = VecCopy(Y[i],ark->Y_prev[i]);CHKERRQ(ierr); 84964b5d2f7SDebojyoti Ghosh ierr = VecCopy(YdotRHS[i],ark->YdotRHS_prev[i]);CHKERRQ(ierr); 85064b5d2f7SDebojyoti Ghosh ierr = VecCopy(YdotI[i],ark->YdotI_prev[i]);CHKERRQ(ierr); 85164b5d2f7SDebojyoti Ghosh } 8529eef816dSJed Brown ark->prev_step_valid = PETSC_TRUE; 85364b5d2f7SDebojyoti Ghosh } 854108c343cSJed Brown break; 855108c343cSJed Brown } else { /* Roll back the current step */ 85624655328SShri ts->ptime += next_time_step; /* This will be undone in rollback */ 857108c343cSJed Brown ark->status = TS_STEP_INCOMPLETE; 85824655328SShri ierr = TSRollBack(ts);CHKERRQ(ierr); 859108c343cSJed Brown } 860476b6736SJed Brown reject_step: continue; 861108c343cSJed Brown } 862b2ce242eSJed Brown if (ark->status != TS_STEP_COMPLETE && !ts->reason) ts->reason = TS_DIVERGED_STEP_REJECTED; 8638a381b04SJed Brown PetscFunctionReturn(0); 8648a381b04SJed Brown } 8658a381b04SJed Brown 866cd652676SJed Brown #undef __FUNCT__ 867cd652676SJed Brown #define __FUNCT__ "TSInterpolate_ARKIMEX" 868cd652676SJed Brown static PetscErrorCode TSInterpolate_ARKIMEX(TS ts,PetscReal itime,Vec X) 869cd652676SJed Brown { 870cd652676SJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 8714f385281SJed Brown PetscInt s = ark->tableau->s,pinterp = ark->tableau->pinterp,i,j; 872108c343cSJed Brown PetscReal h; 873108c343cSJed Brown PetscReal tt,t; 874cd652676SJed Brown PetscScalar *bt,*b; 875cd652676SJed Brown const PetscReal *Bt = ark->tableau->binterpt,*B = ark->tableau->binterp; 876cd652676SJed Brown PetscErrorCode ierr; 877cd652676SJed Brown 878cd652676SJed Brown PetscFunctionBegin; 879ce94432eSBarry Smith if (!Bt || !B) SETERRQ1(PetscObjectComm((PetscObject)ts),PETSC_ERR_SUP,"TSARKIMEX %s does not have an interpolation formula",ark->tableau->name); 880108c343cSJed Brown switch (ark->status) { 881108c343cSJed Brown case TS_STEP_INCOMPLETE: 882108c343cSJed Brown case TS_STEP_PENDING: 883108c343cSJed Brown h = ts->time_step; 884108c343cSJed Brown t = (itime - ts->ptime)/h; 885108c343cSJed Brown break; 886108c343cSJed Brown case TS_STEP_COMPLETE: 887108c343cSJed Brown h = ts->time_step_prev; 888108c343cSJed Brown t = (itime - ts->ptime)/h + 1; /* In the interval [0,1] */ 889108c343cSJed Brown break; 890ce94432eSBarry Smith default: SETERRQ(PetscObjectComm((PetscObject)ts),PETSC_ERR_PLIB,"Invalid TSStepStatus"); 891108c343cSJed Brown } 892dcca6d9dSJed Brown ierr = PetscMalloc2(s,&bt,s,&b);CHKERRQ(ierr); 893cd652676SJed Brown for (i=0; i<s; i++) bt[i] = b[i] = 0; 8944f385281SJed Brown for (j=0,tt=t; j<pinterp; j++,tt*=t) { 895cd652676SJed Brown for (i=0; i<s; i++) { 896c1758d98SDebojyoti Ghosh bt[i] += h * Bt[i*pinterp+j] * tt; 897108c343cSJed Brown b[i] += h * B[i*pinterp+j] * tt; 898cd652676SJed Brown } 899cd652676SJed Brown } 900cd652676SJed Brown ierr = VecCopy(ark->Y[0],X);CHKERRQ(ierr); 901cd652676SJed Brown ierr = VecMAXPY(X,s,bt,ark->YdotI);CHKERRQ(ierr); 902cd652676SJed Brown ierr = VecMAXPY(X,s,b,ark->YdotRHS);CHKERRQ(ierr); 903cd652676SJed Brown ierr = PetscFree2(bt,b);CHKERRQ(ierr); 904cd652676SJed Brown PetscFunctionReturn(0); 905cd652676SJed Brown } 906cd652676SJed Brown 90756dcabbaSDebojyoti Ghosh #undef __FUNCT__ 90856dcabbaSDebojyoti Ghosh #define __FUNCT__ "TSExtrapolate_ARKIMEX" 90956dcabbaSDebojyoti Ghosh static PetscErrorCode TSExtrapolate_ARKIMEX(TS ts,PetscReal c,Vec X) 91056dcabbaSDebojyoti Ghosh { 91156dcabbaSDebojyoti Ghosh TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 91256dcabbaSDebojyoti Ghosh PetscInt s = ark->tableau->s,pinterp = ark->tableau->pinterp,i,j; 91356dcabbaSDebojyoti Ghosh PetscReal h; 91456dcabbaSDebojyoti Ghosh PetscReal tt,t; 91556dcabbaSDebojyoti Ghosh PetscScalar *bt,*b; 91656dcabbaSDebojyoti Ghosh const PetscReal *Bt = ark->tableau->binterpt,*B = ark->tableau->binterp; 91756dcabbaSDebojyoti Ghosh PetscErrorCode ierr; 91856dcabbaSDebojyoti Ghosh 91956dcabbaSDebojyoti Ghosh PetscFunctionBegin; 92056dcabbaSDebojyoti Ghosh if (!Bt || !B) SETERRQ1(PetscObjectComm((PetscObject)ts),PETSC_ERR_SUP,"TSARKIMEX %s does not have an interpolation formula",ark->tableau->name); 92156dcabbaSDebojyoti Ghosh t = 1.0 + (ts->time_step/ts->time_step_prev)*c; 92281d12688SDebojyoti Ghosh h = ts->time_step; 923dcca6d9dSJed Brown ierr = PetscMalloc2(s,&bt,s,&b);CHKERRQ(ierr); 92456dcabbaSDebojyoti Ghosh for (i=0; i<s; i++) bt[i] = b[i] = 0; 92556dcabbaSDebojyoti Ghosh for (j=0,tt=t; j<pinterp; j++,tt*=t) { 92656dcabbaSDebojyoti Ghosh for (i=0; i<s; i++) { 92781d12688SDebojyoti Ghosh bt[i] += h * Bt[i*pinterp+j] * tt; 92856dcabbaSDebojyoti Ghosh b[i] += h * B[i*pinterp+j] * tt; 92956dcabbaSDebojyoti Ghosh } 93056dcabbaSDebojyoti Ghosh } 9319eef816dSJed Brown if (!ark->prev_step_valid) SETERRQ(PetscObjectComm((PetscObject)ts),PETSC_ERR_SUP,"Stages from previous step have not been stored"); 93256dcabbaSDebojyoti Ghosh ierr = VecCopy(ark->Y_prev[0],X);CHKERRQ(ierr); 93356dcabbaSDebojyoti Ghosh ierr = VecMAXPY(X,s,bt,ark->YdotI_prev);CHKERRQ(ierr); 93456dcabbaSDebojyoti Ghosh ierr = VecMAXPY(X,s,b,ark->YdotRHS_prev);CHKERRQ(ierr); 93556dcabbaSDebojyoti Ghosh ierr = PetscFree2(bt,b);CHKERRQ(ierr); 93656dcabbaSDebojyoti Ghosh PetscFunctionReturn(0); 93756dcabbaSDebojyoti Ghosh } 93856dcabbaSDebojyoti Ghosh 9398a381b04SJed Brown /*------------------------------------------------------------*/ 9408a381b04SJed Brown #undef __FUNCT__ 9418a381b04SJed Brown #define __FUNCT__ "TSReset_ARKIMEX" 9428a381b04SJed Brown static PetscErrorCode TSReset_ARKIMEX(TS ts) 9438a381b04SJed Brown { 9448a381b04SJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 9458a381b04SJed Brown PetscInt s; 9468a381b04SJed Brown PetscErrorCode ierr; 9478a381b04SJed Brown 9488a381b04SJed Brown PetscFunctionBegin; 9498a381b04SJed Brown if (!ark->tableau) PetscFunctionReturn(0); 9508a381b04SJed Brown s = ark->tableau->s; 9518a381b04SJed Brown ierr = VecDestroyVecs(s,&ark->Y);CHKERRQ(ierr); 9528a381b04SJed Brown ierr = VecDestroyVecs(s,&ark->YdotI);CHKERRQ(ierr); 9538a381b04SJed Brown ierr = VecDestroyVecs(s,&ark->YdotRHS);CHKERRQ(ierr); 9540bf495dbSBarry Smith if (ark->init_guess_extrp) { 95556dcabbaSDebojyoti Ghosh ierr = VecDestroyVecs(s,&ark->Y_prev);CHKERRQ(ierr); 95656dcabbaSDebojyoti Ghosh ierr = VecDestroyVecs(s,&ark->YdotI_prev);CHKERRQ(ierr); 95756dcabbaSDebojyoti Ghosh ierr = VecDestroyVecs(s,&ark->YdotRHS_prev);CHKERRQ(ierr); 95856dcabbaSDebojyoti Ghosh } 9598a381b04SJed Brown ierr = VecDestroy(&ark->Ydot);CHKERRQ(ierr); 9608a381b04SJed Brown ierr = VecDestroy(&ark->Work);CHKERRQ(ierr); 961e817cc15SEmil Constantinescu ierr = VecDestroy(&ark->Ydot0);CHKERRQ(ierr); 9628a381b04SJed Brown ierr = VecDestroy(&ark->Z);CHKERRQ(ierr); 9638a381b04SJed Brown ierr = PetscFree(ark->work);CHKERRQ(ierr); 9648a381b04SJed Brown PetscFunctionReturn(0); 9658a381b04SJed Brown } 9668a381b04SJed Brown 9678a381b04SJed Brown #undef __FUNCT__ 9688a381b04SJed Brown #define __FUNCT__ "TSDestroy_ARKIMEX" 9698a381b04SJed Brown static PetscErrorCode TSDestroy_ARKIMEX(TS ts) 9708a381b04SJed Brown { 9718a381b04SJed Brown PetscErrorCode ierr; 9728a381b04SJed Brown 9738a381b04SJed Brown PetscFunctionBegin; 9748a381b04SJed Brown ierr = TSReset_ARKIMEX(ts);CHKERRQ(ierr); 9758a381b04SJed Brown ierr = PetscFree(ts->data);CHKERRQ(ierr); 976bdf89e91SBarry Smith ierr = PetscObjectComposeFunction((PetscObject)ts,"TSARKIMEXGetType_C",NULL);CHKERRQ(ierr); 977bdf89e91SBarry Smith ierr = PetscObjectComposeFunction((PetscObject)ts,"TSARKIMEXSetType_C",NULL);CHKERRQ(ierr); 978bdf89e91SBarry Smith ierr = PetscObjectComposeFunction((PetscObject)ts,"TSARKIMEXSetFullyImplicit_C",NULL);CHKERRQ(ierr); 9798a381b04SJed Brown PetscFunctionReturn(0); 9808a381b04SJed Brown } 9818a381b04SJed Brown 982d5e6173cSPeter Brune 983d5e6173cSPeter Brune #undef __FUNCT__ 984d5e6173cSPeter Brune #define __FUNCT__ "TSARKIMEXGetVecs" 985d5e6173cSPeter Brune static PetscErrorCode TSARKIMEXGetVecs(TS ts,DM dm,Vec *Z,Vec *Ydot) 986d5e6173cSPeter Brune { 987d5e6173cSPeter Brune TS_ARKIMEX *ax = (TS_ARKIMEX*)ts->data; 988d5e6173cSPeter Brune PetscErrorCode ierr; 989d5e6173cSPeter Brune 990d5e6173cSPeter Brune PetscFunctionBegin; 991d5e6173cSPeter Brune if (Z) { 992d5e6173cSPeter Brune if (dm && dm != ts->dm) { 993d5e6173cSPeter Brune ierr = DMGetNamedGlobalVector(dm,"TSARKIMEX_Z",Z);CHKERRQ(ierr); 994d5e6173cSPeter Brune } else *Z = ax->Z; 995d5e6173cSPeter Brune } 996d5e6173cSPeter Brune if (Ydot) { 997d5e6173cSPeter Brune if (dm && dm != ts->dm) { 998d5e6173cSPeter Brune ierr = DMGetNamedGlobalVector(dm,"TSARKIMEX_Ydot",Ydot);CHKERRQ(ierr); 999d5e6173cSPeter Brune } else *Ydot = ax->Ydot; 1000d5e6173cSPeter Brune } 1001d5e6173cSPeter Brune PetscFunctionReturn(0); 1002d5e6173cSPeter Brune } 1003d5e6173cSPeter Brune 1004d5e6173cSPeter Brune 1005d5e6173cSPeter Brune #undef __FUNCT__ 1006d5e6173cSPeter Brune #define __FUNCT__ "TSARKIMEXRestoreVecs" 1007d5e6173cSPeter Brune static PetscErrorCode TSARKIMEXRestoreVecs(TS ts,DM dm,Vec *Z,Vec *Ydot) 1008d5e6173cSPeter Brune { 1009d5e6173cSPeter Brune PetscErrorCode ierr; 1010d5e6173cSPeter Brune 1011d5e6173cSPeter Brune PetscFunctionBegin; 1012d5e6173cSPeter Brune if (Z) { 1013d5e6173cSPeter Brune if (dm && dm != ts->dm) { 1014d5e6173cSPeter Brune ierr = DMRestoreNamedGlobalVector(dm,"TSARKIMEX_Z",Z);CHKERRQ(ierr); 1015d5e6173cSPeter Brune } 1016d5e6173cSPeter Brune } 1017d5e6173cSPeter Brune if (Ydot) { 1018d5e6173cSPeter Brune if (dm && dm != ts->dm) { 1019d5e6173cSPeter Brune ierr = DMRestoreNamedGlobalVector(dm,"TSARKIMEX_Ydot",Ydot);CHKERRQ(ierr); 1020d5e6173cSPeter Brune } 1021d5e6173cSPeter Brune } 1022d5e6173cSPeter Brune PetscFunctionReturn(0); 1023d5e6173cSPeter Brune } 1024d5e6173cSPeter Brune 10258a381b04SJed Brown /* 10268a381b04SJed Brown This defines the nonlinear equation that is to be solved with SNES 10278a381b04SJed Brown G(U) = F[t0+Theta*dt, U, (U-U0)*shift] = 0 10288a381b04SJed Brown */ 10298a381b04SJed Brown #undef __FUNCT__ 10308a381b04SJed Brown #define __FUNCT__ "SNESTSFormFunction_ARKIMEX" 10318a381b04SJed Brown static PetscErrorCode SNESTSFormFunction_ARKIMEX(SNES snes,Vec X,Vec F,TS ts) 10328a381b04SJed Brown { 10338a381b04SJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 1034d5e6173cSPeter Brune DM dm,dmsave; 1035d5e6173cSPeter Brune Vec Z,Ydot; 1036b296d7d5SJed Brown PetscReal shift = ark->scoeff / ts->time_step; 10378a381b04SJed Brown PetscErrorCode ierr; 10388a381b04SJed Brown 10398a381b04SJed Brown PetscFunctionBegin; 1040d5e6173cSPeter Brune ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); 1041d5e6173cSPeter Brune ierr = TSARKIMEXGetVecs(ts,dm,&Z,&Ydot);CHKERRQ(ierr); 1042b296d7d5SJed Brown ierr = VecAXPBYPCZ(Ydot,-shift,shift,0,Z,X);CHKERRQ(ierr); /* Ydot = shift*(X-Z) */ 1043d5e6173cSPeter Brune dmsave = ts->dm; 1044d5e6173cSPeter Brune ts->dm = dm; 1045740132f1SEmil Constantinescu 1046d5e6173cSPeter Brune ierr = TSComputeIFunction(ts,ark->stage_time,X,Ydot,F,ark->imex);CHKERRQ(ierr); 1047e817cc15SEmil Constantinescu 1048d5e6173cSPeter Brune ts->dm = dmsave; 1049d5e6173cSPeter Brune ierr = TSARKIMEXRestoreVecs(ts,dm,&Z,&Ydot);CHKERRQ(ierr); 10508a381b04SJed Brown PetscFunctionReturn(0); 10518a381b04SJed Brown } 10528a381b04SJed Brown 10538a381b04SJed Brown #undef __FUNCT__ 10548a381b04SJed Brown #define __FUNCT__ "SNESTSFormJacobian_ARKIMEX" 1055d1e9a80fSBarry Smith static PetscErrorCode SNESTSFormJacobian_ARKIMEX(SNES snes,Vec X,Mat A,Mat B,TS ts) 10568a381b04SJed Brown { 10578a381b04SJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 1058d5e6173cSPeter Brune DM dm,dmsave; 1059d5e6173cSPeter Brune Vec Ydot; 1060b296d7d5SJed Brown PetscReal shift = ark->scoeff / ts->time_step; 10618a381b04SJed Brown PetscErrorCode ierr; 10628a381b04SJed Brown 10638a381b04SJed Brown PetscFunctionBegin; 1064d5e6173cSPeter Brune ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); 10650298fd71SBarry Smith ierr = TSARKIMEXGetVecs(ts,dm,NULL,&Ydot);CHKERRQ(ierr); 10668a381b04SJed Brown /* ark->Ydot has already been computed in SNESTSFormFunction_ARKIMEX (SNES guarantees this) */ 1067d5e6173cSPeter Brune dmsave = ts->dm; 1068d5e6173cSPeter Brune ts->dm = dm; 1069740132f1SEmil Constantinescu 1070d1e9a80fSBarry Smith ierr = TSComputeIJacobian(ts,ark->stage_time,X,Ydot,shift,A,B,ark->imex);CHKERRQ(ierr); 1071740132f1SEmil Constantinescu 1072d5e6173cSPeter Brune ts->dm = dmsave; 10730298fd71SBarry Smith ierr = TSARKIMEXRestoreVecs(ts,dm,NULL,&Ydot);CHKERRQ(ierr); 1074d5e6173cSPeter Brune PetscFunctionReturn(0); 1075d5e6173cSPeter Brune } 1076d5e6173cSPeter Brune 1077d5e6173cSPeter Brune #undef __FUNCT__ 1078d5e6173cSPeter Brune #define __FUNCT__ "DMCoarsenHook_TSARKIMEX" 1079d5e6173cSPeter Brune static PetscErrorCode DMCoarsenHook_TSARKIMEX(DM fine,DM coarse,void *ctx) 1080d5e6173cSPeter Brune { 1081d5e6173cSPeter Brune PetscFunctionBegin; 1082d5e6173cSPeter Brune PetscFunctionReturn(0); 1083d5e6173cSPeter Brune } 1084d5e6173cSPeter Brune 1085d5e6173cSPeter Brune #undef __FUNCT__ 1086d5e6173cSPeter Brune #define __FUNCT__ "DMRestrictHook_TSARKIMEX" 1087d5e6173cSPeter Brune static PetscErrorCode DMRestrictHook_TSARKIMEX(DM fine,Mat restrct,Vec rscale,Mat inject,DM coarse,void *ctx) 1088d5e6173cSPeter Brune { 1089d5e6173cSPeter Brune TS ts = (TS)ctx; 1090d5e6173cSPeter Brune PetscErrorCode ierr; 1091d5e6173cSPeter Brune Vec Z,Z_c; 1092d5e6173cSPeter Brune 1093d5e6173cSPeter Brune PetscFunctionBegin; 10940298fd71SBarry Smith ierr = TSARKIMEXGetVecs(ts,fine,&Z,NULL);CHKERRQ(ierr); 10950298fd71SBarry Smith ierr = TSARKIMEXGetVecs(ts,coarse,&Z_c,NULL);CHKERRQ(ierr); 1096d5e6173cSPeter Brune ierr = MatRestrict(restrct,Z,Z_c);CHKERRQ(ierr); 1097d5e6173cSPeter Brune ierr = VecPointwiseMult(Z_c,rscale,Z_c);CHKERRQ(ierr); 10980298fd71SBarry Smith ierr = TSARKIMEXRestoreVecs(ts,fine,&Z,NULL);CHKERRQ(ierr); 10990298fd71SBarry Smith ierr = TSARKIMEXRestoreVecs(ts,coarse,&Z_c,NULL);CHKERRQ(ierr); 11008a381b04SJed Brown PetscFunctionReturn(0); 11018a381b04SJed Brown } 11028a381b04SJed Brown 1103cdb298fcSPeter Brune 1104cdb298fcSPeter Brune #undef __FUNCT__ 1105cdb298fcSPeter Brune #define __FUNCT__ "DMSubDomainHook_TSARKIMEX" 1106cdb298fcSPeter Brune static PetscErrorCode DMSubDomainHook_TSARKIMEX(DM dm,DM subdm,void *ctx) 1107cdb298fcSPeter Brune { 1108cdb298fcSPeter Brune PetscFunctionBegin; 1109cdb298fcSPeter Brune PetscFunctionReturn(0); 1110cdb298fcSPeter Brune } 1111cdb298fcSPeter Brune 1112cdb298fcSPeter Brune #undef __FUNCT__ 1113cdb298fcSPeter Brune #define __FUNCT__ "DMSubDomainRestrictHook_TSARKIMEX" 1114cdb298fcSPeter Brune static PetscErrorCode DMSubDomainRestrictHook_TSARKIMEX(DM dm,VecScatter gscat,VecScatter lscat,DM subdm,void *ctx) 1115cdb298fcSPeter Brune { 1116cdb298fcSPeter Brune TS ts = (TS)ctx; 1117cdb298fcSPeter Brune PetscErrorCode ierr; 1118cdb298fcSPeter Brune Vec Z,Z_c; 1119cdb298fcSPeter Brune 1120cdb298fcSPeter Brune PetscFunctionBegin; 11210298fd71SBarry Smith ierr = TSARKIMEXGetVecs(ts,dm,&Z,NULL);CHKERRQ(ierr); 11220298fd71SBarry Smith ierr = TSARKIMEXGetVecs(ts,subdm,&Z_c,NULL);CHKERRQ(ierr); 1123cdb298fcSPeter Brune 1124cdb298fcSPeter Brune ierr = VecScatterBegin(gscat,Z,Z_c,INSERT_VALUES,SCATTER_FORWARD);CHKERRQ(ierr); 1125cdb298fcSPeter Brune ierr = VecScatterEnd(gscat,Z,Z_c,INSERT_VALUES,SCATTER_FORWARD);CHKERRQ(ierr); 1126cdb298fcSPeter Brune 11270298fd71SBarry Smith ierr = TSARKIMEXRestoreVecs(ts,dm,&Z,NULL);CHKERRQ(ierr); 11280298fd71SBarry Smith ierr = TSARKIMEXRestoreVecs(ts,subdm,&Z_c,NULL);CHKERRQ(ierr); 1129cdb298fcSPeter Brune PetscFunctionReturn(0); 1130cdb298fcSPeter Brune } 1131cdb298fcSPeter Brune 11328a381b04SJed Brown #undef __FUNCT__ 11338a381b04SJed Brown #define __FUNCT__ "TSSetUp_ARKIMEX" 11348a381b04SJed Brown static PetscErrorCode TSSetUp_ARKIMEX(TS ts) 11358a381b04SJed Brown { 11368a381b04SJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 1137f2c2a1b9SBarry Smith ARKTableau tab; 1138f2c2a1b9SBarry Smith PetscInt s; 11398a381b04SJed Brown PetscErrorCode ierr; 1140d5e6173cSPeter Brune DM dm; 1141f9c1d6abSBarry Smith 11428a381b04SJed Brown PetscFunctionBegin; 11438a381b04SJed Brown if (!ark->tableau) { 1144e24355feSJed Brown ierr = TSARKIMEXSetType(ts,TSARKIMEXDefault);CHKERRQ(ierr); 11458a381b04SJed Brown } 1146f2c2a1b9SBarry Smith tab = ark->tableau; 1147f2c2a1b9SBarry Smith s = tab->s; 11488a381b04SJed Brown ierr = VecDuplicateVecs(ts->vec_sol,s,&ark->Y);CHKERRQ(ierr); 11498a381b04SJed Brown ierr = VecDuplicateVecs(ts->vec_sol,s,&ark->YdotI);CHKERRQ(ierr); 11508a381b04SJed Brown ierr = VecDuplicateVecs(ts->vec_sol,s,&ark->YdotRHS);CHKERRQ(ierr); 115156dcabbaSDebojyoti Ghosh if (ark->init_guess_extrp) { 115256dcabbaSDebojyoti Ghosh ierr = VecDuplicateVecs(ts->vec_sol,s,&ark->Y_prev);CHKERRQ(ierr); 115356dcabbaSDebojyoti Ghosh ierr = VecDuplicateVecs(ts->vec_sol,s,&ark->YdotI_prev);CHKERRQ(ierr); 115456dcabbaSDebojyoti Ghosh ierr = VecDuplicateVecs(ts->vec_sol,s,&ark->YdotRHS_prev);CHKERRQ(ierr); 115556dcabbaSDebojyoti Ghosh } 11568a381b04SJed Brown ierr = VecDuplicate(ts->vec_sol,&ark->Ydot);CHKERRQ(ierr); 11578a381b04SJed Brown ierr = VecDuplicate(ts->vec_sol,&ark->Work);CHKERRQ(ierr); 1158e817cc15SEmil Constantinescu ierr = VecDuplicate(ts->vec_sol,&ark->Ydot0);CHKERRQ(ierr); 11598a381b04SJed Brown ierr = VecDuplicate(ts->vec_sol,&ark->Z);CHKERRQ(ierr); 1160785e854fSJed Brown ierr = PetscMalloc1(s,&ark->work);CHKERRQ(ierr); 1161d5e6173cSPeter Brune ierr = TSGetDM(ts,&dm);CHKERRQ(ierr); 1162d5e6173cSPeter Brune if (dm) { 1163d5e6173cSPeter Brune ierr = DMCoarsenHookAdd(dm,DMCoarsenHook_TSARKIMEX,DMRestrictHook_TSARKIMEX,ts);CHKERRQ(ierr); 1164cdb298fcSPeter Brune ierr = DMSubDomainHookAdd(dm,DMSubDomainHook_TSARKIMEX,DMSubDomainRestrictHook_TSARKIMEX,ts);CHKERRQ(ierr); 1165d5e6173cSPeter Brune } 11668a381b04SJed Brown PetscFunctionReturn(0); 11678a381b04SJed Brown } 11688a381b04SJed Brown /*------------------------------------------------------------*/ 11698a381b04SJed Brown 11708a381b04SJed Brown #undef __FUNCT__ 11718a381b04SJed Brown #define __FUNCT__ "TSSetFromOptions_ARKIMEX" 11728c34d3f5SBarry Smith static PetscErrorCode TSSetFromOptions_ARKIMEX(PetscOptions *PetscOptionsObject,TS ts) 11738a381b04SJed Brown { 11744cc180ffSJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 11758a381b04SJed Brown PetscErrorCode ierr; 11768a381b04SJed Brown char arktype[256]; 11778a381b04SJed Brown 11788a381b04SJed Brown PetscFunctionBegin; 1179e55864a3SBarry Smith ierr = PetscOptionsHead(PetscOptionsObject,"ARKIMEX ODE solver options");CHKERRQ(ierr); 11808a381b04SJed Brown { 11818a381b04SJed Brown ARKTableauLink link; 11828a381b04SJed Brown PetscInt count,choice; 11838a381b04SJed Brown PetscBool flg; 11848a381b04SJed Brown const char **namelist; 11858caf3d72SBarry Smith ierr = PetscStrncpy(arktype,TSARKIMEXDefault,sizeof(arktype));CHKERRQ(ierr); 11868a381b04SJed Brown for (link=ARKTableauList,count=0; link; link=link->next,count++) ; 1187785e854fSJed Brown ierr = PetscMalloc1(count,&namelist);CHKERRQ(ierr); 11888a381b04SJed Brown for (link=ARKTableauList,count=0; link; link=link->next,count++) namelist[count] = link->tab.name; 11898a381b04SJed Brown ierr = PetscOptionsEList("-ts_arkimex_type","Family of ARK IMEX method","TSARKIMEXSetType",(const char*const*)namelist,count,arktype,&choice,&flg);CHKERRQ(ierr); 11908a381b04SJed Brown ierr = TSARKIMEXSetType(ts,flg ? namelist[choice] : arktype);CHKERRQ(ierr); 11918a381b04SJed Brown ierr = PetscFree(namelist);CHKERRQ(ierr); 11924cc180ffSJed Brown flg = (PetscBool) !ark->imex; 11930298fd71SBarry Smith ierr = PetscOptionsBool("-ts_arkimex_fully_implicit","Solve the problem fully implicitly","TSARKIMEXSetFullyImplicit",flg,&flg,NULL);CHKERRQ(ierr); 11944cc180ffSJed Brown ark->imex = (PetscBool) !flg; 119556dcabbaSDebojyoti Ghosh ark->init_guess_extrp = PETSC_FALSE; 119656dcabbaSDebojyoti Ghosh ierr = PetscOptionsBool("-ts_arkimex_initial_guess_extrapolate","Extrapolate the initial guess for the stage solution from stage values of the previous time step","",ark->init_guess_extrp,&ark->init_guess_extrp,NULL);CHKERRQ(ierr); 11978a381b04SJed Brown } 11988a381b04SJed Brown ierr = PetscOptionsTail();CHKERRQ(ierr); 11998a381b04SJed Brown PetscFunctionReturn(0); 12008a381b04SJed Brown } 12018a381b04SJed Brown 12028a381b04SJed Brown #undef __FUNCT__ 12038a381b04SJed Brown #define __FUNCT__ "PetscFormatRealArray" 12048a381b04SJed Brown static PetscErrorCode PetscFormatRealArray(char buf[],size_t len,const char *fmt,PetscInt n,const PetscReal x[]) 12058a381b04SJed Brown { 1206257d2499SJed Brown PetscErrorCode ierr; 1207f1d86077SJed Brown PetscInt i; 1208f1d86077SJed Brown size_t left,count; 12098a381b04SJed Brown char *p; 12108a381b04SJed Brown 12118a381b04SJed Brown PetscFunctionBegin; 1212f1d86077SJed Brown for (i=0,p=buf,left=len; i<n; i++) { 1213f1d86077SJed Brown ierr = PetscSNPrintfCount(p,left,fmt,&count,x[i]);CHKERRQ(ierr); 12148a381b04SJed Brown if (count >= left) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Insufficient space in buffer"); 12158a381b04SJed Brown left -= count; 12168a381b04SJed Brown p += count; 12178a381b04SJed Brown *p++ = ' '; 12188a381b04SJed Brown } 12198a381b04SJed Brown p[i ? 0 : -1] = 0; 12208a381b04SJed Brown PetscFunctionReturn(0); 12218a381b04SJed Brown } 12228a381b04SJed Brown 12238a381b04SJed Brown #undef __FUNCT__ 12248a381b04SJed Brown #define __FUNCT__ "TSView_ARKIMEX" 12258a381b04SJed Brown static PetscErrorCode TSView_ARKIMEX(TS ts,PetscViewer viewer) 12268a381b04SJed Brown { 12278a381b04SJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 12288a381b04SJed Brown ARKTableau tab = ark->tableau; 12298a381b04SJed Brown PetscBool iascii; 12308a381b04SJed Brown PetscErrorCode ierr; 1231559eea31SJed Brown TSAdapt adapt; 12328a381b04SJed Brown 12338a381b04SJed Brown PetscFunctionBegin; 1234251f4c67SDmitry Karpeev ierr = PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERASCII,&iascii);CHKERRQ(ierr); 12358a381b04SJed Brown if (iascii) { 123619fd82e9SBarry Smith TSARKIMEXType arktype; 12378a381b04SJed Brown char buf[512]; 12388a381b04SJed Brown ierr = TSARKIMEXGetType(ts,&arktype);CHKERRQ(ierr); 12398a381b04SJed Brown ierr = PetscViewerASCIIPrintf(viewer," ARK IMEX %s\n",arktype);CHKERRQ(ierr); 12408caf3d72SBarry Smith ierr = PetscFormatRealArray(buf,sizeof(buf),"% 8.6f",tab->s,tab->ct);CHKERRQ(ierr); 124131f6fcc0SJed Brown ierr = PetscViewerASCIIPrintf(viewer," Stiff abscissa ct = %s\n",buf);CHKERRQ(ierr); 12428caf3d72SBarry Smith ierr = PetscFormatRealArray(buf,sizeof(buf),"% 8.6f",tab->s,tab->c);CHKERRQ(ierr); 1243e817cc15SEmil Constantinescu ierr = PetscViewerASCIIPrintf(viewer,"Stiffly accurate: %s\n",tab->stiffly_accurate ? "yes" : "no");CHKERRQ(ierr); 1244e817cc15SEmil Constantinescu ierr = PetscViewerASCIIPrintf(viewer,"Explicit first stage: %s\n",tab->explicit_first_stage ? "yes" : "no");CHKERRQ(ierr); 1245e817cc15SEmil Constantinescu ierr = PetscViewerASCIIPrintf(viewer,"FSAL property: %s\n",tab->FSAL_implicit ? "yes" : "no");CHKERRQ(ierr); 124631f6fcc0SJed Brown ierr = PetscViewerASCIIPrintf(viewer," Nonstiff abscissa c = %s\n",buf);CHKERRQ(ierr); 12478a381b04SJed Brown } 1248552698daSJed Brown ierr = TSGetAdapt(ts,&adapt);CHKERRQ(ierr); 1249559eea31SJed Brown ierr = TSAdaptView(adapt,viewer);CHKERRQ(ierr); 1250d52bd9f3SBarry Smith ierr = SNESView(ts->snes,viewer);CHKERRQ(ierr); 12518a381b04SJed Brown PetscFunctionReturn(0); 12528a381b04SJed Brown } 12538a381b04SJed Brown 12548a381b04SJed Brown #undef __FUNCT__ 1255f2c2a1b9SBarry Smith #define __FUNCT__ "TSLoad_ARKIMEX" 1256f2c2a1b9SBarry Smith static PetscErrorCode TSLoad_ARKIMEX(TS ts,PetscViewer viewer) 1257f2c2a1b9SBarry Smith { 1258f2c2a1b9SBarry Smith PetscErrorCode ierr; 1259f2c2a1b9SBarry Smith SNES snes; 1260ad6bc421SBarry Smith TSAdapt tsadapt; 1261f2c2a1b9SBarry Smith 1262f2c2a1b9SBarry Smith PetscFunctionBegin; 1263552698daSJed Brown ierr = TSGetAdapt(ts,&tsadapt);CHKERRQ(ierr); 1264ad6bc421SBarry Smith ierr = TSAdaptLoad(tsadapt,viewer);CHKERRQ(ierr); 1265f2c2a1b9SBarry Smith ierr = TSGetSNES(ts,&snes);CHKERRQ(ierr); 1266f2c2a1b9SBarry Smith ierr = SNESLoad(snes,viewer);CHKERRQ(ierr); 1267ad6bc421SBarry Smith /* function and Jacobian context for SNES when used with TS is always ts object */ 12680298fd71SBarry Smith ierr = SNESSetFunction(snes,NULL,NULL,ts);CHKERRQ(ierr); 12690298fd71SBarry Smith ierr = SNESSetJacobian(snes,NULL,NULL,NULL,ts);CHKERRQ(ierr); 1270f2c2a1b9SBarry Smith PetscFunctionReturn(0); 1271f2c2a1b9SBarry Smith } 1272f2c2a1b9SBarry Smith 1273f2c2a1b9SBarry Smith #undef __FUNCT__ 12748a381b04SJed Brown #define __FUNCT__ "TSARKIMEXSetType" 12758a381b04SJed Brown /*@C 12768a381b04SJed Brown TSARKIMEXSetType - Set the type of ARK IMEX scheme 12778a381b04SJed Brown 12788a381b04SJed Brown Logically collective 12798a381b04SJed Brown 12808a381b04SJed Brown Input Parameter: 12818a381b04SJed Brown + ts - timestepping context 12828a381b04SJed Brown - arktype - type of ARK-IMEX scheme 12838a381b04SJed Brown 12848a381b04SJed Brown Level: intermediate 12858a381b04SJed Brown 1286020d8f30SJed Brown .seealso: TSARKIMEXGetType(), TSARKIMEX, TSARKIMEX2D, TSARKIMEX2E, TSARKIMEXPRSSP2, TSARKIMEX3, TSARKIMEXBPR3, TSARKIMEXARS443, TSARKIMEX4, TSARKIMEX5 12878a381b04SJed Brown @*/ 128819fd82e9SBarry Smith PetscErrorCode TSARKIMEXSetType(TS ts,TSARKIMEXType arktype) 12898a381b04SJed Brown { 12908a381b04SJed Brown PetscErrorCode ierr; 12918a381b04SJed Brown 12928a381b04SJed Brown PetscFunctionBegin; 12938a381b04SJed Brown PetscValidHeaderSpecific(ts,TS_CLASSID,1); 129419fd82e9SBarry Smith ierr = PetscTryMethod(ts,"TSARKIMEXSetType_C",(TS,TSARKIMEXType),(ts,arktype));CHKERRQ(ierr); 12958a381b04SJed Brown PetscFunctionReturn(0); 12968a381b04SJed Brown } 12978a381b04SJed Brown 12988a381b04SJed Brown #undef __FUNCT__ 12998a381b04SJed Brown #define __FUNCT__ "TSARKIMEXGetType" 13008a381b04SJed Brown /*@C 13018a381b04SJed Brown TSARKIMEXGetType - Get the type of ARK IMEX scheme 13028a381b04SJed Brown 13038a381b04SJed Brown Logically collective 13048a381b04SJed Brown 13058a381b04SJed Brown Input Parameter: 13068a381b04SJed Brown . ts - timestepping context 13078a381b04SJed Brown 13088a381b04SJed Brown Output Parameter: 13098a381b04SJed Brown . arktype - type of ARK-IMEX scheme 13108a381b04SJed Brown 13118a381b04SJed Brown Level: intermediate 13128a381b04SJed Brown 13138a381b04SJed Brown .seealso: TSARKIMEXGetType() 13148a381b04SJed Brown @*/ 131519fd82e9SBarry Smith PetscErrorCode TSARKIMEXGetType(TS ts,TSARKIMEXType *arktype) 13168a381b04SJed Brown { 13178a381b04SJed Brown PetscErrorCode ierr; 13188a381b04SJed Brown 13198a381b04SJed Brown PetscFunctionBegin; 13208a381b04SJed Brown PetscValidHeaderSpecific(ts,TS_CLASSID,1); 132119fd82e9SBarry Smith ierr = PetscUseMethod(ts,"TSARKIMEXGetType_C",(TS,TSARKIMEXType*),(ts,arktype));CHKERRQ(ierr); 13228a381b04SJed Brown PetscFunctionReturn(0); 13238a381b04SJed Brown } 13248a381b04SJed Brown 13254cc180ffSJed Brown #undef __FUNCT__ 13264cc180ffSJed Brown #define __FUNCT__ "TSARKIMEXSetFullyImplicit" 13274cc180ffSJed Brown /*@C 13284cc180ffSJed Brown TSARKIMEXSetFullyImplicit - Solve both parts of the equation implicitly 13294cc180ffSJed Brown 13304cc180ffSJed Brown Logically collective 13314cc180ffSJed Brown 13324cc180ffSJed Brown Input Parameter: 13334cc180ffSJed Brown + ts - timestepping context 13344cc180ffSJed Brown - flg - PETSC_TRUE for fully implicit 13354cc180ffSJed Brown 13364cc180ffSJed Brown Level: intermediate 13374cc180ffSJed Brown 13384cc180ffSJed Brown .seealso: TSARKIMEXGetType() 13394cc180ffSJed Brown @*/ 13404cc180ffSJed Brown PetscErrorCode TSARKIMEXSetFullyImplicit(TS ts,PetscBool flg) 13414cc180ffSJed Brown { 13424cc180ffSJed Brown PetscErrorCode ierr; 13434cc180ffSJed Brown 13444cc180ffSJed Brown PetscFunctionBegin; 13454cc180ffSJed Brown PetscValidHeaderSpecific(ts,TS_CLASSID,1); 13464cc180ffSJed Brown ierr = PetscTryMethod(ts,"TSARKIMEXSetFullyImplicit_C",(TS,PetscBool),(ts,flg));CHKERRQ(ierr); 13474cc180ffSJed Brown PetscFunctionReturn(0); 13484cc180ffSJed Brown } 13494cc180ffSJed Brown 13508a381b04SJed Brown #undef __FUNCT__ 13518a381b04SJed Brown #define __FUNCT__ "TSARKIMEXGetType_ARKIMEX" 135219fd82e9SBarry Smith PetscErrorCode TSARKIMEXGetType_ARKIMEX(TS ts,TSARKIMEXType *arktype) 13538a381b04SJed Brown { 13548a381b04SJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 13558a381b04SJed Brown PetscErrorCode ierr; 13568a381b04SJed Brown 13578a381b04SJed Brown PetscFunctionBegin; 1358f2c2a1b9SBarry Smith if (!ark->tableau) { 1359f2c2a1b9SBarry Smith ierr = TSARKIMEXSetType(ts,TSARKIMEXDefault);CHKERRQ(ierr); 1360f2c2a1b9SBarry Smith } 13618a381b04SJed Brown *arktype = ark->tableau->name; 13628a381b04SJed Brown PetscFunctionReturn(0); 13638a381b04SJed Brown } 13648a381b04SJed Brown #undef __FUNCT__ 13658a381b04SJed Brown #define __FUNCT__ "TSARKIMEXSetType_ARKIMEX" 136619fd82e9SBarry Smith PetscErrorCode TSARKIMEXSetType_ARKIMEX(TS ts,TSARKIMEXType arktype) 13678a381b04SJed Brown { 13688a381b04SJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 13698a381b04SJed Brown PetscErrorCode ierr; 13708a381b04SJed Brown PetscBool match; 13718a381b04SJed Brown ARKTableauLink link; 13728a381b04SJed Brown 13738a381b04SJed Brown PetscFunctionBegin; 13748a381b04SJed Brown if (ark->tableau) { 13758a381b04SJed Brown ierr = PetscStrcmp(ark->tableau->name,arktype,&match);CHKERRQ(ierr); 13768a381b04SJed Brown if (match) PetscFunctionReturn(0); 13778a381b04SJed Brown } 13788a381b04SJed Brown for (link = ARKTableauList; link; link=link->next) { 13798a381b04SJed Brown ierr = PetscStrcmp(link->tab.name,arktype,&match);CHKERRQ(ierr); 13808a381b04SJed Brown if (match) { 13818a381b04SJed Brown ierr = TSReset_ARKIMEX(ts);CHKERRQ(ierr); 13828a381b04SJed Brown ark->tableau = &link->tab; 13838a381b04SJed Brown PetscFunctionReturn(0); 13848a381b04SJed Brown } 13858a381b04SJed Brown } 1386ce94432eSBarry Smith SETERRQ1(PetscObjectComm((PetscObject)ts),PETSC_ERR_ARG_UNKNOWN_TYPE,"Could not find '%s'",arktype); 13878a381b04SJed Brown PetscFunctionReturn(0); 13888a381b04SJed Brown } 13894cc180ffSJed Brown #undef __FUNCT__ 13904cc180ffSJed Brown #define __FUNCT__ "TSARKIMEXSetFullyImplicit_ARKIMEX" 13914cc180ffSJed Brown PetscErrorCode TSARKIMEXSetFullyImplicit_ARKIMEX(TS ts,PetscBool flg) 13924cc180ffSJed Brown { 13934cc180ffSJed Brown TS_ARKIMEX *ark = (TS_ARKIMEX*)ts->data; 13944cc180ffSJed Brown 13954cc180ffSJed Brown PetscFunctionBegin; 13964cc180ffSJed Brown ark->imex = (PetscBool)!flg; 13974cc180ffSJed Brown PetscFunctionReturn(0); 13984cc180ffSJed Brown } 13998a381b04SJed Brown 14008a381b04SJed Brown /* ------------------------------------------------------------ */ 14018a381b04SJed Brown /*MC 1402a4386c9eSJed Brown TSARKIMEX - ODE and DAE solver using Additive Runge-Kutta IMEX schemes 14038a381b04SJed Brown 1404fca742c7SJed Brown These methods are intended for problems with well-separated time scales, especially when a slow scale is strongly 1405fca742c7SJed Brown nonlinear such that it is expensive to solve with a fully implicit method. The user should provide the stiff part 1406fca742c7SJed Brown of the equation using TSSetIFunction() and the non-stiff part with TSSetRHSFunction(). 1407fca742c7SJed Brown 1408fca742c7SJed Brown Notes: 1409a4386c9eSJed Brown The default is TSARKIMEX3, it can be changed with TSARKIMEXSetType() or -ts_arkimex_type 1410c8058688SBarry Smith 1411a4386c9eSJed Brown Methods with an explicit stage can only be used with ODE in which the stiff part G(t,X,Xdot) has the form Xdot + Ghat(t,X). 1412fca742c7SJed Brown 1413d0685a90SJed Brown Consider trying TSROSW if the stiff part is linear or weakly nonlinear. 1414d0685a90SJed Brown 14158a381b04SJed Brown Level: beginner 14168a381b04SJed Brown 1417d0685a90SJed Brown .seealso: TSCreate(), TS, TSSetType(), TSARKIMEXSetType(), TSARKIMEXGetType(), TSARKIMEXSetFullyImplicit(), TSARKIMEX1BEE, 1418d0685a90SJed Brown TSARKIMEX2C, TSARKIMEX2D, TSARKIMEX2E, TSARKIMEX3, TSARKIMEXL2, TSARKIMEXA2, TSARKIMEXARS122, 1419d0685a90SJed Brown TSARKIMEX4, TSARKIMEX5, TSARKIMEXPRSSP2, TSARKIMEXARS443, TSARKIMEXBPR3, TSARKIMEXType, TSARKIMEXRegister() 14208a381b04SJed Brown 14218a381b04SJed Brown M*/ 14228a381b04SJed Brown #undef __FUNCT__ 14238a381b04SJed Brown #define __FUNCT__ "TSCreate_ARKIMEX" 14248cc058d9SJed Brown PETSC_EXTERN PetscErrorCode TSCreate_ARKIMEX(TS ts) 14258a381b04SJed Brown { 14268a381b04SJed Brown TS_ARKIMEX *th; 14278a381b04SJed Brown PetscErrorCode ierr; 14288a381b04SJed Brown 14298a381b04SJed Brown PetscFunctionBegin; 1430607a6623SBarry Smith ierr = TSARKIMEXInitializePackage();CHKERRQ(ierr); 14318a381b04SJed Brown 14328a381b04SJed Brown ts->ops->reset = TSReset_ARKIMEX; 14338a381b04SJed Brown ts->ops->destroy = TSDestroy_ARKIMEX; 14348a381b04SJed Brown ts->ops->view = TSView_ARKIMEX; 1435f2c2a1b9SBarry Smith ts->ops->load = TSLoad_ARKIMEX; 14368a381b04SJed Brown ts->ops->setup = TSSetUp_ARKIMEX; 14378a381b04SJed Brown ts->ops->step = TSStep_ARKIMEX; 1438cd652676SJed Brown ts->ops->interpolate = TSInterpolate_ARKIMEX; 1439108c343cSJed Brown ts->ops->evaluatestep = TSEvaluateStep_ARKIMEX; 144024655328SShri ts->ops->rollback = TSRollBack_ARKIMEX; 14418a381b04SJed Brown ts->ops->setfromoptions = TSSetFromOptions_ARKIMEX; 14428a381b04SJed Brown ts->ops->snesfunction = SNESTSFormFunction_ARKIMEX; 14438a381b04SJed Brown ts->ops->snesjacobian = SNESTSFormJacobian_ARKIMEX; 14448a381b04SJed Brown 1445b00a9115SJed Brown ierr = PetscNewLog(ts,&th);CHKERRQ(ierr); 14468a381b04SJed Brown ts->data = (void*)th; 14474cc180ffSJed Brown th->imex = PETSC_TRUE; 14488a381b04SJed Brown 1449bdf89e91SBarry Smith ierr = PetscObjectComposeFunction((PetscObject)ts,"TSARKIMEXGetType_C",TSARKIMEXGetType_ARKIMEX);CHKERRQ(ierr); 1450bdf89e91SBarry Smith ierr = PetscObjectComposeFunction((PetscObject)ts,"TSARKIMEXSetType_C",TSARKIMEXSetType_ARKIMEX);CHKERRQ(ierr); 1451bdf89e91SBarry Smith ierr = PetscObjectComposeFunction((PetscObject)ts,"TSARKIMEXSetFullyImplicit_C",TSARKIMEXSetFullyImplicit_ARKIMEX);CHKERRQ(ierr); 14528a381b04SJed Brown PetscFunctionReturn(0); 14538a381b04SJed Brown } 1454