kstraj_trajectory_exact

this trajectory internally uses the exact representation of the particle. in normal fields good results can be obtained only if the control suggests step sizes much smaller than the cyclotron period.

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 and synchrotron terms may be used with this trajectory.

XML element: <kstraj_trajectory_exact>
C++ type: KSTrajTrajectoryExact
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_gravity

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

max_segments

unsigned int

name

string

the name of this trajectory.

piecewise_tolerance

double

Example:

<kstraj_trajectory_exact name="trajectory_exact">
    <integrator_rk8/>
    <control_time time="1.e-10"/>
    <term_propagation/>
</kstraj_trajectory_exact>

Used as:

Can be referenced by:

More information

Appears in the documentation:

Used in example configurations: