kstraj_trajectory_adiabatic

this trajectory internally uses an adiabatic representation of the particle. this is a good trajectory anywhere the adiabatic approximation is valid.

Child elements:

  • integrators: any integrator element (integrator_*) may be used.

  • interpolators: any interpolator element (interpolator_*) may be used.

  • controls: any control element (control_*) may be used.

  • terms: only the propagation, synchrotron, drift and gyration terms may be used with this trajectory.

XML element: <kstraj_trajectory_adiabatic>
C++ type: KSTrajTrajectoryAdiabatic
Child elements

Element

Description

control_B_change

control_cyclotron

this control suggests a temporal step which is a fraction of the instantaneous cyclotron period.

control_energy

this control suggests a temporal step based on conservation of total energy over a step.

control_length

this control suggests a temporal step which would result in a step with the given length were the particle to remain at constant speed.

control_magnetic_moment

control_momentum_error

control_position_error

control_time

this control suggests a constant temporal step.

integrator_rk54

an 5th/4th order embedded runge-kutta integrator.

integrator_rk65

an 6th/5th order embedded runge-kutta integrator.

integrator_rk8

an 8th order runge-kutta integrator.

integrator_rk86

an 8th/6th order embedded runge-kutta integrator.

integrator_rk87

an 8th/7th order embedded runge-kutta integrator.

integrator_rkdp54

integrator_rkdp853

interpolator_crk

interpolator_fast

this interpolator uses a linear interpolation internally.

interpolator_hermite

term_drift

this term in the equation of motion adds e-cross-b and grad-b drifts to adiabatic simulations.

term_gyration

this term in the equation of motion adds cyclotron gyrations to adiabatic simulations.

term_propagation

this term in the equation of motion moves the particle in external electromagnetic fields.

term_synchrotron

this term in the equation of motion bleeds off energy from the particle due to radiative effects.

Attributes

Attribute

Type

Description

attempt_limit

unsigned int

cyclotron_fraction

double

max_segments

unsigned int

name

string

the name of this trajectory.

piecewise_tolerance

double

use_true_position

bool

Example:

<kstraj_trajectory_adiabatic name="trajectory_adiabatic">
    <integrator_rk8/>
    <control_time time="1.e-10"/>
    <term_propagation/>
</kstraj_trajectory_adiabatic>

Used as:

Can be referenced by:

More information

Appears in the documentation:

Used in example configurations: