swfflwmodule Module Reference

This module contains the FLW package methods. More...

Data Types
type	swfflwtype

Functions/Subroutines
subroutine, public	flw_create (packobj, id, ibcnum, inunit, iout, namemodel, pakname, mempath)
	@ brief Create a new package object More...
subroutine	flw_allocate_scalars (this)
	@ brief Allocate scalars More...
subroutine	flw_allocate_arrays (this, nodelist, auxvar)
	@ brief Allocate arrays More...
subroutine	flw_da (this)
	@ brief Deallocate package memory More...
subroutine	flw_options (this)
	@ brief Source additional options for package More...
subroutine	log_flw_options (this, found)
	@ brief Log SWF specific package options More...
subroutine	flw_rp (this)
	@ brief SWF read and prepare More...
subroutine	flw_cf (this)
	@ brief Formulate the package hcof and rhs terms. More...
subroutine	flw_fc (this, rhs, ia, idxglo, matrix_sln)
	@ brief Copy hcof and rhs terms into solution. More...
subroutine	define_listlabel (this)
	@ brief Define the list label for the package More...
logical function	flw_obs_supported (this)
	Determine if observations are supported. More...
subroutine	flw_df_obs (this)
	Define the observation types available in the package. More...
subroutine	flw_bd_obs (this)
	Save observations for the package. More...
subroutine	flw_rp_ts (this)
	Assign time series links for the package. More...
real(dp) function	q_mult (this, row)
real(dp) function	flw_bound_value (this, col, row)
	@ brief Return a bound value More...

Variables
character(len=lenftype)	ftype = 'FLW'
	package ftype More...
character(len=16)	text = ' FLW'
	package flow text string More...

Detailed Description

This module can be used to represent inflow to streams. It is designed similarly to the GWF WEL package.

Function/Subroutine Documentation

define_listlabel()

subroutine swfflwmodule::define_listlabel ( class(swfflwtype), intent(inout)  this )

private

Method defined the list label for the FLW package. The list label is the heading that is written to iout when PRINT_INPUT option is used.

Parameters

[in,out]

this

SwfFlwType object

Definition at line 334 of file swf-flw.f90.

    ! -- dummy variables
    class(SwfFlwType), intent(inout) :: this !< SwfFlwType  object
    !
    ! -- create the header list label
    this%listlabel = trim(this%filtyp)//' NO.'
    if (this%dis%ndim == 3) then
      write (this%listlabel, '(a, a7)') trim(this%listlabel), 'LAYER'
      write (this%listlabel, '(a, a7)') trim(this%listlabel), 'ROW'
      write (this%listlabel, '(a, a7)') trim(this%listlabel), 'COL'
    elseif (this%dis%ndim == 2) then
      write (this%listlabel, '(a, a7)') trim(this%listlabel), 'LAYER'
      write (this%listlabel, '(a, a7)') trim(this%listlabel), 'CELL2D'
    else
      write (this%listlabel, '(a, a7)') trim(this%listlabel), 'NODE'
    end if
    write (this%listlabel, '(a, a16)') trim(this%listlabel), 'FLOW RATE'
    if (this%inamedbound == 1) then
      write (this%listlabel, '(a, a16)') trim(this%listlabel), 'BOUNDARY NAME'
    end if
    !
    ! -- return
    return

flw_allocate_arrays()

subroutine swfflwmodule::flw_allocate_arrays	(	class(swfflwtype)	this,
		integer(i4b), dimension(:), optional, pointer, contiguous	nodelist,
		real(dp), dimension(:, :), optional, pointer, contiguous	auxvar
	)

Allocate and initialize arrays for the SWF package

