2014-11-25 22:53:37 +05:30
!--------------------------------------------------------------------------------------------------
2014-11-26 05:26:52 +05:30
! $Id$
2014-11-25 22:53:37 +05:30
!--------------------------------------------------------------------------------------------------
!> @author Pratheek Shanthraj, Max-Planck-Institut für Eisenforschung GmbH
!> @author Luv Sharma, Max-Planck-Institut für Eisenforschung GmbH
!> @brief material subroutine incoprorating isotropic brittle damage
!> @details to be done
!--------------------------------------------------------------------------------------------------
module damage_phaseField
use prec , only : &
pReal , &
pInt
implicit none
private
integer ( pInt ) , dimension ( : ) , allocatable , public , protected :: &
damage_phaseField_sizePostResults !< cumulative size of post results
integer ( pInt ) , dimension ( : , : ) , allocatable , target , public :: &
damage_phaseField_sizePostResult !< size of each post result output
character ( len = 64 ) , dimension ( : , : ) , allocatable , target , public :: &
damage_phaseField_output !< name of each post result output
integer ( pInt ) , dimension ( : ) , allocatable , target , public :: &
damage_phaseField_Noutput !< number of outputs per instance of this damage
real ( pReal ) , dimension ( : ) , allocatable , private :: &
damage_phaseField_aTol , &
damage_phaseField_surfaceEnergy , &
damage_phaseField_vacancyFormationEnergy
enum , bind ( c )
enumerator :: undefined_ID , &
local_damage_ID
end enum !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!11 ToDo
integer ( kind ( undefined_ID ) ) , dimension ( : , : ) , allocatable , private :: &
damage_phaseField_outputID !< ID of each post result output
public :: &
damage_phaseField_init , &
damage_phaseField_stateInit , &
damage_phaseField_aTolState , &
damage_phaseField_microstructure , &
damage_phaseField_getDamage , &
damage_phaseField_putLocalDamage , &
damage_phaseField_getLocalDamage , &
damage_phaseField_getDamageDiffusion33 , &
damage_phaseField_getDamagedC66 , &
damage_phaseField_postResults
contains
!--------------------------------------------------------------------------------------------------
!> @brief module initialization
!> @details reads in material parameters, allocates arrays, and does sanity checks
!--------------------------------------------------------------------------------------------------
subroutine damage_phaseField_init ( fileUnit )
use , intrinsic :: iso_fortran_env ! to get compiler_version and compiler_options (at least for gfortran 4.6 at the moment)
use debug , only : &
debug_level , &
debug_constitutive , &
debug_levelBasic
use IO , only : &
IO_read , &
IO_lc , &
IO_getTag , &
IO_isBlank , &
IO_stringPos , &
IO_stringValue , &
IO_floatValue , &
IO_intValue , &
IO_warning , &
IO_error , &
IO_timeStamp , &
IO_EOF
use material , only : &
phase_damage , &
phase_damageInstance , &
phase_Noutput , &
LOCAL_damage_phaseField_label , &
LOCAL_damage_phaseField_ID , &
material_phase , &
damageState , &
MATERIAL_partPhase
use numerics , only : &
worldrank , &
numerics_integrator
implicit none
integer ( pInt ) , intent ( in ) :: fileUnit
integer ( pInt ) , parameter :: MAXNCHUNKS = 7_pInt
integer ( pInt ) , dimension ( 1 + 2 * MAXNCHUNKS ) :: positions
integer ( pInt ) :: maxNinstance , mySize = 0_pInt , phase , instance , o
integer ( pInt ) :: sizeState , sizeDotState
integer ( pInt ) :: NofMyPhase
character ( len = 65536 ) :: &
tag = '' , &
line = ''
mainProcess : if ( worldrank == 0 ) then
write ( 6 , '(/,a)' ) ' <<<+- damage_' / / LOCAL_damage_phaseField_label / / ' init -+>>>'
2014-11-26 05:26:52 +05:30
write ( 6 , '(a)' ) ' $Id$'
2014-11-25 22:53:37 +05:30
write ( 6 , '(a15,a)' ) ' Current time: ' , IO_timeStamp ( )
#include "compilation_info.f90"
endif mainProcess
maxNinstance = int ( count ( phase_damage == LOCAL_damage_phaseField_ID ) , pInt )
if ( maxNinstance == 0_pInt ) return
if ( iand ( debug_level ( debug_constitutive ) , debug_levelBasic ) / = 0_pInt ) &
write ( 6 , '(a16,1x,i5,/)' ) '# instances:' , maxNinstance
allocate ( damage_phaseField_sizePostResults ( maxNinstance ) , source = 0_pInt )
allocate ( damage_phaseField_sizePostResult ( maxval ( phase_Noutput ) , maxNinstance ) , source = 0_pInt )
allocate ( damage_phaseField_output ( maxval ( phase_Noutput ) , maxNinstance ) )
damage_phaseField_output = ''
allocate ( damage_phaseField_outputID ( maxval ( phase_Noutput ) , maxNinstance ) , source = undefined_ID )
allocate ( damage_phaseField_Noutput ( maxNinstance ) , source = 0_pInt )
allocate ( damage_phaseField_surfaceEnergy ( maxNinstance ) , source = 0.0_pReal )
allocate ( damage_phaseField_vacancyFormationEnergy ( maxNinstance ) , source = 0.0_pReal )
allocate ( damage_phaseField_aTol ( maxNinstance ) , source = 0.0_pReal )
rewind ( fileUnit )
phase = 0_pInt
do while ( trim ( line ) / = IO_EOF . and . IO_lc ( IO_getTag ( line , '<' , '>' ) ) / = MATERIAL_partPhase ) ! wind forward to <phase>
line = IO_read ( fileUnit )
enddo
parsingFile : do while ( trim ( line ) / = IO_EOF ) ! read through sections of phase part
line = IO_read ( fileUnit )
if ( IO_isBlank ( line ) ) cycle ! skip empty lines
if ( IO_getTag ( line , '<' , '>' ) / = '' ) then ! stop at next part
line = IO_read ( fileUnit , . true . ) ! reset IO_read
exit
endif
if ( IO_getTag ( line , '[' , ']' ) / = '' ) then ! next phase section
phase = phase + 1_pInt ! advance phase section counter
cycle ! skip to next line
endif
if ( phase > 0_pInt ) then ; if ( phase_damage ( phase ) == LOCAL_damage_phaseField_ID ) then ! do not short-circuit here (.and. with next if statemen). It's not safe in Fortran
instance = phase_damageInstance ( phase ) ! which instance of my damage is present phase
positions = IO_stringPos ( line , MAXNCHUNKS )
tag = IO_lc ( IO_stringValue ( line , positions , 1_pInt ) ) ! extract key
select case ( tag )
case ( '(output)' )
select case ( IO_lc ( IO_stringValue ( line , positions , 2_pInt ) ) )
case ( 'local_damage' )
damage_phaseField_Noutput ( instance ) = damage_phaseField_Noutput ( instance ) + 1_pInt
damage_phaseField_outputID ( damage_phaseField_Noutput ( instance ) , instance ) = local_damage_ID
damage_phaseField_output ( damage_phaseField_Noutput ( instance ) , instance ) = &
IO_lc ( IO_stringValue ( line , positions , 2_pInt ) )
end select
case ( 'surfaceenergy' )
damage_phaseField_surfaceEnergy ( instance ) = IO_floatValue ( line , positions , 2_pInt )
case ( 'vacancyformationenergy' )
damage_phaseField_vacancyFormationEnergy ( instance ) = IO_floatValue ( line , positions , 2_pInt )
case ( 'atol_damage' )
damage_phaseField_aTol ( instance ) = IO_floatValue ( line , positions , 2_pInt )
end select
endif ; endif
enddo parsingFile
sanityChecks : do phase = 1_pInt , size ( phase_damage )
myPhase : if ( phase_damage ( phase ) == LOCAL_damage_phaseField_ID ) then
NofMyPhase = count ( material_phase == phase )
instance = phase_damageInstance ( phase )
! sanity checks
if ( damage_phaseField_aTol ( instance ) < 0.0_pReal ) &
damage_phaseField_aTol ( instance ) = 1.0e-3_pReal ! default absolute tolerance 1e-3
if ( damage_phaseField_surfaceEnergy ( instance ) < = 0.0_pReal ) &
call IO_error ( 211_pInt , el = instance , ext_msg = 'surfaceEnergy (' / / LOCAL_damage_phaseField_LABEL / / ')' )
endif myPhase
enddo sanityChecks
initializeInstances : do phase = 1_pInt , size ( phase_damage )
if ( phase_damage ( phase ) == LOCAL_damage_phaseField_ID ) then
NofMyPhase = count ( material_phase == phase )
instance = phase_damageInstance ( phase )
!--------------------------------------------------------------------------------------------------
! Determine size of postResults array
outputsLoop : do o = 1_pInt , damage_phaseField_Noutput ( instance )
select case ( damage_phaseField_outputID ( o , instance ) )
case ( local_damage_ID )
mySize = 1_pInt
end select
if ( mySize > 0_pInt ) then ! any meaningful output found
damage_phaseField_sizePostResult ( o , instance ) = mySize
damage_phaseField_sizePostResults ( instance ) = damage_phaseField_sizePostResults ( instance ) + mySize
endif
enddo outputsLoop
! Determine size of state array
2014-11-29 01:36:24 +05:30
sizeDotState = 0_pInt
2014-11-25 22:53:37 +05:30
sizeState = 2_pInt
damageState ( phase ) % sizeState = sizeState
damageState ( phase ) % sizeDotState = sizeDotState
damageState ( phase ) % sizePostResults = damage_phaseField_sizePostResults ( instance )
allocate ( damageState ( phase ) % aTolState ( sizeState ) , source = 0.0_pReal )
allocate ( damageState ( phase ) % state0 ( sizeState , NofMyPhase ) , source = 0.0_pReal )
allocate ( damageState ( phase ) % partionedState0 ( sizeState , NofMyPhase ) , source = 0.0_pReal )
allocate ( damageState ( phase ) % subState0 ( sizeState , NofMyPhase ) , source = 0.0_pReal )
allocate ( damageState ( phase ) % state ( sizeState , NofMyPhase ) , source = 0.0_pReal )
allocate ( damageState ( phase ) % state_backup ( sizeState , NofMyPhase ) , source = 0.0_pReal )
allocate ( damageState ( phase ) % dotState ( sizeDotState , NofMyPhase ) , source = 0.0_pReal )
allocate ( damageState ( phase ) % deltaState ( sizeDotState , NofMyPhase ) , source = 0.0_pReal )
allocate ( damageState ( phase ) % dotState_backup ( sizeDotState , NofMyPhase ) , source = 0.0_pReal )
if ( any ( numerics_integrator == 1_pInt ) ) then
allocate ( damageState ( phase ) % previousDotState ( sizeDotState , NofMyPhase ) , source = 0.0_pReal )
allocate ( damageState ( phase ) % previousDotState2 ( sizeDotState , NofMyPhase ) , source = 0.0_pReal )
endif
if ( any ( numerics_integrator == 4_pInt ) ) &
allocate ( damageState ( phase ) % RK4dotState ( sizeDotState , NofMyPhase ) , source = 0.0_pReal )
if ( any ( numerics_integrator == 5_pInt ) ) &
allocate ( damageState ( phase ) % RKCK45dotState ( 6 , sizeDotState , NofMyPhase ) , source = 0.0_pReal )
call damage_phaseField_stateInit ( phase )
call damage_phaseField_aTolState ( phase , instance )
endif
enddo initializeInstances
end subroutine damage_phaseField_init
!--------------------------------------------------------------------------------------------------
!> @brief sets the relevant NEW state values for a given instance of this damage
!--------------------------------------------------------------------------------------------------
subroutine damage_phaseField_stateInit ( phase )
use material , only : &
damageState
implicit none
integer ( pInt ) , intent ( in ) :: phase !< number specifying the phase of the damage
real ( pReal ) , dimension ( damageState ( phase ) % sizeState ) :: tempState
tempState = 1.0_pReal
damageState ( phase ) % state = spread ( tempState , 2 , size ( damageState ( phase ) % state ( 1 , : ) ) )
damageState ( phase ) % state0 = damageState ( phase ) % state
damageState ( phase ) % partionedState0 = damageState ( phase ) % state
end subroutine damage_phaseField_stateInit
!--------------------------------------------------------------------------------------------------
!> @brief sets the relevant state values for a given instance of this damage
!--------------------------------------------------------------------------------------------------
subroutine damage_phaseField_aTolState ( phase , instance )
use material , only : &
damageState
implicit none
integer ( pInt ) , intent ( in ) :: &
phase , &
instance ! number specifying the current instance of the damage
real ( pReal ) , dimension ( damageState ( phase ) % sizeState ) :: tempTol
tempTol = damage_phaseField_aTol ( instance )
damageState ( phase ) % aTolState = tempTol
end subroutine damage_phaseField_aTolState
!--------------------------------------------------------------------------------------------------
!> @brief calculates derived quantities from state
!--------------------------------------------------------------------------------------------------
2014-11-29 01:36:24 +05:30
subroutine damage_phaseField_microstructure ( C , Fe , Cv , subdt , ipc , ip , el )
2014-12-08 19:35:38 +05:30
use numerics , only : &
residualStiffness
2014-11-25 22:53:37 +05:30
use material , only : &
mappingConstitutive , &
phase_damageInstance , &
damageState
use math , only : &
math_mul33x33 , &
math_mul66x6 , &
math_Mandel33to6 , &
math_transpose33 , &
math_I3
2014-11-29 01:36:24 +05:30
use lattice , only : &
lattice_DamageMobility
2014-11-25 22:53:37 +05:30
implicit none
integer ( pInt ) , intent ( in ) :: &
ipc , & !< component-ID of integration point
ip , & !< integration point
el !< element
real ( pReal ) , intent ( in ) , dimension ( 3 , 3 ) :: &
Fe
real ( pReal ) , intent ( in ) , dimension ( 6 , 6 ) :: &
C
real ( pReal ) , intent ( in ) :: &
Cv
2014-11-29 01:36:24 +05:30
real ( pReal ) , intent ( in ) :: &
subdt
2014-11-25 22:53:37 +05:30
integer ( pInt ) :: &
phase , constituent , instance
real ( pReal ) :: &
strain ( 6 ) , &
stress ( 6 )
phase = mappingConstitutive ( 2 , ipc , ip , el )
constituent = mappingConstitutive ( 1 , ipc , ip , el )
instance = phase_damageInstance ( phase )
strain = 0.5_pReal * math_Mandel33to6 ( math_mul33x33 ( math_transpose33 ( Fe ) , Fe ) - math_I3 )
stress = math_mul66x6 ( C , strain )
damageState ( phase ) % state ( 2 , constituent ) = &
2014-12-08 19:35:38 +05:30
max ( residualStiffness , &
min ( damageState ( phase ) % state0 ( 2 , constituent ) , &
( 1.0_pReal - Cv ) * damage_phaseField_surfaceEnergy ( instance ) / &
( 2.0_pReal * ( sum ( abs ( stress * strain ) ) + Cv * damage_phaseField_vacancyFormationEnergy ( instance ) ) ) ) )
2014-11-29 01:36:24 +05:30
damageState ( phase ) % state ( 1 , constituent ) = &
2014-12-08 19:35:38 +05:30
damageState ( phase ) % state ( 2 , constituent ) + &
( damageState ( phase ) % subState0 ( 1 , constituent ) - damageState ( phase ) % state ( 2 , constituent ) ) * &
exp ( - subdt / ( damageState ( phase ) % state ( 2 , constituent ) * lattice_DamageMobility ( phase ) ) )
2014-11-25 22:53:37 +05:30
end subroutine damage_phaseField_microstructure
!--------------------------------------------------------------------------------------------------
!> @brief returns damage
!--------------------------------------------------------------------------------------------------
function damage_phaseField_getDamage ( ipc , ip , el )
use material , only : &
material_homog , &
mappingHomogenization , &
2014-11-26 17:02:50 +05:30
mappingConstitutive , &
damageState , &
2014-11-25 22:53:37 +05:30
fieldDamage , &
field_damage_type , &
FIELD_DAMAGE_LOCAL_ID , &
FIELD_DAMAGE_NONLOCAL_ID
implicit none
integer ( pInt ) , intent ( in ) :: &
ipc , & !< grain number
ip , & !< integration point number
el !< element number
real ( pReal ) :: damage_phaseField_getDamage
select case ( field_damage_type ( material_homog ( ip , el ) ) )
case ( FIELD_DAMAGE_LOCAL_ID )
2014-11-26 17:02:50 +05:30
damage_phaseField_getDamage = damageState ( mappingConstitutive ( 2 , ipc , ip , el ) ) % &
state0 ( 1 , mappingConstitutive ( 1 , ipc , ip , el ) )
2014-11-25 22:53:37 +05:30
case ( FIELD_DAMAGE_NONLOCAL_ID )
damage_phaseField_getDamage = fieldDamage ( material_homog ( ip , el ) ) % &
field ( 1 , mappingHomogenization ( 1 , ip , el ) ) ! Taylor type
end select
end function damage_phaseField_getDamage
!--------------------------------------------------------------------------------------------------
!> @brief returns temperature based on local damage model state layout
!--------------------------------------------------------------------------------------------------
subroutine damage_phaseField_putLocalDamage ( ipc , ip , el , localDamage )
use material , only : &
mappingConstitutive , &
damageState
implicit none
integer ( pInt ) , intent ( in ) :: &
ipc , & !< grain number
ip , & !< integration point number
el !< element number
real ( pReal ) , intent ( in ) :: localDamage
damageState ( mappingConstitutive ( 2 , ipc , ip , el ) ) % state ( 1 , mappingConstitutive ( 1 , ipc , ip , el ) ) = &
localDamage
end subroutine damage_phaseField_putLocalDamage
!--------------------------------------------------------------------------------------------------
!> @brief returns local damage
!--------------------------------------------------------------------------------------------------
function damage_phaseField_getLocalDamage ( ipc , ip , el )
use material , only : &
mappingConstitutive , &
damageState
implicit none
integer ( pInt ) , intent ( in ) :: &
ipc , & !< grain number
ip , & !< integration point number
el !< element number
real ( pReal ) :: damage_phaseField_getLocalDamage
damage_phaseField_getLocalDamage = &
damageState ( mappingConstitutive ( 2 , ipc , ip , el ) ) % state ( 1 , mappingConstitutive ( 1 , ipc , ip , el ) )
end function damage_phaseField_getLocalDamage
!--------------------------------------------------------------------------------------------------
!> @brief returns brittle damage diffusion tensor
!--------------------------------------------------------------------------------------------------
function damage_phaseField_getDamageDiffusion33 ( ipc , ip , el )
use lattice , only : &
lattice_DamageDiffusion33
use material , only : &
mappingConstitutive , &
damageState
implicit none
integer ( pInt ) , intent ( in ) :: &
ipc , & !< grain number
ip , & !< integration point number
el !< element number
real ( pReal ) , dimension ( 3 , 3 ) :: &
damage_phaseField_getDamageDiffusion33
integer ( pInt ) :: &
phase , constituent
phase = mappingConstitutive ( 2 , ipc , ip , el )
constituent = mappingConstitutive ( 1 , ipc , ip , el )
damage_phaseField_getDamageDiffusion33 = &
lattice_DamageDiffusion33 ( 1 : 3 , 1 : 3 , phase )
end function damage_phaseField_getDamageDiffusion33
!--------------------------------------------------------------------------------------------------
!> @brief returns brittle damaged stiffness tensor
!--------------------------------------------------------------------------------------------------
function damage_phaseField_getDamagedC66 ( C , ipc , ip , el )
use material , only : &
2014-11-26 05:26:52 +05:30
mappingConstitutive
2014-11-25 22:53:37 +05:30
implicit none
integer ( pInt ) , intent ( in ) :: &
ipc , & !< grain number
ip , & !< integration point number
el !< element number
real ( pReal ) , intent ( in ) , dimension ( 6 , 6 ) :: &
C
real ( pReal ) , dimension ( 6 , 6 ) :: &
damage_phaseField_getDamagedC66
integer ( pInt ) :: &
phase , constituent
real ( pReal ) :: &
damage
phase = mappingConstitutive ( 2 , ipc , ip , el )
constituent = mappingConstitutive ( 1 , ipc , ip , el )
damage = damage_phaseField_getDamage ( ipc , ip , el )
damage_phaseField_getDamagedC66 = &
damage * damage * C
end function damage_phaseField_getDamagedC66
!--------------------------------------------------------------------------------------------------
!> @brief return array of constitutive results
!--------------------------------------------------------------------------------------------------
function damage_phaseField_postResults ( ipc , ip , el )
use material , only : &
mappingConstitutive , &
phase_damageInstance , &
damageState
implicit none
integer ( pInt ) , intent ( in ) :: &
ipc , & !< component-ID of integration point
ip , & !< integration point
el !< element
real ( pReal ) , dimension ( damage_phaseField_sizePostResults ( phase_damageInstance ( mappingConstitutive ( 2 , ipc , ip , el ) ) ) ) :: &
damage_phaseField_postResults
integer ( pInt ) :: &
instance , phase , constituent , o , c
phase = mappingConstitutive ( 2 , ipc , ip , el )
constituent = mappingConstitutive ( 1 , ipc , ip , el )
instance = phase_damageInstance ( phase )
c = 0_pInt
damage_phaseField_postResults = 0.0_pReal
do o = 1_pInt , damage_phaseField_Noutput ( instance )
select case ( damage_phaseField_outputID ( o , instance ) )
case ( local_damage_ID )
damage_phaseField_postResults ( c + 1_pInt ) = damageState ( phase ) % state ( 2 , constituent )
c = c + 1
end select
enddo
end function damage_phaseField_postResults
end module damage_phaseField