3.12.2009 Kamil Sedlak

The reading of the field map files in the 3D Opera file format has been extended:
  1) The lenght unit can also be specified in cm instead of in meters only.
  2) Only one octant (in Kartesian coordinate system) of the field map can be
	specified, and the field can be extrapolated to other octants (this
	depends on the symmetry of the field).
  3) First line of the field map does not have to be empty (but it can be).
  4) Documentation has been modified accordingly.
This commit is contained in:
2009-12-03 09:52:09 +00:00
parent b5594b4513
commit c84f6a43b3
5 changed files with 108 additions and 15 deletions

View File

@ -324,8 +324,29 @@ Three special volumes ``Target, M0, M1 and M2''.
the \emph{field normalisation factor} is 1. (Note that this default
normalisation is different from 2DBOpera and 2DBOperaXY options).
However, a different \emph{field normalisation factor} can be specified
in the field map using the keyword ``fieldNormalisation \emph{number}''
in the field map file using the keyword ``fieldNormalisation \emph{number}''
before the line started with 0.\\
The \emph{length unit} can be changed to 1\,cm by specifying ``[CENTIMETRE]''
after the ``0'' character in the field map file.\\
It is expected that the field map is defined in the full volume of the field.
Sometimes (due to the symmetry of the field), it is enough to define the
field in just one octant of the Kartesian coorinate system (e.g. for positive
$x$, $y$ and $z$). In such cases, the user can specify this in the field map
file using the keyword ``symmetryType \emph{number}'', where the \emph{number}
specifies how the field should be extrapolated to other octants.
The ``symmetryType 1'' case means that the planes of symmetry are (x,y) and
(x,z), i.e. if the field at point $(x,y,z)$ is $(F_x,F_y,F_z)$, the field in
different octants will look like this:
$(-x,y,z) \rightarrow (F_x,F_y,F_z)$;
$(x,-y,z) \rightarrow (F_x,-F_y,F_z)$;
$(-x,-y,z) \rightarrow (F_x,-F_y,F_z)$;
$(x,y,-z) \rightarrow (F_x,F_y,-F_z)$;
$(-x,y,-z) \rightarrow (F_x,F_y,-F_z)$;
$(x,-y,-z) \rightarrow (F_x,-F_y,-F_z)$;
$(-x,-y,-z) \rightarrow (F_x,-F_y,-F_z)$. \\
Similar case is the ``symmetryType 2'', where the planes of symmetry are
(x,y) and (y,z).
These two symmetry types are realised in a the spin rotator oriented along the z axis.\\
Example of the beginning of the field map file:\\
2 2 55\\
1 X\\
@ -336,6 +357,7 @@ Three special volumes ``Target, M0, M1 and M2''.
6 BZ\\
7 DUMMY\\
fieldNormalisation -22.5733634\\
symmetryType 2\\
0 [METRE]\\
-0.2 -0.2 -1.35 0. 0. 0. 0.\\
-0.2 -0.2 -1.30 0. -0.0002 0. 0.\\