gwfmvrmodule Module Reference

Data Types
type	gwfmvrtype

Functions/Subroutines
subroutine, public	mvr_cr (mvrobj, name_parent, inunit, iout, dis, iexgmvr)
	Create a new mvr object. More...
subroutine	mvr_init (this, name_parent, inunit, iout, dis, iexgmvr)
subroutine	mvr_ar (this)
	Allocate and read water mover information. More...
subroutine	mvr_rp (this)
	Read and Prepare. More...
subroutine	initialize_movers (this, nr_active_movers)
subroutine	mvr_ad (this)
subroutine	mvr_fc (this)
	Calculate qfrommvr as a function of qtomvr. More...
subroutine	mvr_cc (this, innertot, kiter, iend, icnvgmod, cpak, ipak, dpak)
	Extra convergence check for mover. More...
subroutine	mvr_bd (this)
	Fill the mover budget object. More...
subroutine	mvr_bdsav (this, icbcfl, ibudfl, isuppress_output)
	Write mover terms. More...
subroutine	mvr_ot_saveflow (this, icbcfl, ibudfl)
	Write mover terms. More...
subroutine	mvr_ot_printflow (this, icbcfl, ibudfl)
	Print mover flow table. More...
subroutine	mvr_ot_bdsummary (this, ibudfl)
	Write mover budget to listing file. More...
subroutine	mvr_da (this)
	Deallocate. More...
subroutine	read_options (this)
	Read options specified in the input options block. More...
subroutine	check_options (this)
	Check MODELNAMES option set correctly. More...
subroutine	read_dimensions (this)
	Read the dimensions for this package. More...
subroutine	read_packages (this)
	Read the packages that will be managed by this mover. More...
subroutine	check_packages (this)
	Check to make sure packages have mover activated. More...
subroutine	assign_packagemovers (this)
	Assign pointer to each package's packagemover object. More...
subroutine	allocate_scalars (this)
	Allocate package scalars. More...
subroutine	allocate_arrays (this)
	Allocate package arrays. More...
subroutine	mvr_setup_budobj (this)
	Set up the budget object that stores all the mvr flows. More...
subroutine	fill_budobj (this)
subroutine	mvr_setup_outputtab (this)
	Set up output table. More...
subroutine	mvr_print_outputtab (this)
	Set up output table. More...
subroutine	set_mapped_id (this)
	Set mapped id. More...

Function/Subroutine Documentation

allocate_arrays()

subroutine gwfmvrmodule::allocate_arrays

(

class(gwfmvrtype)

this

)

Definition at line 1079 of file gwf-mvr.f90.

    ! -- modules
    use memorymanagermodule, only: mem_allocate
    use constantsmodule, only: dzero
    use packagemovermodule, only: nulllify_packagemover_pointer
    ! -- dummy
    class(GwfMvrType) :: this
    ! -- local
    integer(I4B) :: i
    !
    ! -- Allocate
    allocate (this%mvr(this%maxmvr))
    allocate (this%pckMemPaths(this%maxpackages))
    allocate (this%paknames(this%maxpackages))
    allocate (this%pakmovers(this%maxpackages))
    !
    ! -- nullify the pakmovers
    do i = 1, this%maxpackages
      call nulllify_packagemover_pointer(this%pakmovers(i))
    end do
    !
    ! -- allocate the perioddata object
    call this%gwfmvrperioddata%construct(this%maxmvr, this%memoryPath)
    !
    !
    ! -- allocate the object and assign values to object variables
    call mem_allocate(this%ientries, this%maxcomb, 'IENTRIES', this%memoryPath)
    !
    ! -- initialize ientries
    do i = 1, this%maxcomb
      this%ientries(i) = 0
    end do
    !
    ! -- setup the output table
    call this%mvr_setup_outputtab()
    !
    ! -- Return
    return

Here is the call graph for this function:

allocate_scalars()

subroutine gwfmvrmodule::allocate_scalars

(

class(gwfmvrtype)

this

)

Definition at line 1038 of file gwf-mvr.f90.

    ! -- modules
    use constantsmodule, only: done
    use memorymanagermodule, only: mem_allocate
    ! -- dummy
    class(GwfMvrType) :: this
    !
    ! -- allocate scalars in NumericalPackageType
    call this%NumericalPackageType%allocate_scalars()
    !
    ! -- Allocate
    call mem_allocate(this%reset_mapped_id, 'RESET_MAPPED_ID', this%memoryPath)
    call mem_allocate(this%ibudgetout, 'IBUDGETOUT', this%memoryPath)
    call mem_allocate(this%ibudcsv, 'IBUDCSV', this%memoryPath)
    call mem_allocate(this%maxmvr, 'MAXMVR', this%memoryPath)
    call mem_allocate(this%maxpackages, 'MAXPACKAGES', this%memoryPath)
    call mem_allocate(this%maxcomb, 'MAXCOMB', this%memoryPath)
    call mem_allocate(this%nmvr, 'NMVR', this%memoryPath)
    call mem_allocate(this%iexgmvr, 'IEXGMVR', this%memoryPath)
    call mem_allocate(this%imodelnames, 'IMODELNAMES', this%memoryPath)
    !
    ! -- Initialize
    this%reset_mapped_id = .false.
    this%ibudgetout = 0
    this%ibudcsv = 0
    this%maxmvr = -1
    this%maxpackages = -1
    this%maxcomb = 0
    this%nmvr = 0
    this%iexgmvr = 0
    this%imodelnames = 0
    !
    ! -- allocate the period data input object
    allocate (this%gwfmvrperioddata)
    !
    ! -- Return
    return

assign_packagemovers()

subroutine gwfmvrmodule::assign_packagemovers

(

class(gwfmvrtype), intent(inout)

this

)

Definition at line 1016 of file gwf-mvr.f90.

    ! -- modules
    use packagemovermodule, only: set_packagemover_pointer
    ! -- dummy
    class(GwfMvrType), intent(inout) :: this
    ! -- local
    integer(I4B) :: i
    !
    ! -- Assign the package mover pointer if it hasn't been assigned yet
    do i = 1, size(this%pckMemPaths)
      if (this%pakmovers(i)%memoryPath == '') then
        call set_packagemover_pointer(this%pakmovers(i), &
                                      trim(this%pckMemPaths(i)))
      end if
    end do
    !
    ! -- Return
    return

Here is the call graph for this function:

check_options()

subroutine gwfmvrmodule::check_options

(

class(gwfmvrtype)

this

)

Definition at line 811 of file gwf-mvr.f90.

    ! -- modules
    use constantsmodule, only: linelength
    use simmodule, only: store_error, store_error_unit
    ! -- dummy
    class(GwfMvrType) :: this
    ! -- local
    character(len=LINELENGTH) :: errmsg
    !
    ! -- Check if not exchange mover but model names are specified
    if (this%iexgmvr == 0 .and. this%imodelnames == 1) then
      write (errmsg, '(a,a)') &
        'MODELNAMES cannot be specified unless the '// &
        'mover package is for an exchange.'
      call store_error(errmsg)
      call this%parser%StoreErrorUnit()
    end if
    !
    ! -- Check if exchange mover but model names not specified
    if (this%iexgmvr /= 0 .and. this%imodelnames == 0) then
      write (errmsg, '(a,a)') &
        'MODELNAMES option must be specified because '// &
        'mover package is for an exchange.'
      call store_error(errmsg)
      call this%parser%StoreErrorUnit()
    end if
    !
    ! -- Return
    return

Here is the call graph for this function:

check_packages()

subroutine gwfmvrmodule::check_packages

(

class(gwfmvrtype), intent(inout)

this

)

Definition at line 980 of file gwf-mvr.f90.

    ! -- modules
    use constantsmodule, only: linelength
    use memorymanagermodule, only: mem_setptr
    use simmodule, only: store_error, count_errors, store_error_unit
    ! -- dummy
    class(GwfMvrType), intent(inout) :: this
    ! -- local
    character(len=LINELENGTH) :: errmsg
    integer(I4B) :: i
    integer(I4B), pointer :: imover_ptr
    !
    ! -- Check to make sure mover is activated for each package
    do i = 1, size(this%pckMemPaths)
      imover_ptr => null()
      call mem_setptr(imover_ptr, 'IMOVER', trim(this%pckMemPaths(i)))
      if (imover_ptr == 0) then
        write (errmsg, '(a, a, a)') &
          'ERROR.  MODEL AND PACKAGE "', &
          trim(this%pckMemPaths(i)), &
          '" DOES NOT HAVE MOVER SPECIFIED IN OPTIONS BLOCK.'
        call store_error(errmsg)
      end if
    end do
    !
    ! -- Terminate if errors detected.
    if (count_errors() > 0) then
      call this%parser%StoreErrorUnit()
    end if
    !
    ! -- Return
    return

Here is the call graph for this function:

fill_budobj()

subroutine gwfmvrmodule::fill_budobj

(

class(gwfmvrtype)

this

)

Definition at line 1183 of file gwf-mvr.f90.

! ******************************************************************************
! mvr_fill_budobj -- copy flow terms into this%budobj
! ******************************************************************************
!
!    SPECIFICATIONS:
! ------------------------------------------------------------------------------
    ! -- modules
    ! -- dummy
    class(GwfMvrType) :: this
    ! -- local
    integer(I4B) :: idx
    integer(I4B) :: i
    integer(I4B) :: j
    integer(I4B) :: n, n1, n2
    integer(I4B) :: ipos
    integer(I4B) :: ival
    integer(I4B) :: nitems
    integer(I4B) :: lloc
    integer(I4B) :: istart
    integer(I4B) :: istop
    real(DP) :: rval
    character(len=LENMODELNAME) :: modelname1, modelname2
    character(len=LENPACKAGENAME) :: packagename1, packagename2
    character(len=LENMEMPATH) :: pckMemPathsDummy
    real(DP) :: q
    !
    ! -- initialize counter
    idx = 0
 
    do i = 1, this%maxpackages
      ! -- Retrieve modelname1 and packagename1
      lloc = 1
      call urword(this%pckMemPaths(i), lloc, istart, istop, 1, ival, rval, -1, -1)
      pckmempathsdummy = this%pckMemPaths(i)
      modelname1 = pckmempathsdummy(istart:istop)
      call urword(this%pckMemPaths(i), lloc, istart, istop, 1, ival, rval, -1, -1)
      pckmempathsdummy = this%pckMemPaths(i)
      packagename1 = pckmempathsdummy(istart:istop)
      do j = 1, this%maxpackages
        ! -- Retrieve modelname2 and packagename2
        lloc = 1
        call urword(this%pckMemPaths(j), lloc, istart, istop, 1, ival, rval, &
                    -1, -1)
        pckmempathsdummy = this%pckMemPaths(j)
        modelname2 = pckmempathsdummy(istart:istop)
        call urword(this%pckMemPaths(j), lloc, istart, istop, 1, ival, rval, &
                    -1, -1)
        pckmempathsdummy = this%pckMemPaths(j)
        packagename2 = pckmempathsdummy(istart:istop)
        ipos = (i - 1) * this%maxpackages + j
        nitems = this%ientries(ipos)
        !
        ! -- nitems is the number of mover connections for this
        !    model-package / model-package combination.  Cycle if none.
        idx = idx + 1
        call this%budobj%budterm(idx)%reset(nitems)
        if (nitems < 1) cycle
        do n = 1, this%nmvr
          !
          ! -- pname1 is provider, pname2 is receiver
          !    flow is always negative because it is coming from provider
          if (this%pckMemPaths(i) == this%mvr(n)%mem_path_src) then
            if (this%pckMemPaths(j) == this%mvr(n)%mem_path_tgt) then
              !
              ! -- set q to qpactual
              q = -this%mvr(n)%qpactual
              !
              ! -- use mapped index (needed for lake to map outlet to lake number)
              n1 = this%mvr(n)%iRchNrSrcMapped
              !
              ! -- set receiver id to irch2
              n2 = this%mvr(n)%iRchNrTgt
              !
              ! -- check record into budget object
              call this%budobj%budterm(idx)%update_term(n1, n2, q)
            end if
          end if
        end do
      end do
    end do
    !
    ! --Terms are filled, now accumulate them for this time step
    call this%budobj%accumulate_terms()
    !
    ! -- Return
    return