Definition at line 133 of file swf-flw.f90.

    ! -- modules
    use memorymanagermodule, only: mem_allocate, mem_setptr, mem_checkin
    ! -- dummy
    class(SwfFlwType) :: this
    integer(I4B), dimension(:), pointer, contiguous, optional :: nodelist
    real(DP), dimension(:, :), pointer, contiguous, optional :: auxvar
    ! -- local
    !
    ! -- call BndExtType allocate scalars
    call this%BndExtType%allocate_arrays(nodelist, auxvar)
    !
    ! -- set q array input context pointer
    call mem_setptr(this%q, 'Q', this%input_mempath)
    !
    ! -- checkin q array input context pointer
    call mem_checkin(this%q, 'Q', this%memoryPath, &
                     'Q', this%input_mempath)
    !
    ! -- return
    return

flw_allocate_scalars()

subroutine swfflwmodule::flw_allocate_scalars ( class(swfflwtype)  this )

private

Allocate and initialize scalars for the FLW package. The base model allocate scalars method is also called.

Parameters

this	SwfFlwType object

Definition at line 109 of file swf-flw.f90.

    ! -- modules
    use memorymanagermodule, only: mem_allocate
    ! -- dummy variables
    class(SwfFlwType) :: this !< SwfFlwType object
    !
    ! -- call base type allocate scalars
    call this%BndExtType%allocate_scalars()
    !
    ! -- allocate the object and assign values to object variables
    ! none for this package
    !
    ! -- Set values
    ! none for this package
    !
    ! -- return
    return

flw_bd_obs()

subroutine swfflwmodule::flw_bd_obs ( class(swfflwtype)  this )

private

Method to save simulated values for the FLW package.

Parameters

this	SwfFlwType object

Definition at line 409 of file swf-flw.f90.

    ! -- dummy variables
    class(SwfFlwType) :: this !< SwfFlwType  object
    ! -- local variables
    integer(I4B) :: i
    integer(I4B) :: n
    integer(I4B) :: jj
    real(DP) :: v
    type(ObserveType), pointer :: obsrv => null()
    !
    ! -- clear the observations
    call this%obs%obs_bd_clear()
    !
    ! -- Save simulated values for all of package's observations.
    do i = 1, this%obs%npakobs
      obsrv => this%obs%pakobs(i)%obsrv
      if (obsrv%BndFound) then
        do n = 1, obsrv%indxbnds_count
          v = dnodata
          jj = obsrv%indxbnds(n)
          select case (obsrv%ObsTypeId)
          case ('TO-MVR')
            if (this%imover == 1) then
              v = this%pakmvrobj%get_qtomvr(jj)
              if (v > dzero) then
                v = -v
              end if
            end if
          case ('FLW')
            v = this%simvals(jj)
          case default
            errmsg = 'Unrecognized observation type: '//trim(obsrv%ObsTypeId)
            call store_error(errmsg)
          end select
          call this%obs%SaveOneSimval(obsrv, v)
        end do
      else
        call this%obs%SaveOneSimval(obsrv, dnodata)
      end if
    end do
    !
    ! -- return
    return

Here is the call graph for this function:

flw_bound_value()

real(dp) function swfflwmodule::flw_bound_value	(	class(swfflwtype), intent(inout)	this,
		integer(i4b), intent(in)	col,
		integer(i4b), intent(in)	row
	)

Return a bound value associated with an ncolbnd index and row.

Parameters

[in,out]

this

BndExtType object

Definition at line 509 of file swf-flw.f90.

    ! -- modules
    use constantsmodule, only: dzero
    ! -- dummy variables
    class(SwfFlwType), intent(inout) :: this !< BndExtType object
    integer(I4B), intent(in) :: col
    integer(I4B), intent(in) :: row
    ! -- result
    real(DP) :: bndval
    !
    select case (col)
    case (1)
      bndval = this%q_mult(row)
    case default
      errmsg = 'Programming error. FLW bound value requested column '&
               &'outside range of ncolbnd (1).'
      call store_error(errmsg)
      call store_error_filename(this%input_fname)
    end select
    !
    ! -- return
    return

Here is the call graph for this function:

flw_cf()

subroutine swfflwmodule::flw_cf

