swiftest_discard.f90 Source File


This file depends on

sourcefile~~swiftest_discard.f90~~EfferentGraph sourcefile~swiftest_discard.f90 swiftest_discard.f90 sourcefile~swiftest_module.f90 swiftest_module.f90 sourcefile~swiftest_discard.f90->sourcefile~swiftest_module.f90 sourcefile~operator_module.f90 operator_module.f90 sourcefile~swiftest_module.f90->sourcefile~operator_module.f90 sourcefile~lambda_function_module.f90 lambda_function_module.f90 sourcefile~swiftest_module.f90->sourcefile~lambda_function_module.f90 sourcefile~base_module.f90 base_module.f90 sourcefile~swiftest_module.f90->sourcefile~base_module.f90 sourcefile~collision_module.f90 collision_module.f90 sourcefile~swiftest_module.f90->sourcefile~collision_module.f90 sourcefile~encounter_module.f90 encounter_module.f90 sourcefile~swiftest_module.f90->sourcefile~encounter_module.f90 sourcefile~walltime_module.f90 walltime_module.f90 sourcefile~swiftest_module.f90->sourcefile~walltime_module.f90 sourcefile~io_progress_bar_module.f90 io_progress_bar_module.f90 sourcefile~swiftest_module.f90->sourcefile~io_progress_bar_module.f90 sourcefile~netcdf_io_module.f90 netcdf_io_module.f90 sourcefile~swiftest_module.f90->sourcefile~netcdf_io_module.f90 sourcefile~solver_module.f90 solver_module.f90 sourcefile~swiftest_module.f90->sourcefile~solver_module.f90 sourcefile~coarray_module.f90 coarray_module.f90 sourcefile~base_module.f90->sourcefile~coarray_module.f90 sourcefile~collision_module.f90->sourcefile~base_module.f90 sourcefile~collision_module.f90->sourcefile~encounter_module.f90 sourcefile~encounter_module.f90->sourcefile~base_module.f90 sourcefile~encounter_module.f90->sourcefile~netcdf_io_module.f90 sourcefile~walltime_module.f90->sourcefile~base_module.f90 sourcefile~io_progress_bar_module.f90->sourcefile~base_module.f90 sourcefile~netcdf_io_module.f90->sourcefile~base_module.f90 sourcefile~solver_module.f90->sourcefile~lambda_function_module.f90 sourcefile~solver_module.f90->sourcefile~base_module.f90

Contents

Source Code


Source Code

! Copyright 2024 - The Minton Group at Purdue University
! This file is part of Swiftest.
! Swiftest is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
! as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
! Swiftest is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty 
! of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
! You should have received a copy of the GNU General Public License along with Swiftest. 
! If not, see: https://www.gnu.org/licenses. 

submodule (swiftest) s_swiftest_discard
contains

   module subroutine swiftest_discard_system(self, param)
      !! author: David A. Minton
      !!
      !! Calls the discard methods for each body class and then the write method if any discards were detected
      !!
      implicit none
      ! Arguments
      class(swiftest_nbody_system), intent(inout) :: self   
         !! Swiftest nbody_system object
      class(swiftest_parameters),   intent(inout) :: param  
         !! Current run configuration parameters
      ! Internals
      logical :: lpl_check, ltp_check
      logical :: ldiscard_pl = .false. 
      logical :: ldiscard_tp = .false.

      lpl_check = allocated(self%pl_discards) .and. self%pl%nbody > 0
      ltp_check = allocated(self%tp_discards) .and. self%tp%nbody > 0

      associate(nbody_system => self,&
                tp => self%tp, &
                pl => self%pl,&
                npl => self%pl%nbody, &
                ntp => self%tp%nbody)
         if (lpl_check .and. npl > 0) then
            call pl%discard(nbody_system, param)
            ldiscard_pl = any(pl%ldiscard(:))
         end if
            
         if (ltp_check .and. ntp > 0) then
            call tp%discard(nbody_system, param)
            ldiscard_tp = any(tp%ldiscard(:)) 
         end if

         if (ldiscard_pl) call pl%rearray(nbody_system, param) 
         if (ldiscard_tp) call tp%rearray(nbody_system, param)
      end associate

      return
   end subroutine swiftest_discard_system


   module subroutine swiftest_discard_pl(self, nbody_system, param)
      !! author: David A. Minton
      !!
      !! Placeholder method for discarding massive bodies. This method does nothing except to ensure that the discard flag is set 
      !! to false. This method is intended to be overridden by more advanced integrators.
      implicit none
      ! Arguments
      class(swiftest_pl),           intent(inout) :: self   
         !! Swiftest massive body object
      class(swiftest_nbody_system), intent(inout) :: nbody_system 
         !! Swiftest nbody system object
      class(swiftest_parameters),   intent(inout) :: param  
         !! Current run configuration parameter

      if (self%nbody == 0) return
      associate(pl => self, cb => nbody_system%cb)
         pl%ldiscard = pl%status(:) /= ACTIVE
         if ((param%rmin >= 0.0_DP) .or. (param%rmax >= 0.0_DP) .or. &
             (param%rmaxu >= 0.0_DP) .or. ((param%qmin >= 0.0_DP) .and. (param%qmin_coord == "BARY"))) call pl%h2b(cb) 

         if ((param%rmin >= 0.0_DP) .or. &
             (param%rmax >= 0.0_DP) .or. & 
             (param%rmaxu >= 0.0_DP)) call swiftest_discard_cb_body(pl, nbody_system, param)
         if (param%qmin >= 0.0_DP) call swiftest_discard_peri_body(pl, nbody_system, param)
      end associate

      return
   end subroutine swiftest_discard_pl


   module subroutine swiftest_discard_tp(self, nbody_system, param)
      !! author: David A. Minton
      !!
      !! Check to see if particles should be discarded based on their positions relative to the massive bodies
      !! 
      !! Adapted from David E. Kaufmann's Swifter routine: discard.f90
      !! Adapted from Hal Levison's Swift routine discard.
      implicit none
      ! Arguments
      class(swiftest_tp),           intent(inout) :: self   
         !! Swiftest test particle object
      class(swiftest_nbody_system), intent(inout) :: nbody_system 
         !! Swiftest nbody system object
      class(swiftest_parameters),   intent(inout) :: param  
         !! Current run configuration parameter

      if (self%nbody == 0) return

      associate(tp => self, cb => nbody_system%cb, pl => nbody_system%pl)
         tp%ldiscard = tp%status(:) /= ACTIVE
         if ((param%rmin >= 0.0_DP) .or. (param%rmax >= 0.0_DP) .or. &
             (param%rmaxu >= 0.0_DP) .or. ((param%qmin >= 0.0_DP) .and. (param%qmin_coord == "BARY"))) then
            call pl%h2b(cb) 
            call tp%h2b(cb) 
         end if

         if ((param%rmin >= 0.0_DP) .or. &
             (param%rmax >= 0.0_DP) .or. & 
             (param%rmaxu >= 0.0_DP)) call swiftest_discard_cb_body(tp, nbody_system, param)
         if (param%qmin >= 0.0_DP) call swiftest_discard_peri_body(tp, nbody_system, param)
         if (param%lclose) call swiftest_discard_pl_tp(tp, nbody_system, param)
      end associate

      return
   end subroutine swiftest_discard_tp


   subroutine swiftest_discard_cb_body(body, nbody_system, param)
      !! author: David A. Minton
      !!
      !!  Check to see if bodies (massive or test particle) should be discarded based on their positions relative to the Sun or 
      !!  because they are unbound from the nbody_system
      !!
      !! Adapted from David E. Kaufmann's Swifter routine: discard_sun.f90
      !! Adapted from Hal Levison's Swift routine discard_sun.f
      implicit none
      ! Arguments
      class(swiftest_body),         intent(inout) :: body   
         !! Swiftest body object
      class(swiftest_nbody_system), intent(inout) :: nbody_system 
         !! Swiftest nbody system object
      class(swiftest_parameters),   intent(inout) :: param  
         !! Current run configuration parameters
      ! Internals
      integer(I4B)        :: i
      real(DP)            :: energy, vb2, rb2, rh2, rmin2, rmax2, rmaxu2
      character(len=STRMAX) :: idstr, timestr, message
      logical, allocatable, dimension(:) :: ldiscard

      associate(nbody => body%nbody, &
                cb => nbody_system%cb, &
                Gmtot => nbody_system%Gmtot, &
                t => nbody_system%t, &
                collider => nbody_system%collider, &
                impactors => nbody_system%collider%impactors, &
                collision_history => nbody_system%collision_history)

         rmin2 = max(param%rmin * param%rmin, cb%radius * cb%radius)
         rmax2 = param%rmax**2
         rmaxu2 = param%rmaxu**2
         do i = 1, nbody
            if (body%status(i) == ACTIVE) then
               rh2 = dot_product(body%rh(:, i), body%rh(:, i))
               if ((param%rmax >= 0.0_DP) .and. (rh2 > rmax2)) then
                  body%status(i) = DISCARDED_RMAX
                  write(idstr, *) body%id(i)
                  write(timestr, *) t
                  write(message, *) "Body " // trim(adjustl(body%info(i)%name)) // " ("  // trim(adjustl(idstr)) // ")" // &
                              " too far from the central body at t = " // trim(adjustl(timestr))
                  call swiftest_io_log_one_message(COLLISION_LOG_OUT, message)
                  body%ldiscard(i) = .true.
                  body%lmask(i) = .false.
                  call body%info(i)%set_value(status="DISCARDED_RMAX", discard_time=nbody_system%t, discard_rh=body%rh(:,i), &
                                            discard_vh=body%vh(:,i))
                  impactors%regime = REGIME_EJECTED 
               else if ((param%rmin >= 0.0_DP) .and. (rh2 < rmin2)) then
                  body%status(i) = DISCARDED_RMIN
                  write(idstr, *) body%id(i)
                  write(timestr, *) t
                  write(message, *) "Body " // trim(adjustl(body%info(i)%name)) // " ("  // trim(adjustl(idstr)) // ")" // &
                              " too close to the central body at t = " // trim(adjustl(timestr))
                  call swiftest_io_log_one_message(COLLISION_LOG_OUT, message)
                  body%ldiscard(i) = .true.
                  body%lmask(i) = .false.
                  call body%info(i)%set_value(status="DISCARDED_RMIN", discard_time=nbody_system%t, discard_rh=body%rh(:,i), &
                                            discard_vh=body%vh(:,i), discard_body_id=cb%id)
                  impactors%regime = REGIME_CB_IMPACT
               else if (param%rmaxu >= 0.0_DP) then
                  rb2 = dot_product(body%rb(:, i),  body%rb(:, i))
                  vb2 = dot_product(body%vb(:, i), body%vb(:, i))
                  energy = 0.5_DP * vb2 - Gmtot / sqrt(rb2)
                  if ((energy > 0.0_DP) .and. (rb2 > rmaxu2)) then
                     body%status(i) = DISCARDED_RMAXU
                     write(idstr, *) body%id(i)
                     write(timestr, *) t
                     write(message, *) "Body " // trim(adjustl(body%info(i)%name)) // " ("  // trim(adjustl(idstr)) // ")" // &
                                 " is unbound and too far from barycenter at t = " // trim(adjustl(timestr))
                     call swiftest_io_log_one_message(COLLISION_LOG_OUT, message)
                     body%ldiscard(i) = .true.
                     body%lmask(i) = .false.
                     call body%info(i)%set_value(status="DISCARDED_RMAXU", discard_time=nbody_system%t, discard_rh=body%rh(:,i), &
                                               discard_vh=body%vh(:,i))
                     impactors%regime = REGIME_EJECTED
                  end if
               end if

               ! Save the system snapshot
               if (body%ldiscard(i)) then
                  allocate(ldiscard, mold=body%ldiscard(:))
                  ldiscard(:) = .false.
                  ldiscard(i) = .true.
                  call body%save_discard(ldiscard,nbody_system,collider%before)
                  ! The base class doesn't do a before/after comparison, so we just save the before snapshot
                  call collision_history%take_snapshot(param,nbody_system, t, "particle") 
                  deallocate(ldiscard)
               end if
            end if
         end do
      end associate

      return
   end subroutine swiftest_discard_cb_body


   subroutine swiftest_discard_peri_body(body, nbody_system, param)
      !! author: David A. Minton
      !!
      !! Check to see if a body (massive or test particle) should be discarded because its perihelion distance becomes too small
      !!
      !! Adapted from David E. Kaufmann's Swifter routine: discard_peri.f90
      !! Adapted from Hal Levison's Swift routine discard_peri.f
      implicit none
      ! Arguments
      class(swiftest_body),         intent(inout) :: body 
         !! Swiftest body object
      class(swiftest_nbody_system), intent(inout) :: nbody_system 
         !! Swiftest nbody system object
      class(swiftest_parameters),   intent(inout) :: param  
         !! Current run configuration parameterss
      ! Internals
      integer(I4B)              :: i, j, ih
      real(DP)                  :: r2
      real(DP), dimension(NDIM) :: dx
      character(len=STRMAX) :: idstr, timestr, message
      logical, allocatable, dimension(:) :: ldiscard
   
      associate(cb => nbody_system%cb, &
                nbody => body%nbody, &
                pl => nbody_system%pl, &
                npl => nbody_system%pl%nbody, &
                t => nbody_system%t, &
                collider => nbody_system%collider, &
                impactors => nbody_system%collider%impactors, &
                collision_history => nbody_system%collision_history)
         call body%get_peri(nbody_system, param)
         do i = 1, nbody
            if (body%status(i) == ACTIVE) then
               if (body%isperi(i) == 0) then
                  ! Check to make sure the body isn't too close to any of the planets, as this case will be handled elsewhere
                  ih = 1
                  do j = 1, npl
                     dx(:) = body%rh(:, i) - pl%rh(:, j)
                     r2 = dot_product(dx(:), dx(:))
                     if (r2 <= (pl%rhill(j))**2) ih = 0
                  end do
                  if (ih == 1) then
                     if ((body%atp(i) >= param%qmin_alo) .and.    &
                        (body%atp(i) <= param%qmin_ahi) .and.    &           
                        (body%peri(i) <= param%qmin)) then
                        body%status(i) = DISCARDED_PERI
                        write(idstr, *) body%id(i)
                        write(timestr, *) nbody_system%t
                        write(message, *) "Body " // trim(adjustl(body%info(i)%name)) // " ("  // trim(adjustl(idstr)) // ")" // &
                                    " perihelion distance too small at t = " // trim(adjustl(timestr))
                        
                        call swiftest_io_log_one_message(COLLISION_LOG_OUT, message)
                        body%ldiscard(i) = .true.
                        call body%info(i)%set_value(status="DISCARDED_PERI", discard_time=nbody_system%t, discard_rh=body%rh(:,i), &
                                                  discard_vh=body%vh(:,i), discard_body_id=cb%id)

                        ! Save the system snapshot
                        impactors%regime = REGIME_CB_IMPACT
                        allocate(ldiscard, mold=body%ldiscard(:))
                        ldiscard(:) = .false.
                        ldiscard(i) = .true.
                        call body%save_discard(ldiscard,nbody_system,collider%before)
                        deallocate(ldiscard)
                        call collision_history%take_snapshot(param,nbody_system, t, "particle") 
                     end if
                  end if
               end if
            end if
         end do
      end associate

      return
   end subroutine swiftest_discard_peri_body


   subroutine swiftest_discard_pl_tp(tp, nbody_system, param)
      !! author: David A. Minton
      !!
      !! Check to see if test particles should be discarded based on their positions relative to the massive bodies
      !!
      !! Adapted from David E. Kaufmann's Swifter routine: discard_pl.f90
      !! Adapted from Hal Levison's Swift routine discard_pl.f
      implicit none
      ! Arguments
      class(swiftest_tp),           intent(inout) :: tp     
         !! Swiftest test particle object
      class(swiftest_nbody_system), intent(inout) :: nbody_system 
         !! Swiftest nbody system object
      class(swiftest_parameters),   intent(inout) :: param  
         !! Current run configuration parameters
      ! Internals 
      integer(I4B)              :: i, j, isp
      real(DP)                  :: r2min, radius
      real(DP), dimension(NDIM) :: dx, dv
      character(len=STRMAX) :: idstri, idstrj, timestr, message
      logical, allocatable, dimension(:) :: ldiscard_tp, ldiscard_pl
   
      associate(ntp => tp%nbody, &
                pl => nbody_system%pl, &
                npl => nbody_system%pl%nbody, &
                t => nbody_system%t, &
                dt => param%dt, &
                collider => nbody_system%collider, &
                impactors => nbody_system%collider%impactors, &
                collision_history => nbody_system%collision_history)
         do i = 1, ntp
            if (tp%status(i) == ACTIVE) then
               do j = 1, npl
                  dx(:) = tp%rh(:, i) - pl%rh(:, j)
                  dv(:) = tp%vh(:, i) - pl%vh(:, j)
                  radius = pl%radius(j)
                  call swiftest_discard_pl_close(dx(:), dv(:), dt, radius**2, isp, r2min)
                  if (isp /= 0) then
                     tp%status(i) = DISCARDED_PLR
                     tp%lmask(i) = .false.
                     pl%ldiscard(j) = .true.
                     write(idstri, *) tp%id(i)
                     write(idstrj, *) pl%id(j)
                     write(timestr, *) nbody_system%t
                     write(message, *) "Particle " // trim(adjustl(tp%info(i)%name)) // " ("  // trim(adjustl(idstri)) // ")" &
                                                   // "  too close to massive body " // trim(adjustl(pl%info(j)%name)) // " (" &
                                                   // trim(adjustl(idstrj)) // ")" &
                                                   // " at t = " // trim(adjustl(timestr))
                     call swiftest_io_log_one_message(COLLISION_LOG_OUT, message)
                     tp%ldiscard(i) = .true.
                     call tp%info(i)%set_value(status="DISCARDED_PLR", discard_time=nbody_system%t, discard_rh=tp%rh(:,i), &
                                               discard_vh=tp%vh(:,i), discard_body_id=pl%id(j))

                     ! Save the system snapshot
                     impactors%regime = COLLRESOLVE_REGIME_MERGE
                     allocate(ldiscard_tp, mold=tp%ldiscard(:))
                     allocate(ldiscard_pl, mold=pl%ldiscard(:))
                     ldiscard_tp(:) = .false.
                     ldiscard_pl(:) = .false.
                     ldiscard_tp(i) = .true.
                     ldiscard_pl(j) = .true.
                     call tp%save_discard(ldiscard_tp,nbody_system,collider%before)
                     call pl%save_discard(ldiscard_pl,nbody_system,collider%before)
                     call collision_history%take_snapshot(param,nbody_system, t, "before") 
                     call pl%save_discard(ldiscard_pl,nbody_system,collider%after)
                     call collision_history%take_snapshot(param,nbody_system, t, "after") 
                     deallocate(ldiscard_tp, ldiscard_pl)
                     exit
                  end if
               end do
            end if
         end do
      end associate

      return
   end subroutine swiftest_discard_pl_tp
   

   subroutine swiftest_discard_pl_close(dx, dv, dt, r2crit, iflag, r2min)
      !! author: David A. Minton
      !!
      !!  Check to see if a test particle and massive body are having, or will have within the next time step, an encounter such
      !!          that the separation distance r is less than some critical radius rcrit (or r**2 < rcrit**2 = r2crit)
      !!
      !! Adapted from David E. Kaufmann's Swifter routine: discard_pl_close.f90
      !! Adapted from Hal Levison's Swift routine discard_pl_close.f
      implicit none
      ! Arguments
      real(DP), dimension(:), intent(in)    :: dx
         !! Difference in distance vectors
      real(DP), dimension(:), intent(in)    :: dv 
         !! Difference in velocity vectors
      real(DP), intent(in)                  :: dt 
         !! Time step
      real(DP), intent(in)                  :: r2crit 
         !! Square of the critical radius at which the test particle and massive body are considered to be in close proximity
      integer(I4B), intent(out)             :: iflag 
         !! Flag indicating whether the test particle and massive body are in close proximity. 
         !! iflag == 1 means they are considered close
         !! iflag == 0 means they are not considered close
      real(DP), intent(out)                 :: r2min 
         !! Minimum separation distance between the test particle and massive body within the next time step
      ! Internals
      real(DP) :: r2, v2, vdotr, tmin
      
      r2 = dot_product(dx(:), dx(:))
      if (r2 <= r2crit) then
         iflag = 1
      else
         vdotr = dot_product(dx(:), dv(:))
         if (vdotr > 0.0_DP) then
            iflag = 0
         else
            v2 = dot_product(dv(:), dv(:))
            tmin = -vdotr / v2
            if (tmin < dt) then
               r2min = r2 - vdotr * vdotr / v2
            else
               r2min = r2 + 2 * vdotr * dt + v2 * dt**2
            end if
            r2min = min(r2min, r2)
            if (r2min <= r2crit) then
               iflag = 1
            else
               iflag = 0
            end if
         end if
      end if
   
      return
   end subroutine swiftest_discard_pl_close

end submodule s_swiftest_discard