Here is the call graph for this function:

initialize_movers()

subroutine gwfmvrmodule::initialize_movers	(	class(gwfmvrtype)	this,
		integer(i4b)	nr_active_movers
	)

Definition at line 415 of file gwf-mvr.f90.

    class(GwfMvrType) :: this
    integer(I4B) :: nr_active_movers
    ! local
    integer(I4B) :: i
 
    do i = 1, nr_active_movers
      call this%mvr(i)%set_values(this%gwfmvrperioddata%mname1(i), &
                                  this%gwfmvrperioddata%pname1(i), &
                                  this%gwfmvrperioddata%id1(i), &
                                  this%gwfmvrperioddata%mname2(i), &
                                  this%gwfmvrperioddata%pname2(i), &
                                  this%gwfmvrperioddata%id2(i), &
                                  this%gwfmvrperioddata%imvrtype(i), &
                                  this%gwfmvrperioddata%value(i))
    end do
 

mvr_ad()

subroutine gwfmvrmodule::mvr_ad ( class(gwfmvrtype)  this )

private

Definition at line 434 of file gwf-mvr.f90.

    ! -- dummy
    class(GwfMvrType) :: this
    ! -- locals
    integer(I4B) :: i
    !
    do i = 1, this%nmvr
      call this%mvr(i)%advance()
    end do
    !
    ! -- Return
    return

mvr_ar()

subroutine gwfmvrmodule::mvr_ar ( class(gwfmvrtype)  this )

private

Definition at line 245 of file gwf-mvr.f90.

    ! -- dummy
    class(GwfMvrType) :: this
    !
    ! -- Print a message identifying the water mover package.
    write (this%iout, 1) this%inunit
1   format(1x, /1x, 'MVR -- WATER MOVER PACKAGE, VERSION 8, 1/29/2016', &
           ' INPUT READ FROM UNIT ', i0)
    !
    ! -- Read and check options
    call this%read_options()
    call this%check_options()
    !
    ! -- Read options
    call this%read_dimensions()
    !
    ! -- Allocate arrays
    call this%allocate_arrays()
    !
    ! -- Read and check package names
    call this%read_packages()
    call this%check_packages()
    !
    ! -- Define the budget object to be the size of package names
    call this%budget%budget_df(this%maxpackages, 'WATER MOVER')
    call this%budget%set_ibudcsv(this%ibudcsv)
    !
    ! -- setup the budget object
    call this%mvr_setup_budobj()
    !
    ! -- Return
    return

mvr_bd()

subroutine gwfmvrmodule::mvr_bd ( class(gwfmvrtype)  this )

private

Definition at line 494 of file gwf-mvr.f90.

    ! -- dummy
    class(GwfMvrType) :: this
    ! -- locals
    ! -- formats
    !
    ! -- set the feature maps; for performance reasons,
    !    this should only be called for the first time
    !    step of a stress period in which a new set of
    !    movers was provided in a period block.
    if (this%reset_mapped_id) then
      call this%set_mapped_id()
      this%reset_mapped_id = .false.
    end if
    !
    ! -- fill the budget object
    call this%fill_budobj()
    !
    ! -- Return
    return

mvr_bdsav()

subroutine gwfmvrmodule::mvr_bdsav ( class(gwfmvrtype)  this, integer(i4b), intent(in)  icbcfl, integer(i4b), intent(in)  ibudfl, integer(i4b), intent(in)  isuppress_output  )

private

Definition at line 518 of file gwf-mvr.f90.

    ! -- modules
    use tdismodule, only: kstp, kper, delt, pertim, totim
    ! -- dummy
    class(GwfMvrType) :: this
    integer(I4B), intent(in) :: icbcfl
    integer(I4B), intent(in) :: ibudfl
    integer(I4B), intent(in) :: isuppress_output
    ! -- locals
    integer(I4B) :: ibinun
    ! -- formats
    character(len=*), parameter :: fmttkk = &
                                   "(1X,/1X,A,'   PERIOD ',I0,'   STEP ',I0)"
    !
    ! -- Print the mover flow table
    if (ibudfl /= 0 .and. this%iprflow /= 0 .and. isuppress_output == 0) then
      call this%mvr_print_outputtab()
    end if
    !
    ! -- Save the mover flows from the budobj to a mover binary file
    ibinun = 0
    if (this%ibudgetout /= 0) then
      ibinun = this%ibudgetout
    end if
    if (icbcfl == 0) ibinun = 0
    if (isuppress_output /= 0) ibinun = 0
    if (ibinun > 0) then
      call this%budobj%save_flows(this%dis, ibinun, kstp, kper, delt, &
                                  pertim, totim, this%iout)
    end if
    !
    ! -- Return
    return

mvr_cc()

subroutine gwfmvrmodule::mvr_cc ( class(gwfmvrtype)  this, integer(i4b), intent(in)  innertot, integer(i4b), intent(in)  kiter, integer(i4b), intent(in)  iend, integer(i4b), intent(in)  icnvgmod, character(len=lenpakloc), intent(inout)  cpak, integer(i4b), intent(inout)  ipak, real(dp), intent(inout)  dpak  )

private

Definition at line 464 of file gwf-mvr.f90.

    ! -- dummy
    class(GwfMvrType) :: this
    integer(I4B), intent(in) :: innertot
    integer(I4B), intent(in) :: kiter
    integer(I4B), intent(in) :: iend
    integer(I4B), intent(in) :: icnvgmod
    character(len=LENPAKLOC), intent(inout) :: cpak
    integer(I4B), intent(inout) :: ipak
    real(DP), intent(inout) :: dpak
    ! -- formats
    character(len=*), parameter :: fmtmvrcnvg = &
      "(/,1x,'MOVER PACKAGE REQUIRES AT LEAST TWO OUTER ITERATIONS. CONVERGE &
      &FLAG HAS BEEN RESET TO FALSE.')"
    !
    ! -- If there are active movers, then at least 2 outers required
    if (this%nmvr > 0) then
      if (icnvgmod == 1 .and. kiter == 1) then
        dpak = dnodata
        cpak = trim(this%packName)
        write (this%iout, fmtmvrcnvg)
      end if
    end if
    !
    ! -- Return
    return

