map3d
Using map3d
“Looking at my data has
never been so much fun!”
NCRR
Goals of map3d
Read
map3d
• Surface based geometries
• Multichannel time signals
Render
• Color coded maps of scalars
• Plots of time signals
Provide
• Interactive control
• Interrogation of data
• Presentation graphics output
NCRR
Map3d Rendering
map3d
Nodes and mesh
NCRR
Map3d Rendering
map3d
Nodes and mesh
Lighted surface
NCRR
Map3d Rendering
map3d
Nodes and mesh
Lighted surface
Data Gouraud
NCRR
Map3d Rendering
map3d
Nodes and mesh
Lighted surface
Data Gouraud
Data B-shaded
NCRR
Map3d Rendering
map3d
Nodes and mesh
Lighted surface
Data Gouraud
Data B-shaded
Time signals
NCRR
Map3d Rendering
map3d
Nodes and mesh
Lighted surface
Data Gouraud
Data B-shaded
Time signals
Landmarks
NCRR
Command Line Control
map3d
map3d -f daltorso.fac
NCRR
More Command Line
map3d
map3d -f daltorso.fac -p p2_3200_77_torso.data
NCRR
Still More….
map3d
map3d -nw \
-f daltorso.fac -p p2_3200_77_torso.data \
-f dalepi.fac -p p2_3200_77_epi.data
NCRR
All the options
Map3D
Version 5.3
map3d
USAGE:
map3d [FILENAME]
map3d [OPTIONS]
FILENAME:
the name of a file containing geometry and/or data.
OPTIONS:
global:
-v (echo the version number)
-c colour (default colour for all meshes)
-df filename (for default settings file)
-if filename (to set output image basefilename)
-iv (initialize video equipment)
-rl level (set report level)
-vm (for video mode)
-vw xmin ymin (location of video window
-nw (for new window for each surface)
-ss (to have all surfaces with same geometry scale)
-nv (to *not* check validity of geometry)
NCRR
…the rest of all
map3d
per surface:
-f geomfilename
-gp geomfilepath (pathname to the geometry files)
-c colour (for mesh)
-cg colour (for vectors)
-ac (leave geometry in absolute coordinates)
-as xmin xmax ymin ymax (to set surface window location)
-ds (make this the dominant surface)
-lm landmarkfile (to read landmark file (eg. coronaries)
-ll leadlinks_filename (links electrode numbers to leads)
-ch channels_filename (links nodes to channels in data)
-cl channellinks_flename (links channels to leadlinks)
-p pot/grad-filename (basefilename)
-ff fidfilename (.fid file to be read)
-fn fidseriesnum (number of the fid series to take)
-dp datafilepath (pathname to the pak-data files)
-s num1 num2 (first and last file numbers)
-i increment (increment between file numbers)
-ps scaleval (scale value applied to all data)
-pl minimum_data_value (user set potential minimum)
-ph maximum_data_value (user set potential maximum)
-cs scale_step_size (user set contour spacing)
-sl surfnum (to lock scaling to another surface)
-t trace_lead_number (for scalar plot)
-at xmin xmax ymin ymax (to set scalar window location)
NCRR
Interactive Controls
Mouse
map3d
• Rotation, translation, scaling
• Menu manipulation
• Picking
Keyboard
• Toggle settings
• Select options
GUI
• There is none, well not really… (yet)
NCRR
I/O and File Reading
Input
map3d
• CVRTI ASCII formats
- .pts, .fac, .pot, .channels, .tetra,
.leadlinks, .lmarks
• CVRTI graphicsio formats
- .geom, .tsdf, .data, .tsdfc
Output
• Same as input for geometry
• Image formats (.png so far)
NCRR
Scripting map3d
map3d
MAP3D=../map3d
GEOM=../geom/tank
DATA=../data/tank
$MAP3D -nw -f ${GEOM}/25feb97_sock.fac \
-p ${DATA}/cool1-atdr_new.data@1 -s 1 1000 \
Surface 1 -ch ${GEOM}/sock128.channels \
-lm ${GEOM}/25feb97_sock.lmarks \
-f ${GEOM}/25feb97_sock_closed.geom \
-p ${DATA}/cool1-atdr_new.data@2 -s 1 1000\
Surface 2
-ch ${GEOM}/sock128.channels \
-lm ${GEOM}/25feb97_sock.lmarks
NCRR
Resulting Display
map3d
Surface 1
Surface 2
NCRR
What’s Next
GUI
map3d
• Windowing data
• Changing command line parameters
File readers
• CVRTI hierarchical files
• Matlab .mat files
Layered rendering
• Mix scalar data of different types
Image output
• Frames and sequences
• Vector based formats (e.g., postscript)
NCRR