(

class(swfflwtype)

this

)

Formulate the hcof and rhs terms for the FLW package that will be added to the coefficient matrix and right-hand side vector.

Parameters

this	SwfFlwType object

Definition at line 262 of file swf-flw.f90.

    ! -- dummy variables
    class(SwfFlwType) :: this !< SwfFlwType  object
    ! -- local variables
    integer(I4B) :: i, node
    real(DP) :: q
    !
    ! -- Return if no inflows
    if (this%nbound == 0) return
    !
    ! -- Calculate hcof and rhs for each flw entry
    do i = 1, this%nbound
      node = this%nodelist(i)
      this%hcof(i) = dzero
      if (this%ibound(node) <= 0) then
        this%rhs(i) = dzero
        cycle
      end if
      q = this%q_mult(i)
      this%rhs(i) = -q
    end do
    !
    return

flw_create()

subroutine, public swfflwmodule::flw_create	(	class(bndtype), pointer	packobj,
		integer(i4b), intent(in)	id,
		integer(i4b), intent(in)	ibcnum,
		integer(i4b), intent(in)	inunit,
		integer(i4b), intent(in)	iout,
		character(len=*), intent(in)	namemodel,
		character(len=*), intent(in)	pakname,
		character(len=*), intent(in)	mempath
	)

Create a new FLW Package object

Parameters

	packobj	pointer to default package type
[in]	id	package id
[in]	ibcnum	boundary condition number
[in]	inunit	unit number of FLW package input file
[in]	iout	unit number of model listing file
[in]	namemodel	model name
[in]	pakname	package name
[in]	mempath	input mempath

Definition at line 63 of file swf-flw.f90.

    ! -- dummy variables
    class(BndType), pointer :: packobj !< pointer to default package type
    integer(I4B), intent(in) :: id !< package id
    integer(I4B), intent(in) :: ibcnum !< boundary condition number
    integer(I4B), intent(in) :: inunit !< unit number of FLW package input file
    integer(I4B), intent(in) :: iout !< unit number of model listing file
    character(len=*), intent(in) :: namemodel !< model name
    character(len=*), intent(in) :: pakname !< package name
    character(len=*), intent(in) :: mempath !< input mempath
    ! -- local variables
    type(SwfFlwType), pointer :: flwobj
    !
    ! -- allocate the object and assign values to object variables
    allocate (flwobj)
    packobj => flwobj
    !
    ! -- create name and memory path
    call packobj%set_names(ibcnum, namemodel, pakname, ftype, mempath)
    packobj%text = text
    !
    ! -- allocate scalars
    call flwobj%allocate_scalars()
    !
    ! -- initialize package
    call packobj%pack_initialize()
 
    packobj%inunit = inunit
    packobj%iout = iout
    packobj%id = id
    packobj%ibcnum = ibcnum
    packobj%ncolbnd = 1
    packobj%iscloc = 1
    packobj%ictMemPath = ''
    !
    ! -- return
    return

Here is the caller graph for this function:

flw_da()

subroutine swfflwmodule::flw_da

(

class(swfflwtype)

this

)

Deallocate SWF package scalars and arrays.

Parameters

this	SwfFlwType object

Definition at line 161 of file swf-flw.f90.

    ! -- modules
    use memorymanagermodule, only: mem_deallocate
    ! -- dummy variables
    class(SwfFlwType) :: this !< SwfFlwType object
    !
    ! -- Deallocate parent package
    call this%BndExtType%bnd_da()
    !
    ! -- scalars
    call mem_deallocate(this%q, 'Q', this%memoryPath)
    !
    ! -- return
    return

flw_df_obs()

subroutine swfflwmodule::flw_df_obs ( class(swfflwtype)  this )

private

Method to define the observation types available in the FLW package.

Parameters

this	SwfFlwType object