mvr_cr()

subroutine, public gwfmvrmodule::mvr_cr	(	type(gwfmvrtype), pointer	mvrobj,
		character(len=*), intent(in)	name_parent,
		integer(i4b), intent(in)	inunit,
		integer(i4b), intent(in)	iout,
		class(disbasetype), intent(in), pointer	dis,
		integer(i4b), optional	iexgmvr
	)

Definition at line 184 of file gwf-mvr.f90.

    ! -- dummy
    type(GwfMvrType), pointer :: mvrobj
    character(len=*), intent(in) :: name_parent
    integer(I4B), intent(in) :: inunit
    integer(I4B), intent(in) :: iout
    class(DisBaseType), pointer, intent(in) :: dis
    integer(I4B), optional :: iexgmvr
    !
    ! -- Create the object
    allocate (mvrobj)
    !
    ! -- Init
    call mvrobj%mvr_init(name_parent, inunit, iout, dis, iexgmvr)
    !
    ! -- Return
    return

Here is the caller graph for this function:

mvr_da()

subroutine gwfmvrmodule::mvr_da

(

class(gwfmvrtype)

this

)

Definition at line 664 of file gwf-mvr.f90.

    ! -- modules
    use constantsmodule, only: done
    use memorymanagermodule, only: mem_deallocate
    ! -- dummy
    class(GwfMvrType) :: this
    !
    ! -- Arrays
    if (this%inunit > 0) then
      call mem_deallocate(this%ientries)
      deallocate (this%mvr)
      deallocate (this%pckMemPaths)
      deallocate (this%paknames)
      deallocate (this%pakmovers)
      !
      ! -- allocate the perioddata object
      call this%gwfmvrperioddata%destroy()
      deallocate (this%gwfmvrperioddata)
      nullify (this%gwfmvrperioddata)
      !
      ! -- budget object
      call this%budget%budget_da()
      deallocate (this%budget)
      !
      ! -- budobj
      call this%budobj%budgetobject_da()
      deallocate (this%budobj)
      nullify (this%budobj)
      !
      ! -- output table object
      if (associated(this%outputtab)) then
        call this%outputtab%table_da()
        deallocate (this%outputtab)
        nullify (this%outputtab)
      end if
    end if
    !
    ! -- Scalars
    call mem_deallocate(this%reset_mapped_id)
    call mem_deallocate(this%ibudgetout)
    call mem_deallocate(this%ibudcsv)
    call mem_deallocate(this%maxmvr)
    call mem_deallocate(this%maxpackages)
    call mem_deallocate(this%maxcomb)
    call mem_deallocate(this%nmvr)
    call mem_deallocate(this%iexgmvr)
    call mem_deallocate(this%imodelnames)
    !
    ! -- deallocate scalars in NumericalPackageType
    call this%NumericalPackageType%da()
    !
    ! -- Return
    return

mvr_fc()

subroutine gwfmvrmodule::mvr_fc ( class(gwfmvrtype)  this )

private

Definition at line 450 of file gwf-mvr.f90.

    class(GwfMvrType) :: this
    ! local
    integer(I4B) :: i
 
    do i = 1, this%nmvr
      call this%mvr(i)%update_provider()
      call this%mvr(i)%update_receiver()
    end do
 

mvr_init()

subroutine gwfmvrmodule::mvr_init ( class(gwfmvrtype)  this, character(len=*), intent(in)  name_parent, integer(i4b), intent(in)  inunit, integer(i4b), intent(in)  iout, class(disbasetype), intent(in), pointer  dis, integer(i4b), optional  iexgmvr  )

private

Definition at line 203 of file gwf-mvr.f90.

    class(GwfMvrType) :: this
    character(len=*), intent(in) :: name_parent
    integer(I4B), intent(in) :: inunit
    integer(I4B), intent(in) :: iout
    class(DisBaseType), pointer, intent(in) :: dis
    integer(I4B), optional :: iexgmvr
    !
    ! -- create name and memory paths. name_parent will either be model name or the
    !    exchange name.
    call this%set_names(1, name_parent, 'MVR', 'MVR')
    !
    ! -- Allocate scalars
    call this%allocate_scalars()
    !
    ! -- Set pointer to dis
    this%dis => dis
    !
    ! -- Set variables
    this%inunit = inunit
    this%iout = iout
    !
    ! -- Set iexgmvr
    if (present(iexgmvr)) this%iexgmvr = iexgmvr
    !
    ! -- Create the budget object
    if (inunit > 0) then
      call budget_cr(this%budget, this%memoryPath)
      !
      ! -- Initialize block parser
      call this%parser%Initialize(this%inunit, this%iout)
    end if
    !
    ! -- instantiate the budget object
    call budgetobject_cr(this%budobj, 'WATER MOVER')
    !
    ! -- Return
    return

Here is the call graph for this function:

mvr_ot_bdsummary()

subroutine gwfmvrmodule::mvr_ot_bdsummary ( class(gwfmvrtype)  this, integer(i4b), intent(in)  ibudfl  )

private

