! $Id: user_coupler.F90,v 1.19 2011/06/30 06:00:33 theurich Exp $ ! ! Example/test code which shows User Component calls. !------------------------------------------------------------------------- !------------------------------------------------------------------------- ! ! !DESCRIPTION: ! User-supplied Coupler ! ! !\begin{verbatim} module user_coupler ! ESMF Framework module use ESMF implicit none public usercpl_setvm, usercpl_register ! global data type(ESMF_RouteHandle), save :: routehandle contains !------------------------------------------------------------------------- ! ! The Register routine sets the subroutines to be called ! ! as the init, run, and finalize routines. Note that these are ! ! private to the module. subroutine usercpl_setvm(comp, rc) type(ESMF_CplComp) :: comp integer, intent(out) :: rc #ifdef ESMF_TESTWITHTHREADS type(ESMF_VM) :: vm logical :: pthreadsEnabled #endif ! Initialize return code rc = ESMF_SUCCESS #ifdef ESMF_TESTWITHTHREADS ! The following call will turn on ESMF-threading (single threaded) ! for this component. If you are using this file as a template for ! your own code development you probably don't want to include the ! following call unless you are interested in exploring ESMF's ! threading features. ! First test whether ESMF-threading is supported on this machine call ESMF_VMGetGlobal(vm, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out call ESMF_VMGet(vm, pthreadsEnabledFlag=pthreadsEnabled, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out if (pthreadsEnabled) then call ESMF_CplCompSetVMMinThreads(comp, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out endif #endif end subroutine subroutine usercpl_register(comp, rc) type(ESMF_CplComp) :: comp integer, intent(out) :: rc ! Initialize return code rc = ESMF_SUCCESS print *, "User Coupler Register starting" ! Register the callback routines. call ESMF_CplCompSetEntryPoint(comp, ESMF_METHOD_INITIALIZE, userRoutine=user_init, & rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out call ESMF_CplCompSetEntryPoint(comp, ESMF_METHOD_RUN, userRoutine=user_run, & rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out call ESMF_CplCompSetEntryPoint(comp, ESMF_METHOD_FINALIZE, userRoutine=user_final, & rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out print *, "Registered Initialize, Run, and Finalize routines" print *, "User Coupler Register returning" end subroutine !------------------------------------------------------------------------- ! !User Comp Component created by higher level calls, here is the ! ! Initialization routine. subroutine user_init(comp, importState, exportState, clock, rc) type(ESMF_CplComp) :: comp type(ESMF_State) :: importState, exportState type(ESMF_Clock) :: clock integer, intent(out) :: rc ! Local variables integer :: itemcount, localPet type(ESMF_Array) :: srcArray, dstArray type(ESMF_VM) :: vm real(ESMF_KIND_R8):: factorList(10000) integer:: i, factorIndexList(2,10000) ! Initialize return code rc = ESMF_SUCCESS print *, "User Coupler Init starting" call ESMF_StateGet(importState, itemcount=itemcount, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out print *, "Import State contains ", itemcount, " items." ! Need to reconcile import and export states call ESMF_CplCompGet(comp, vm=vm, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out call ESMF_StateReconcile(importState, vm=vm, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out call ESMF_StateReconcile(exportState, vm=vm, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out ! Get source Array out of import state call ESMF_StateGet(importState, "array data", srcArray, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out ! Get destination Array out of export state call ESMF_StateGet(exportState, "array data", dstArray, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out ! get localPet call ESMF_VMGet(vm, localPet=localPet, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out ! Setup identity sparse matrix as a combination of PET 0 and PET 4 ! there are 15000 elements on the diagonal, defined as two overlapping ! lists of each 10000 elements (overlapping 5000). if (localPet==0) then factorIndexList(1,:) = (/(i,i=1,10000)/) factorIndexList(2,:) = factorIndexList(1,:) do i=1, 5000 factorList(i) = 1.d0 enddo do i=5001, 10000 factorList(i) = .253d0 enddo endif if (localPet==4) then factorIndexList(1,:) = (/(i,i=5001,15000)/) factorIndexList(2,:) = factorIndexList(1,:) do i=1, 5000 factorList(i) = .747d0 enddo do i=5001, 10000 factorList(i) = 1.d0 enddo endif ! Precompute and store an ArraySMM operation if (localPet==0 .or. localPet==4) then ! only PET 0 and PET 4 provide factors call ESMF_ArraySMMStore(srcArray=srcArray, dstArray=dstArray, & routehandle=routehandle, factorList=factorList, & factorIndexList=factorIndexList, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out else call ESMF_ArraySMMStore(srcArray=srcArray, dstArray=dstArray, & routehandle=routehandle, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out endif print *, "User Coupler Init returning" end subroutine user_init !------------------------------------------------------------------------- ! ! The Run routine where data is coupled. ! ! subroutine user_run(comp, importState, exportState, clock, rc) type(ESMF_CplComp) :: comp type(ESMF_State) :: importState, exportState type(ESMF_Clock) :: clock integer, intent(out) :: rc ! Local variables type(ESMF_Array) :: srcArray, dstArray ! Initialize return code rc = ESMF_SUCCESS print *, "User Coupler Run starting" ! Get source Array out of import state call ESMF_StateGet(importState, "array data", srcArray, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out ! Get destination Array out of export state call ESMF_StateGet(exportState, "array data", dstArray, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out ! Use ArraySMM() to take data from srcArray to dstArray call ESMF_ArraySMM(srcArray=srcArray, dstArray=dstArray, & routehandle=routehandle, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out print *, "User Coupler Run returning" end subroutine user_run !------------------------------------------------------------------------- ! ! The Finalization routine where things are deleted and cleaned up. ! ! subroutine user_final(comp, importState, exportState, clock, rc) type(ESMF_CplComp) :: comp type(ESMF_State) :: importState, exportState type(ESMF_Clock) :: clock integer, intent(out) :: rc ! Initialize return code rc = ESMF_SUCCESS print *, "User Coupler Final starting" ! Release resources stored for the ArraySMM. call ESMF_ArraySMMRelease(routehandle=routehandle, rc=rc) if (rc/=ESMF_SUCCESS) return ! bail out print *, "User Coupler Final returning" end subroutine user_final end module user_coupler !\end{verbatim}