Definition at line 385 of file swf-flw.f90.

    ! -- dummy variables
    class(SwfFlwType) :: this !< SwfFlwType  object
    ! -- local variables
    integer(I4B) :: indx
    !
    ! -- initialize observations
    call this%obs%StoreObsType('flw', .true., indx)
    this%obs%obsData(indx)%ProcessIdPtr => defaultobsidprocessor
    !
    ! -- Store obs type and assign procedure pointer
    !    for to-mvr observation type.
    call this%obs%StoreObsType('to-mvr', .true., indx)
    this%obs%obsData(indx)%ProcessIdPtr => defaultobsidprocessor
    !
    ! -- return
    return

Here is the call graph for this function:

flw_fc()

subroutine swfflwmodule::flw_fc ( class(swfflwtype)  this, real(dp), dimension(:), intent(inout)  rhs, integer(i4b), dimension(:), intent(in)  ia, integer(i4b), dimension(:), intent(in)  idxglo, class(matrixbasetype), pointer  matrix_sln  )

private

Add the hcof and rhs terms for the FLW package to the coefficient matrix and right-hand side vector.

Parameters

	this	SwfFlwType object
[in,out]	rhs	right-hand side vector for model
[in]	ia	solution CRS row pointers
[in]	idxglo	mapping vector for model (local) to solution (global)
	matrix_sln	solution coefficient matrix

Definition at line 293 of file swf-flw.f90.

    ! -- dummy variables
    class(SwfFlwType) :: this !< SwfFlwType  object
    real(DP), dimension(:), intent(inout) :: rhs !< right-hand side vector for model
    integer(I4B), dimension(:), intent(in) :: ia !< solution CRS row pointers
    integer(I4B), dimension(:), intent(in) :: idxglo !< mapping vector for model (local) to solution (global)
    class(MatrixBaseType), pointer :: matrix_sln !< solution coefficient matrix
    ! -- local variables
    integer(I4B) :: i
    integer(I4B) :: n
    integer(I4B) :: ipos
    !
    ! -- pakmvrobj fc
    if (this%imover == 1) then
      call this%pakmvrobj%fc()
    end if
    !
    ! -- Copy package rhs and hcof into solution rhs and amat
    do i = 1, this%nbound
      n = this%nodelist(i)
      rhs(n) = rhs(n) + this%rhs(i)
      ipos = ia(n)
      call matrix_sln%add_value_pos(idxglo(ipos), this%hcof(i))
      !
      ! -- If mover is active and this flw item is discharging,
      !    store available water (as positive value).
      if (this%imover == 1 .and. this%rhs(i) > dzero) then
        call this%pakmvrobj%accumulate_qformvr(i, this%rhs(i))
      end if
    end do
    !
    ! -- return
    return

flw_obs_supported()

logical function swfflwmodule::flw_obs_supported ( class(swfflwtype)  this )

private

Function to determine if observations are supported by the FLW package. Observations are supported by the FLW package.

Returns

flw_obs_supported boolean indicating if observations are supported

Parameters

this	SwfFlwType object

Definition at line 369 of file swf-flw.f90.

    ! -- dummy variables
    class(SwfFlwType) :: this !< SwfFlwType  object
    !
    ! -- set boolean
    flw_obs_supported = .true.
    !
    ! -- return
    return

flw_options()

subroutine swfflwmodule::flw_options

(

class(swfflwtype), intent(inout)

this

)

Source additional options for SWF package.

Parameters

[in,out]

this

SwfFlwType object

Definition at line 182 of file swf-flw.f90.

    ! -- modules
    use inputoutputmodule, only: urword
    use memorymanagerextmodule, only: mem_set_value
    use swfflwinputmodule, only: swfflwparamfoundtype
    ! -- dummy variables
    class(SwfFlwType), intent(inout) :: this !< SwfFlwType object
    ! -- local variables
    type(SwfFlwParamFoundType) :: found
    ! -- formats
    !
    ! -- source base BndExtType options
    call this%BndExtType%source_options()
    !
    ! -- source options from input context
    ! none
    !
    ! -- log SWF specific options
    call this%log_flw_options(found)
    !
    ! -- return
    return