Definition at line 599 of file gwf-mvr.f90.

    ! -- modules
    use tdismodule, only: kstp, kper, delt, totim
    ! -- dummy
    class(GwfMvrType) :: this
    integer(I4B), intent(in) :: ibudfl
    ! -- locals
    character(len=LENMEMPATH) :: pckMemPath
    integer(I4B) :: i, j
    real(DP), allocatable, dimension(:) :: ratin, ratout
    !
    ! -- Allocate and initialize ratin/ratout
    allocate (ratin(this%maxpackages), ratout(this%maxpackages))
    do j = 1, this%maxpackages
      ratin(j) = dzero
      ratout(j) = dzero
    end do
    !
    ! -- Accumulate the rates
    do i = 1, this%nmvr
      do j = 1, this%maxpackages
        if (this%pckMemPaths(j) == this%mvr(i)%mem_path_src) then
          ratin(j) = ratin(j) + this%mvr(i)%qpactual
        end if
        if (this%pckMemPaths(j) == this%mvr(i)%mem_path_tgt) then
          ratout(j) = ratout(j) + this%mvr(i)%qpactual
        end if
      end do
    end do
    !
    ! -- Send rates to budget object
    call this%budget%reset()
    do j = 1, this%maxpackages
      if ((this%iexgmvr) == 1) then
        pckmempath = this%pckMemPaths(j)
      else
        pckmempath = this%paknames(j)
      end if
      call this%budget%addentry(ratin(j), ratout(j), delt, pckmempath)
    end do
    !
    ! -- Write the budget
    call this%budget%finalize_step(delt)
    if (ibudfl /= 0) then
      call this%budget%budget_ot(kstp, kper, this%iout)
    end if
    !
    ! -- Write budget csv
    call this%budget%writecsv(totim)
    !
    ! -- Deallocate
    deallocate (ratin, ratout)
    !
    ! -- Output mvr budget
    !    Not using budobj write_table here because it would result
    !    in a table that has one entry.  A custom table looks
    !    better here with a row for each package.
    !call this%budobj%write_budtable(kstp, kper, this%iout)
    !
    ! -- Return
    return

mvr_ot_printflow()

subroutine gwfmvrmodule::mvr_ot_printflow	(	class(gwfmvrtype)	this,
		integer(i4b), intent(in)	icbcfl,
		integer(i4b), intent(in)	ibudfl
	)

Definition at line 582 of file gwf-mvr.f90.

    ! -- dummy
    class(GwfMvrType) :: this
    integer(I4B), intent(in) :: icbcfl
    integer(I4B), intent(in) :: ibudfl
    !
    ! -- Print the mover flow table
    if (ibudfl /= 0 .and. this%iprflow /= 0) then
      call this%mvr_print_outputtab()
    end if
    !
    ! -- Return
    return

mvr_ot_saveflow()

subroutine gwfmvrmodule::mvr_ot_saveflow	(	class(gwfmvrtype)	this,
		integer(i4b), intent(in)	icbcfl,
		integer(i4b), intent(in)	ibudfl
	)

Definition at line 555 of file gwf-mvr.f90.

    ! -- modules
    use tdismodule, only: kstp, kper, delt, pertim, totim
    ! -- dummy
    class(GwfMvrType) :: this
    integer(I4B), intent(in) :: icbcfl
    integer(I4B), intent(in) :: ibudfl
    ! -- locals
    integer(I4B) :: ibinun
    !
    ! -- Save the mover flows from the budobj to a mover binary file
    ibinun = 0
    if (this%ibudgetout /= 0) then
      ibinun = this%ibudgetout
    end if
    if (icbcfl == 0) ibinun = 0
    if (ibinun > 0) then
      call this%budobj%save_flows(this%dis, ibinun, kstp, kper, delt, &
                                  pertim, totim, this%iout)
    end if
    !
    ! -- Return
    return

mvr_print_outputtab()

subroutine gwfmvrmodule::mvr_print_outputtab ( class(gwfmvrtype), intent(inout)  this )

private

Definition at line 1320 of file gwf-mvr.f90.

    ! -- module
    use tdismodule, only: kstp, kper
    ! -- dummy
    class(GwfMvrType), intent(inout) :: this
    ! -- local
    character(len=LINELENGTH) :: title
    integer(I4B) :: i
    !
    ! -- set table kstp and kper
    call this%outputtab%set_kstpkper(kstp, kper)
    !
    ! -- Add terms and print the table
    title = 'WATER MOVER PACKAGE ('//trim(this%packName)// &
            ') FLOW RATES'
    call this%outputtab%set_title(title)
    call this%outputtab%set_maxbound(this%nmvr)
    do i = 1, this%nmvr
      call this%outputtab%add_term(i)
      call this%outputtab%add_term(this%mvr(i)%mem_path_src)
      call this%outputtab%add_term(this%mvr(i)%iRchNrSrc)
      call this%outputtab%add_term(this%mvr(i)%qavailable)
      call this%outputtab%add_term(this%mvr(i)%qpactual)
      call this%outputtab%add_term(this%mvr(i)%mem_path_tgt)
      call this%outputtab%add_term(this%mvr(i)%iRchNrTgt)
    end do
    !
    ! -- Return
    return

mvr_rp()

subroutine gwfmvrmodule::mvr_rp ( class(gwfmvrtype), intent(inout)  this )

private

Read itmp and read new boundaries if itmp > 0

