boozer.c File Reference

Module for transforming between cylindrical and Boozer coordinates. More...

#include <stdlib.h>
#include <math.h>
#include "print.h"
#include "ascot5.h"
#include "consts.h"
#include "error.h"
#include "B_field.h"
#include "boozer.h"
#include "spline/interp.h"

Go to the source code of this file.

Functions
int	boozer_init_offload (boozer_offload_data *offload_data, real **offload_array)
	Load Boozer data and prepare parameters for offload.
void	boozer_init (boozer_data *boozerdata, boozer_offload_data *offload_data, real *offload_array)
	Initialize boozer data struct on target.
void	boozer_free_offload (boozer_offload_data *offload_data, real **offload_array)
	Free offload array.
a5err	boozer_eval_psithetazeta (real psithetazeta[12], int *isinside, real r, real phi, real z, B_field_data *Bdata, boozer_data *boozerdata)
	Evaluate Boozer coordinates and partial derivatives.

Detailed Description

Module for transforming between cylindrical and Boozer coordinates.

Definition in file boozer.c.

Function Documentation

boozer_init_offload()

int boozer_init_offload	(	boozer_offload_data *	offload_data,
		real **	offload_array )

Load Boozer data and prepare parameters for offload.

This function fills the boozer offload struct with parameters and allocates and fills the offload array. Sets offload array length in the offload struct.

The offload data struct should be fully initialized before calling this function and offload array should hold the input data in order [psi, nu, theta_bzr]. This function fits splines to input data, reallocates the offload array and stores spline coefficients there.

Multidimensional arrays must be stored as

• nu(psi_i, thetabzr_j) = array[j*npsi + i]
• theta_bzr(psi_i, thetageo_j) = array[j*npsi + i]
• psi(R_i, z_j) = array[j*nR + i]

Parameters

offload_data	pointer to offload data struct
offload_array	pointer to pointer to offload array

Returns

zero if initialization succeeded.

Definition at line 37 of file boozer.c.

boozer_init()

void boozer_init	(	boozer_data *	boozerdata,
		boozer_offload_data *	offload_data,
		real *	offload_array )

Initialize boozer data struct on target.

Parameters

boozerdata	pointer to data struct on target
offload_data	pointer to offload data struct
offload_array	pointer to offload array

Definition at line 108 of file boozer.c.

boozer_free_offload()

void boozer_free_offload	(	boozer_offload_data *	offload_data,
		real **	offload_array )

Free offload array.

Parameters

offload_data	pointer to offload data struct
offload_array	pointer to pointer to offload array

Definition at line 154 of file boozer.c.

boozer_eval_psithetazeta()

a5err boozer_eval_psithetazeta	(	real	psithetazeta[12],
		int *	isinside,
		real	r,
		real	phi,
		real	z,
		B_field_data *	Bdata,
		boozer_data *	boozerdata )

Evaluate Boozer coordinates and partial derivatives.

The output vector has the following elements:

• psithetazeta[0] = psi
• psithetazeta[1] = dpsi/dR
• psithetazeta[2] = dpsi/dphi
• psithetazeta[3] = dpsi/dz
• psithetazeta[4] = theta
• psithetazeta[5] = dtheta/dR
• psithetazeta[6] = dtheta/dphi
• psithetazeta[7] = dtheta/dz
• psithetazeta[8] = zeta
• psithetazeta[9] = dzeta/dR
• psithetazeta[10] = dzeta/dphi
• psithetazeta[11] = dzeta/dz

Parameters

psithetazeta	evaluated Boozer coordinates and their gradients.
isinside	a flag indicating whether the queried point was inside boozer grid
r	R coordinate
phi	phi coordinate
z	z coordinate
Bdata	pointer to magnetic field data
boozerdata	pointer to boozerdata

Returns

zero on success

Definition at line 188 of file boozer.c.