adam_prism_particle_injection_object

ADAM, PRISM Particle-in-Cell class definition, CPU backend.

Source: src/app/prism/common/adam_prism_particle_injection_object.F90

Dependencies

Contents

• prism_particle_injection_object
• particle_space_injection_interface
• space_random_number_generator_interface
• electrons_velocity_injection_interface
• ions_velocity_injection_interface
• neutrals_velocity_injection_interface
• velocity_random_number_generator_interface
• initialize
• load_from_file
• set_particle_initial_injection
• single_particle_injection
• uniform_domain_space_injection
• uniform_cilinder_space_injection
• cylindrical_to_cartesian
• uniform_cell_space_injection
• uniform_maxwellian_velocity_injection
• non_uniform_maxwellian_velocity_injection
• pure_drift_velocity_injection
• write_initial_injection_tab
• random_number_generator
• layered_number_generator
• add_drift_velocity
• apply_vel_av_correction
• description
• fisher_yates_shuffle

Variables

Name	Type	Attributes	Description
INI_SECTION_NAME	character(len=18)	parameter
SPACE_RANDOM_NUMBER_GENERATOR	character(len=29)	parameter
SPACE_LAYERED_NUMBER_GENERATOR	character(len=30)	parameter
UNIFORM_MAXWELLIAN_VELOCITY_DISTRIBUTION	character(len=18)	parameter
NON_UNIFORM_MAXWELLIAN_VELOCITY_DISTRIBUTION	character(len=22)	parameter
PURE_DRIFT_VELOCITY_DISTRIBUTION	character(len=10)	parameter
VELOCITY_RANDOM_NUMBER_GENERATOR	character(len=32)	parameter
VELOCITY_LAYERED_NUMBER_GENERATOR	character(len=33)	parameter
space_rand_num_generator	procedure(space_random_number_generator_interface)	pointer	Space random number
velocity_rand_num_generator	procedure(velocity_random_number_generator_interface)	pointer	Space random number

Derived Types

prism_particle_injection_object

Components

Name	Type	Attributes	Description
space_random_number_generator	character(len=99)		Type of random number generator for space distribution
box_number	real(kind=R8P)		Number of boxes in which ensure charge neutrality
space_pairing	logical		Enable space pairing of particles
electrons_velocity_distribution	character(len=99)		Electrons velocity distribution type.
ions_velocity_distribution	character(len=99)		Ions velocity distribution type.
neutrals_velocity_distribution	character(len=99)		Neutrals velocity distribution type.
T_i	real(kind=R8P)		Ionic plasma temperature (uniform)
T_i_x	real(kind=R8P)		Ionic plasma temperature along x (non-uniform)
T_i_y	real(kind=R8P)		Ionic plasma temperature along y (non-uniform)
T_i_z	real(kind=R8P)		Ionic plasma temperature along z (non-uniform)
T_e	real(kind=R8P)		Electronic plasma temperature (uniform)
T_e_x	real(kind=R8P)		Electronic plasma temperature along x (non-uniform)
T_e_y	real(kind=R8P)		Electronic plasma temperature along y (non-uniform)
T_e_z	real(kind=R8P)		Electronic plasma temperature along z (non-uniform)
T_n	real(kind=R8P)		Neutrals plasma temperature (uniform)
T_n_x	real(kind=R8P)		Neutrals plasma temperature along x (non-uniform)
T_n_y	real(kind=R8P)		Neutrals plasma temperature along y (non-uniform)
T_n_z	real(kind=R8P)		Neutrals plasma temperature along z (non-uniform)
x_position	real(kind=R8P)		x coordinate of the initial position of the particle in single particle problem
y_position	real(kind=R8P)		y coordinate of the initial position of the particle in single particle problem
z_position	real(kind=R8P)		z coordinate of the initial position of the particle in single particle problem
charge	real(kind=R8P)		charge of the particle in single particle problem
mass	real(kind=R8P)		mass of the particle in single particle problem
velocity_random_number_generator	character(len=99)		Type of random number generator for space distribution
velocity_pairing	logical		Enable space pairing of particles
v_drift_x	real(kind=R8P)		Single particle drift velocity along x
v_drift_y	real(kind=R8P)		Single particle drift_velocity along y
v_drift_z	real(kind=R8P)		Single particle drift velocity along z
electrons_drift_x	real(kind=R8P)		Electrons drift velocity along x
electrons_drift_y	real(kind=R8P)		Electrons drift_velocity along y
electrons_drift_z	real(kind=R8P)		Electrons drift velocity along z
ions_drift_x	real(kind=R8P)		Ions drift velocity along x
ions_drift_y	real(kind=R8P)		Ions drift_velocity along y
ions_drift_z	real(kind=R8P)		Ions drift velocity along z
neutrals_drift_x	real(kind=R8P)		Neutrals drift velocity along x
neutrals_drift_y	real(kind=R8P)		Neutrals drift_velocity along y
neutrals_drift_z	real(kind=R8P)		Neutrals drift velocity along z
v_av_correction	logical		Flag to correct the average v
particle_space_injection	procedure(particle_space_injection_interface)	pass(self), pointer	Particle space injection.
electrons_velocity_injection	procedure(electrons_velocity_injection_interface)	pass(self), pointer	Electrons velocity injection.
ions_velocity_injection	procedure(ions_velocity_injection_interface)	pass(self), pointer	Ions velocity injection.
neutrals_velocity_injection	procedure(neutrals_velocity_injection_interface)	pass(self), pointer	Neutrals velocity injection.

Type-Bound Procedures

Name	Attributes	Description
description	pass(self)	Return pretty-printed object description.
initialize	pass(self)	Initialize IC.
load_from_file	pass(self)	Load config from file.
set_particle_initial_injection	pass(self)
uniform_domain_space_injection	pass(self)
uniform_cilinder_space_injection	pass(self)
uniform_cell_space_injection	pass(self)
uniform_maxwellian_velocity_injection	pass(self)
non_uniform_maxwellian_velocity_injection	pass(self)
pure_drift_velocity_injection	pass(self)
single_particle_injection	pass(self)

Interfaces

particle_space_injection_interface

space_random_number_generator_interface

electrons_velocity_injection_interface

ions_velocity_injection_interface

neutrals_velocity_injection_interface

velocity_random_number_generator_interface

Subroutines

initialize

Initialize particle_injection.

subroutine initialize(self, file_parameters, pic)

Arguments

Name	Type	Intent	Attributes	Description
self	class(prism_particle_injection_object)	inout		External fields.
file_parameters	type(file_ini)	in		Simulation parameters ini file handler.
pic	type(prism_pic_object)	in		Pic object

Call graph

load_from_file

Load PIC configuration from file.

subroutine load_from_file(self, file_parameters, pic, go_on_fail)

Arguments

Name	Type	Intent	Attributes	Description
self	class(prism_particle_injection_object)	inout		Particle injection object.
file_parameters	type(file_ini)	in		File handler.
pic	type(prism_pic_object)	in		PIC object
go_on_fail	logical	in	optional	Go on if load fails.

Call graph

set_particle_initial_injection

subroutine set_particle_initial_injection(self, field, grid, pic, q_pic)

Arguments

Name	Type	Intent	Attributes	Description
self	class(prism_particle_injection_object)	inout
field	type(field_object)	in
grid	type(grid_object)	in
pic	type(prism_pic_object)	inout
q_pic	real(kind=R8P)	inout

Call graph

single_particle_injection

subroutine single_particle_injection(self, q_pic)

Arguments

Name	Type	Intent	Attributes	Description
self	class(prism_particle_injection_object)	inout
q_pic	real(kind=R8P)	inout

Call graph

uniform_domain_space_injection

subroutine uniform_domain_space_injection(self, field, grid, pic, q_pic)

Arguments

Name	Type	Intent	Attributes	Description
self	class(prism_particle_injection_object)	inout
field	type(field_object)	in
grid	type(grid_object)	in		Grid (sibling realm component, threaded in).
pic	type(prism_pic_object)	in
q_pic	real(kind=R8P)	inout

Call graph

uniform_cilinder_space_injection

subroutine uniform_cilinder_space_injection(self, field, grid, pic, q_pic)

Arguments

Name	Type	Intent	Attributes	Description
self	class(prism_particle_injection_object)	inout
field	type(field_object)	in
grid	type(grid_object)	in		Grid (sibling realm component, threaded in).
pic	type(prism_pic_object)	in
q_pic	real(kind=R8P)	inout

Call graph

cylindrical_to_cartesian

Convert cylindrical coordinates to cartesian coordinates with respect to the coil center and normal direction.

Attributes: pure

subroutine cylindrical_to_cartesian(r, theta, axial, x_c, y_c, z_c, normal, x, y, z)