Definition at line 283 of file gwf-mvr.f90.

    ! -- modules
    use constantsmodule, only: linelength
    use tdismodule, only: kper, nper
    use simmodule, only: store_error, store_error_unit, count_errors
    use arrayhandlersmodule, only: ifind
    ! -- dummy
    class(GwfMvrType), intent(inout) :: this
    ! -- local
    integer(I4B) :: i, ierr, nlist, ipos
    integer(I4B) :: ii, jj
    logical :: isfound
    character(len=LINELENGTH) :: line, errmsg
    character(len=LENMODELNAME) :: mname
    ! -- formats
    character(len=*), parameter :: fmtblkerr = &
      &"('Error.  Looking for BEGIN PERIOD iper.  Found ', a, ' instead.')"
    character(len=*), parameter :: fmtlsp = &
      &"(1X,/1X,'REUSING ',A,'S FROM LAST STRESS PERIOD')"
    character(len=*), parameter :: fmtnbd = &
      "(1X,/1X,'THE NUMBER OF ACTIVE ',A,'S (',I6, &
       &') IS GREATER THAN MAXIMUM(',I6,')')"
    !
    ! -- Set ionper to the stress period number for which a new block of data
    !    will be read.
    if (this%inunit == 0) return
    !
    ! -- get stress period data
    if (this%ionper < kper) then
      !
      ! -- get period block
      call this%parser%GetBlock('PERIOD', isfound, ierr, &
                                supportopenclose=.true., &
                                blockrequired=.false.)
      if (isfound) then
        !
        ! -- read ionper and check for increasing period numbers
        call this%read_check_ionper()
      else
        !
        ! -- PERIOD block not found
        if (ierr < 0) then
          ! -- End of file found; data applies for remainder of simulation.
          this%ionper = nper + 1
        else
          ! -- Found invalid block
          call this%parser%GetCurrentLine(line)
          write (errmsg, fmtblkerr) adjustl(trim(line))
          call store_error(errmsg)
          call this%parser%StoreErrorUnit()
        end if
      end if
    end if
    !
    ! -- read data if ionper == kper
    if (this%ionper == kper) then
      write (this%iout, '(/,2x,a,i0)') 'READING WATER MOVERS FOR PERIOD ', kper
      nlist = -1
      i = 1
      this%reset_mapped_id = .true.
      !
      ! -- set mname to '' if this is an exchange mover, or to the model name
      if (this%iexgmvr == 0) then
        mname = this%name_model
      else
        mname = ''
      end if
      !
      ! -- Assign a pointer to the package mover object.  The pointer assignment
      !    will happen only the first time
      call this%assign_packagemovers()
      !
      ! -- Call the period data input reader
      call this%gwfmvrperioddata%read_from_parser(this%parser, nlist, mname)
      !
      ! -- Process the input data into the individual mover objects
      call this%initialize_movers(nlist)
      !
      ! -- assign the pointers
      do i = 1, nlist
        call this%mvr(i)%prepare(this%parser%iuactive, &
                                 this%pckMemPaths, &
                                 this%pakmovers)
        if (this%iprpak == 1) call this%mvr(i)%echo(this%iout)
      end do
      write (this%iout, '(/,1x,a,1x,i6,/)') 'END OF DATA FOR PERIOD', kper
      !
      ! -- Set the number of movers for this period to nlist
      this%nmvr = nlist
      write (this%iout, '(4x, i0, a, i0)') this%nmvr, &
        ' MOVERS READ FOR PERIOD ', kper
      !
      ! -- Check to make sure all providers and receivers are properly stored
      do i = 1, this%nmvr
        ipos = ifind(this%pckMemPaths, this%mvr(i)%mem_path_src)
        if (ipos < 1) then
          write (errmsg, '(a,a,a)') 'Provider ', &
            trim(this%mvr(i)%mem_path_src), ' not listed in packages block.'
          call store_error(errmsg)
        end if
        ipos = ifind(this%pckMemPaths, this%mvr(i)%mem_path_tgt)
        if (ipos < 1) then
          write (errmsg, '(a,a,a)') 'Receiver ', &
            trim(this%mvr(i)%mem_path_tgt), ' not listed in packages block.'
          call store_error(errmsg)
        end if
      end do
      if (count_errors() > 0) then
        call this%parser%StoreErrorUnit()
      end if
      !
      ! -- reset ientries
      do i = 1, this%maxcomb
        this%ientries(i) = 0
      end do
      !
      ! --
      do i = 1, this%nmvr
        ii = ifind(this%pckMemPaths, this%mvr(i)%mem_path_src)
        jj = ifind(this%pckMemPaths, this%mvr(i)%mem_path_tgt)
        ipos = (ii - 1) * this%maxpackages + jj
        this%ientries(ipos) = this%ientries(ipos) + 1
      end do
    else
      write (this%iout, fmtlsp) 'MVR'
      !
    end if
    !
    ! -- Return
    return

Here is the call graph for this function:

mvr_setup_budobj()

subroutine gwfmvrmodule::mvr_setup_budobj

(

class(gwfmvrtype)

this

)

Definition at line 1121 of file gwf-mvr.f90.

    ! -- modules
    use constantsmodule, only: lenbudtxt
    use memoryhelpermodule, only: split_mem_path
    ! -- dummy
    class(GwfMvrType) :: this
    ! -- local
    integer(I4B) :: nbudterm
    integer(I4B) :: ncv
    integer(I4B) :: i
    integer(I4B) :: j
    integer(I4B) :: naux
    character(len=LENMODELNAME) :: modelname1, modelname2
    character(len=LENPACKAGENAME) :: packagename1, packagename2
    integer(I4B) :: maxlist
    integer(I4B) :: idx
    character(len=LENBUDTXT) :: text
    !
    ! -- Determine the number of mover budget terms. These are fixed for
    !    the simulation and cannot change.  A separate term is required
    !    for each possible provider/receiver combination.
    nbudterm = 0
    do i = 1, this%maxpackages
      do j = 1, this%maxpackages
        nbudterm = nbudterm + 1
      end do
    end do
    !
    ! -- Number of control volumes is set to be 0, because there aren't
    !    any for the mover
    ncv = 0
    !
    ! -- set up budobj
    call this%budobj%budgetobject_df(ncv, nbudterm, 0, 0)
    idx = 0
    !
    ! -- Go through and set up each budget term
    text = '      MOVER-FLOW'
    maxlist = this%maxmvr
    naux = 0
    do i = 1, this%maxpackages
 
      call split_mem_path(this%pckMemPaths(i), modelname1, packagename1)
 
      do j = 1, this%maxpackages
 
        idx = idx + 1
        call split_mem_path(this%pckMemPaths(j), modelname2, packagename2)
        call this%budobj%budterm(idx)%initialize(text, &
                                                 modelname1, &
                                                 packagename1, &
                                                 modelname2, &
                                                 packagename2, &
                                                 maxlist, .false., .false., &
                                                 naux)
      end do
    end do
    !
    ! -- Return
    return

Here is the call graph for this function:

mvr_setup_outputtab()

subroutine gwfmvrmodule::mvr_setup_outputtab ( class(gwfmvrtype), intent(inout)  this )

private