Here is the call graph for this function:

flw_rp()

subroutine swfflwmodule::flw_rp

(

class(swfflwtype), intent(inout)

this

)

Definition at line 236 of file swf-flw.f90.

    use tdismodule, only: kper
    ! -- dummy
    class(SwfFlwType), intent(inout) :: this
    ! -- local
    !
    if (this%iper /= kper) return
    !
    ! -- Call the parent class read and prepare
    call this%BndExtType%bnd_rp()
    !
    ! -- Write the list to iout if requested
    if (this%iprpak /= 0) then
      call this%write_list()
    end if
    !
    ! -- return
    return

flw_rp_ts()

subroutine swfflwmodule::flw_rp_ts ( class(swfflwtype), intent(inout)  this )

private

Assign the time series links for the FLW package. Only the Q variable can be defined with time series.

Parameters

[in,out]

this

SwfFlwType object

Definition at line 462 of file swf-flw.f90.

    ! -- dummy variables
    class(SwfFlwType), intent(inout) :: this !< SwfFlwType  object
    ! -- local variables
    integer(I4B) :: i, nlinks
    type(TimeSeriesLinkType), pointer :: tslink => null()
    !
    ! -- set up the time series links
    nlinks = this%TsManager%boundtslinks%Count()
    do i = 1, nlinks
      tslink => gettimeserieslinkfromlist(this%TsManager%boundtslinks, i)
      if (associated(tslink)) then
        if (tslink%JCol == 1) then
          tslink%Text = 'Q'
        end if
      end if
    end do
    !
    ! -- return
    return

Here is the call graph for this function:

log_flw_options()

subroutine swfflwmodule::log_flw_options	(	class(swfflwtype), intent(inout)	this,
		type(swfflwparamfoundtype), intent(in)	found
	)

Parameters

[in,out]

this

BndExtType object

Definition at line 208 of file swf-flw.f90.

    ! -- modules
    use swfflwinputmodule, only: swfflwparamfoundtype
    ! -- dummy variables
    class(SwfFlwType), intent(inout) :: this !< BndExtType object
    type(SwfFlwParamFoundType), intent(in) :: found
    ! -- local variables
    ! -- format
    !
    ! -- log found options
    write (this%iout, '(/1x,a)') 'PROCESSING '//trim(adjustl(this%text)) &
      //' OPTIONS'
    !
    ! if (found%mover) then
    !   write (this%iout, '(4x,A)') 'MOVER OPTION ENABLED'
    ! end if
    !
    ! -- close logging block
    write (this%iout, '(1x,a)') &
      'END OF '//trim(adjustl(this%text))//' OPTIONS'
    !
    ! -- return
    return

q_mult()

real(dp) function swfflwmodule::q_mult ( class(swfflwtype), intent(inout)  this, integer(i4b), intent(in)  row  )

private

Parameters

[in,out]

this

BndExtType object

Definition at line 484 of file swf-flw.f90.

    ! -- modules
    use constantsmodule, only: dzero
    ! -- dummy variables
    class(SwfFlwType), intent(inout) :: this !< BndExtType object
    integer(I4B), intent(in) :: row
    ! -- result
    real(DP) :: q
    !
    if (this%iauxmultcol > 0) then
      q = this%q(row) * this%auxvar(this%iauxmultcol, row)
    else
      q = this%q(row)
    end if
    !
    ! -- return
    return

Variable Documentation

ftype

character(len=lenftype) swfflwmodule::ftype = 'FLW'

private

Definition at line 31 of file swf-flw.f90.

  character(len=LENFTYPE) :: ftype = 'FLW' !< package ftype

text

character(len=16) swfflwmodule::text = ' FLW'

private

Definition at line 32 of file swf-flw.f90.

  character(len=16) :: text = '             FLW' !< package flow text string