Arguments

Name	Type	Intent	Attributes	Description
r	real(kind=R8P)	in
theta	real(kind=R8P)	in
axial	real(kind=R8P)	in
x_c	real(kind=R8P)	in
y_c	real(kind=R8P)	in
z_c	real(kind=R8P)	in
normal	character(len=1)	in
x	real(kind=R8P)	out
y	real(kind=R8P)	out
z	real(kind=R8P)	out

Call graph

uniform_cell_space_injection

subroutine uniform_cell_space_injection(self, field, grid, pic, q_pic)

Arguments

Name	Type	Intent	Attributes	Description
self	class(prism_particle_injection_object)	inout
field	type(field_object)	in
grid	type(grid_object)	in		Grid (sibling realm component, threaded in).
pic	type(prism_pic_object)	in
q_pic	real(kind=R8P)	inout

Call graph

uniform_maxwellian_velocity_injection

subroutine uniform_maxwellian_velocity_injection(self, field, grid, pic, q_pic, particle_type)

Arguments

Name	Type	Intent	Attributes	Description
self	class(prism_particle_injection_object)	inout
field	type(field_object)	in
grid	type(grid_object)	in		Grid (sibling realm component, threaded in).
pic	type(prism_pic_object)	in
q_pic	real(kind=R8P)	inout
particle_type	character(len=1)	in

Call graph

non_uniform_maxwellian_velocity_injection

subroutine non_uniform_maxwellian_velocity_injection(self, field, grid, pic, q_pic, particle_type)

Arguments

Name	Type	Intent	Attributes	Description
self	class(prism_particle_injection_object)	inout
field	type(field_object)	in
grid	type(grid_object)	in		Grid (sibling realm component, threaded in).
pic	type(prism_pic_object)	in
q_pic	real(kind=R8P)	inout
particle_type	character(len=1)	in

Call graph

pure_drift_velocity_injection

Inject a particle distribution with a uniform drift velocity

subroutine pure_drift_velocity_injection(self, field, grid, pic, q_pic, particle_type)

Arguments

Name	Type	Intent	Attributes	Description
self	class(prism_particle_injection_object)	inout
field	type(field_object)	in
grid	type(grid_object)	in		Grid (sibling realm component, threaded in).
pic	type(prism_pic_object)	in
q_pic	real(kind=R8P)	inout
particle_type	character(len=1)	in

Call graph

write_initial_injection_tab

subroutine write_initial_injection_tab(filename, q_pic, np)

Arguments

Name	Type	Intent	Attributes	Description
filename	character(len=*)	in
q_pic	real(kind=R8P)	in
np	integer(kind=I4P)	in

Call graph

random_number_generator

subroutine random_number_generator(N, shuffled_list, i_numb, r_n)

Arguments

Name	Type	Intent	Attributes	Description
N	integer(kind=I4P)	in
shuffled_list	integer(kind=I4P)	inout
i_numb	integer(kind=I4P)	in
r_n	real(kind=R8P)	inout

layered_number_generator

subroutine layered_number_generator(N, shuffled_list, i_numb, r_n)

Arguments

Name	Type	Intent	Attributes	Description
N	integer(kind=I4P)	in
shuffled_list	integer(kind=I4P)	inout
i_numb	integer(kind=I4P)	in
r_n	real(kind=R8P)	inout

Call graph

add_drift_velocity

subroutine add_drift_velocity(q_pic, v_drift)

Arguments

Name	Type	Intent	Attributes	Description
q_pic	real(kind=R8P)	inout
v_drift	real(kind=R8P)	in

Call graph

apply_vel_av_correction

subroutine apply_vel_av_correction(q_pic, v_drift)

Arguments

Name	Type	Intent	Attributes	Description
q_pic	real(kind=R8P)	inout
v_drift	real(kind=R8P)	in

Call graph

Functions

description

Return a pretty-formatted object description.

Returns: character(len=:)

function description(self, pic) result(desc)

Arguments

Name	Type	Intent	Attributes	Description
self	class(prism_particle_injection_object)	in		External fields.
pic	type(prism_pic_object)	in		PIC object

Call graph

fisher_yates_shuffle

Returns: integer(kind=I4P)

function fisher_yates_shuffle(index_list, nn) result(shuffled_list)

Arguments

Name	Type	Intent	Attributes	Description
index_list	integer(kind=I4P)	in
nn	integer(kind=I4P)	in

Call graph