Definition at line 1274 of file gwf-mvr.f90.

    ! -- dummy
    class(GwfMvrType), intent(inout) :: this
    ! -- local
    character(len=LINELENGTH) :: title
    character(len=LINELENGTH) :: text
    integer(I4B) :: ntabcol
    integer(I4B) :: ilen
    !
    ! -- allocate and initialize the output table
    if (this%iprflow /= 0) then
      !
      ! -- dimension table
      ntabcol = 7
      !
      ! -- initialize the output table object
      title = 'WATER MOVER PACKAGE ('//trim(this%packName)// &
              ') FLOW RATES'
      call table_cr(this%outputtab, this%packName, title)
      call this%outputtab%table_df(this%maxmvr, ntabcol, this%iout, &
                                   transient=.true.)
      text = 'NUMBER'
      call this%outputtab%initialize_column(text, 10, alignment=tabcenter)
      text = 'PROVIDER LOCATION'
      ilen = lenmodelname + lenpackagename + 1
      call this%outputtab%initialize_column(text, ilen)
      text = 'PROVIDER ID'
      call this%outputtab%initialize_column(text, 10)
      text = 'AVAILABLE RATE'
      call this%outputtab%initialize_column(text, 10)
      text = 'PROVIDED RATE'
      call this%outputtab%initialize_column(text, 10)
      text = 'RECEIVER LOCATION'
      ilen = lenmodelname + lenpackagename + 1
      call this%outputtab%initialize_column(text, ilen)
      text = 'RECEIVER ID'
      call this%outputtab%initialize_column(text, 10)
      !
    end if
    !
    ! -- Return
    return

Here is the call graph for this function:

read_dimensions()

subroutine gwfmvrmodule::read_dimensions

(

class(gwfmvrtype), intent(inout)

this

)

Definition at line 844 of file gwf-mvr.f90.

    ! -- modules
    use constantsmodule, only: linelength
    use simmodule, only: store_error, count_errors, store_error_unit
    ! -- dummy
    class(GwfMvrType), intent(inout) :: this
    ! -- local
    character(len=LINELENGTH) :: errmsg, keyword
    integer(I4B) :: ierr
    logical :: isfound, endOfBlock
    integer(I4B) :: i
    integer(I4B) :: j
    !
    ! -- get dimensions block
    call this%parser%GetBlock('DIMENSIONS', isfound, ierr, &
                              supportopenclose=.true.)
    !
    ! -- parse dimensions block if detected
    if (isfound) then
      write (this%iout, '(/1x,a)') 'PROCESSING MVR DIMENSIONS'
      do
        call this%parser%GetNextLine(endofblock)
        if (endofblock) exit
        call this%parser%GetStringCaps(keyword)
        select case (keyword)
        case ('MAXMVR')
          this%maxmvr = this%parser%GetInteger()
          write (this%iout, '(4x,a,i0)') 'MAXMVR = ', this%maxmvr
        case ('MAXPACKAGES')
          this%maxpackages = this%parser%GetInteger()
          write (this%iout, '(4x,a,i0)') 'MAXPACKAGES = ', this%maxpackages
        case default
          write (errmsg, '(a,a)') &
            'Unknown MVR dimension: ', trim(keyword)
          call store_error(errmsg)
          call this%parser%StoreErrorUnit()
        end select
      end do
      write (this%iout, '(1x,a)') 'END OF MVR DIMENSIONS'
    else
      call store_error('Required DIMENSIONS block not found.')
      call this%parser%StoreErrorUnit()
    end if
    !
    ! -- calculate maximum number of combinations
    this%maxcomb = 0
    do i = 1, this%maxpackages
      do j = 1, this%maxpackages
        this%maxcomb = this%maxcomb + 1
      end do
    end do
    !
    ! -- verify dimensions were set
    if (this%maxmvr < 0) then
      write (errmsg, '(a)') &
        'MAXMVR was not specified or was specified incorrectly.'
      call store_error(errmsg)
      call this%parser%StoreErrorUnit()
    end if
    if (this%maxpackages < 0) then
      write (errmsg, '(a)') &
        'MAXPACKAGES was not specified or was specified incorrectly.'
      call store_error(errmsg)
      call this%parser%StoreErrorUnit()
    end if
    !
    ! -- Return
    return

Here is the call graph for this function:

read_options()

subroutine gwfmvrmodule::read_options

(

class(gwfmvrtype)

this

)

Definition at line 721 of file gwf-mvr.f90.

    ! -- modules
    use constantsmodule, only: linelength, dzero, done
    use openspecmodule, only: access, form
    use simmodule, only: store_error, store_error_unit
    use inputoutputmodule, only: urword, getunit, openfile
    ! -- dummy
    class(GwfMvrType) :: this
    ! -- local
    character(len=LINELENGTH) :: errmsg
    character(len=MAXCHARLEN) :: fname, keyword
    integer(I4B) :: ierr
    logical :: isfound, endOfBlock
    ! -- formats
    character(len=*), parameter :: fmtmvrbin = &
      "(4x, 'MVR ', 1x, a, 1x, ' WILL BE SAVED TO FILE: ', a, /4x, 'OPENED ON &
      &UNIT: ', I0)"
    !
    ! -- get options block
    call this%parser%GetBlock('OPTIONS', isfound, ierr, &
                              supportopenclose=.true., blockrequired=.false.)
    !
    ! -- parse options block if detected
    if (isfound) then
      write (this%iout, '(1x,a)') 'PROCESSING MVR OPTIONS'
      do
        call this%parser%GetNextLine(endofblock)
        if (endofblock) exit
        call this%parser%GetStringCaps(keyword)
        select case (keyword)
        case ('BUDGET')
          call this%parser%GetStringCaps(keyword)
          if (keyword == 'FILEOUT') then
            call this%parser%GetString(fname)
            this%ibudgetout = getunit()
            call openfile(this%ibudgetout, this%iout, fname, 'DATA(BINARY)', &
                          form, access, 'REPLACE')
            write (this%iout, fmtmvrbin) 'BUDGET', trim(adjustl(fname)), &
              this%ibudgetout
          else
            call store_error('OPTIONAL BUDGET KEYWORD MUST &
                             &BE FOLLOWED BY FILEOUT')
          end if
        case ('BUDGETCSV')
          call this%parser%GetStringCaps(keyword)
          if (keyword == 'FILEOUT') then
            call this%parser%GetString(fname)
            this%ibudcsv = getunit()
            call openfile(this%ibudcsv, this%iout, fname, 'CSV', &
                          filstat_opt='REPLACE')
            write (this%iout, fmtmvrbin) 'BUDGET CSV', trim(adjustl(fname)), &
              this%ibudcsv
          else
            call store_error('OPTIONAL BUDGETCSV KEYWORD MUST BE FOLLOWED BY &
              &FILEOUT')
          end if
        case ('PRINT_INPUT')
          this%iprpak = 1
          write (this%iout, '(4x,a)') 'WATER MOVER INPUT '// &
            'WILL BE PRINTED TO LIST FILE.'
        case ('PRINT_FLOWS')
          this%iprflow = 1
          write (this%iout, '(4x,a)') 'LISTS OF WATER MOVER FLOWS '// &
            'WILL BE PRINTED TO LIST FILE.'
        case ('MODELNAMES')
          this%imodelnames = 1
          write (this%iout, '(4x,a)') 'ALL PACKAGE NAMES ARE PRECEDED '// &
            'BY THE NAME OF THE MODEL CONTAINING THE PACKAGE.'
          if (this%iexgmvr == 0) then
            write (errmsg, '(a,a)') &
              'MODELNAMES cannot be specified unless the '// &
              'mover package is for an exchange.'
            call store_error(errmsg)
            call this%parser%StoreErrorUnit()
          end if
        case default
          write (errmsg, '(a,a)') 'Unknown MVR option: ', trim(keyword)
          call store_error(errmsg)
          call this%parser%StoreErrorUnit()
        end select
      end do
      write (this%iout, '(1x,a)') 'END OF MVR OPTIONS'
    end if
    !
    ! -- Return
    return

Here is the call graph for this function:

read_packages()

subroutine gwfmvrmodule::read_packages

(

class(gwfmvrtype), intent(inout)

this

)

Definition at line 916 of file gwf-mvr.f90.

    ! -- modules
    use constantsmodule, only: linelength
    use memoryhelpermodule, only: create_mem_path
    use simmodule, only: store_error, count_errors, store_error_unit
    ! -- dummy
    class(GwfMvrType), intent(inout) :: this
    ! -- local
    character(len=LINELENGTH) :: errmsg, word, word1, word2
    integer(I4B) :: lloc, ierr
    integer(I4B) :: npak
    logical :: isfound, endOfBlock
    !
    ! -- get packages block
    call this%parser%GetBlock('PACKAGES', isfound, ierr, &
                              supportopenclose=.true.)
    !
    ! -- parse packages block
    if (isfound) then
      write (this%iout, '(/1x,a)') 'PROCESSING MVR PACKAGES'
      npak = 0
      do
        call this%parser%GetNextLine(endofblock)
        if (endofblock) exit
        call this%parser%GetStringCaps(word1)
        lloc = 1
        npak = npak + 1
        if (npak > this%maxpackages) then
          call store_error('ERROR.  MAXPACKAGES NOT SET LARGE ENOUGH.')
          call this%parser%StoreErrorUnit()
        end if
        if (this%iexgmvr == 0) then
          this%pckMemPaths(npak) = create_mem_path(this%name_model, word1)
          word = word1
        else
          call this%parser%GetStringCaps(word2)
          this%pckMemPaths(npak) = create_mem_path(word1, word2)
          word = word2
        end if
        this%paknames(npak) = trim(word)
        write (this%iout, '(3x,a,a)') 'INCLUDING PACKAGE: ', &
          trim(this%pckMemPaths(npak))
      end do
      write (this%iout, '(1x,a)') 'END OF MVR PACKAGES'
    else
      call store_error('ERROR.  REQUIRED PACKAGES BLOCK NOT FOUND.')
      call this%parser%StoreErrorUnit()
    end if
    !
    ! -- Check to make sure npak = this%maxpackages
    if (npak /= this%maxpackages) then
      write (errmsg, '(a, i0, a, i0, a)') &
        'ERROR.  NUMBER OF PACKAGES (', npak, ') DOES NOT EQUAL '// &
        'MAXPACKAGES (', this%maxpackages, ').'
      call store_error(errmsg)
      call this%parser%StoreErrorUnit()
    end if
    !
    ! -- Return
    return

Here is the call graph for this function:

set_mapped_id()

subroutine gwfmvrmodule::set_mapped_id

(

class(gwfmvrtype)

this

)

For the budget output, we don't write outlet number, instead we write the lake number. Normally the receiver number is the same as the feature number provided by the user. For moving water from a lake, the user specifies the outlet number, not the lake number, in the mover package. The iRchNrSrcMapped variable contains the lake number, not the outlet number, and is written to the budget files. For other packages, the iRchNrSrcMapped value is simply the well number, the stream reach, or the uzf cell number. This routine needs to be called each time a new set of movers is read. It can't be called from within mvr_rp because the iprmap isn't updated by lake until lak_rp, which is called after mvr_rp.

Definition at line 1367 of file gwf-mvr.f90.

    ! -- dummy
    class(GwfMvrType) :: this
    ! -- locals
    integer(I4B) :: i, mapped_id
    class(PackageMoverType), pointer :: pkg_mvr
    ! -- formats
    !
    ! -- set the feature maps
    allocate (pkg_mvr)
    do i = 1, this%nmvr
      call set_packagemover_pointer(pkg_mvr, this%mvr(i)%mem_path_src)
      mapped_id = pkg_mvr%iprmap(this%mvr(i)%iRchNrSrc)
      this%mvr(i)%iRchNrSrcMapped = mapped_id
    end do
    deallocate (pkg_mvr)
    !
    ! -- Return
    return

Here is the call graph for this function: