|
File Formats - Simulation parameters
Description
This file is intended toallow the user to
automatically load the simulation parameters that would otherwise be
entered from the Data Editor simulation dialog. The format is based
on the XML model. Following the prolog, the file consists of a sequence
of fields. Each field is is identified by a code (for example “MyFieldCode”)
and delimited by a start (e.g. <MyFieldCode>) and stop (e.g. </MyFieldCode>)
marker. The field content is contained between the start and stop
delimiters. All fields are optional, and the program will replace omitted
fields with default values. However, there must be a SimulatedDipoleSet
Field for the file to have any effect (see below). When appropriate,
fields may be nested. Fields may occur in any order within the file. For
each field, the content consists of a sequence of whitespace-delimited
elements. The element sequence is specific for each field. Unless the
element is itself a subfield, the elements must occur in the documented
order.
Comments
Any line beginning with '//' is a comment line, and will be
ignored. However, comment lines may not be inserted within field.
Prolog
The file simulation parameter file must begin with the
specified prolog.
|
Prolog |
454d5345 4 26 1 |
|
Element Definition |
Magic_number
file_major_rev file_type file_minor_rev
(note these 4
whitespace-delimited elements must be the first line of the file) |
Fields
The prolog may be followed by zero or
more fields. Valid fields are defined in the following tables. Text
enclosed in [ ] are descriptions that would be replaced by specific
elements in the actual file.
Simulated Dipole Set
|
FieldCode |
SimulatedDipoleSet |
|
Description |
This field code
defines all the included elements as defining a simulated dipole set.
In effect, the set includes all the data used to specify the
simulation. |
|
Element Definition |
The elements of
this field consist of zero or more of the fields described in the
following tables. |
|
Example |
<SimulatedDipoleSet>
[some
additional elements]
</SimulatedDipoleSet> |
Simulated Dipole
|
FieldCode |
SimulatedDipole |
|
Description |
This field include
the necessary data to specify one dipole. UP to 32 dipoles may be
specified. |
|
Element Definition |
The field consists
of 13 elements in the obligatory order: |
|
|
Index
|
%d |
A number between 0
and 31 |
|
|
Attributes |
%x |
2000 if On, 0 if
off |
|
|
x-coordinate |
%f |
Dipole x-location
(meters) |
|
|
y-coordinate |
%f |
Dipole y-location
(meters) |
|
|
z-coordinate |
%f |
Dipole z-location
(meters) |
|
|
x-moment |
%f |
Dipole x moment
(ampere-meters) |
|
|
y-moment |
%f |
Dipole y moment
(ampere-meters) |
|
|
z-moment |
%f |
Dipole z moment
(ampere-meters) |
|
|
Signal parameter |
%x |
Signal parameter is
created by selecting from the following list |
|
|
|
|
PseudoRandom |
0x00000040 |
|
|
|
|
Square |
0x00000080 |
|
|
|
|
EPSP |
0x00000100 |
|
|
|
|
Sine |
0x00000200 |
|
|
T0 |
%f |
See documentation
for simulation dialog |
|
|
Tau |
%f |
See documentation
for simulation dialog |
|
|
K |
%f |
See documentation
for simulation dialog |
|
|
Noise magnitude |
%f |
See documentation
for simulation dialog |
|
Example
Dipole[0] is a
square wave that goes on at 0 msec and off at 20 msec. It is at (0,
0, 0.0815) and has moment (0, 0, 1). |
<SimulatedDipole>
0 2000 0 0 0.0815 0 0 1
80 0 0.02 0 0
</SimulatedDipole> |
ProbeName
|
FieldCode |
ProbeName |
|
Description |
.path for probe
file |
|
Element Definition |
%s |
path |
|
Example |
<ProbeName>h:\test\wireframe\sphere\cog48.elp
</ProbeName > |
Duration
|
FieldCode |
Duration |
|
Description |
Time series
duration (seconds) |
|
Element Definition |
%f |
duration |
|
Example |
<Duration>0.5</Duration> |
Source Time Series
|
FieldCode |
SourceTimeSeries |
|
Description |
Source time series
matrix. 1 row for each active dipole, 1 column for each time point.
The first row contains the number of rows and number of columns in the
matrix. Then, the first matrix row specifies the time series for
dipole[0], and so forth in sequence. |
|
Element Definition |
%d %d |
#rows, # columns |
|
|
%f …%f |
Row vector of
source amplitudes |
|
Example:
A 2 dipole time
series, each of 4 points |
<SourceTimeSeries>
2 4
4.9e-023 2.49e-008 4.82e-008 6.85e-008
-4.82e-008 -2.49e-008 1.87e-013 2.49e-008
</SourceTimeSeries > |
Return to File Formats page
|
|
