This page was created by the IDL library routine
mk_html_help2.
Last modified: Wed Feb 5 18:16:00 2025.
PROCEDURE:
spd_flipbookify
PURPOSE:
Turns the current tplot window into a "flipbook" containing:
1) the current figure (vertical line at each time step)
2) distribution slices at each time step
KEYWORDS:
trange: limit the time range of plots produced (will draw a box around trange by default)
xrange: two-element array specifying x-axis range for the slices
yrange: two-element array specifying y-axis range for the slices
zrange: two-element array specifying z-axis range for the slices
slices: three-element array specifying the slices to plot:
'BV': The x axis is parallel to B field; the bulk velocity defines the x-y plane
'BE': The x axis is parallel to B field; the B x V(bulk) vector defines the x-y plane
'xy': (default) The x axis is along the data's x axis and y is along the data's y axis
'xz': The x axis is along the data's x axis and y is along the data's z axis
'yz': The x axis is along the data's y axis and y is along the data's z axis
'xvel': The x axis is along the data's x axis; the x-y plane is defined by the bulk velocity
'perp': The x axis is the bulk velocity projected onto the plane normal to the B field; y is B x V(bulk)
'perp_xy': The data's x & y axes are projected onto the plane normal to the B field
'perp_xz': The data's x & z axes are projected onto the plane normal to the B field
'perp_yz': The data's y & z axes are projected onto the plane normal to the B field
default: ['xy', 'xz', 'yz']
three_d_interp: use the 3D interpolation method (default)
two_d_interp: use the 2D interpolation method
geometric: use the geometric interpolation method
custom_rotation: Applies a custom rotation matrix to the data. Input may be a
3x3 rotation matrix or a tplot variable containing matrices.
If the time window covers multiple matrices they will be averaged.
This is applied before other transformations
/energy: produce energy slices instead of velocity slices
thickness: thickness of the vertical line drawn at each time step
linestype: style of the vertical line drawn at each time step
note: box_* keywords require that you specify a trange
box_color: color of the box
box_style: linestyle of the box
box_thickness: thickness of the box
/no_box: disable the box
left_margin: adjust the left-margin of the output images
right_margin: adjust the right-margin of the output images (where the
slices are stored)
title: title of the plot; accepts common time string formats, e.g.,
title="YYYY-MM-DD/hh:mm:ss.fff"
seconds: specify the # of seconds for each slice
(e.g., seconds=1.5 -> plot at every 1.5 seconds)
time_step: integer specifying the interval to produce plots at
(e.g., time_step=1 -> plot at every time, time_step=2 -> every other time, etc)
/postscript: save the images as postscript files instead of PNGs
output_dir: directory where the plots are saved (default: 'flipbook/')
filename_suffix: suffix to append to the end of the newly created files
/video: save the sequence of images as a video (.mp4) - currently only works for PNG
vid_format: format of the output video; default .mp4;
(options include: avi flv gif matroska mjpeg mov mp4 swf wav webm)
vid_fps: frames per second for the video; default: 6
NOTES:
- experimental, work in progress! email problems to: egrimes@igpp.ucla.edu
- the default time steps are taken from the first panel in the current window
warning: if this happens to be a full day of srvy mode MMS FGM data,
this will produce > 1 million plots, one at each FGM data point - use the
time_step or seconds keywords to avoid this, e.g.,
time_step=10000 for one plot per 10,000 FGM data points
seconds=6 for one plot every 6 seconds
$LastChangedBy: egrimes $
$LastChangedDate: 2023-05-25 11:45:55 -0700 (Thu, 25 May 2023) $
$LastChangedRevision: 31869 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/general/spedas_tools/flipbookify/spd_flipbookify.pro $
(See general/spedas_tools/flipbookify/spd_flipbookify.pro)
FUNCTION:
spd_times_from_top_panel
PURPOSE:
Returns the times from the top panel in the current tplot window
$LastChangedBy: egrimes $
$LastChangedDate: 2018-08-09 15:30:24 -0700 (Thu, 09 Aug 2018) $
$LastChangedRevision: 25621 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/general/spedas_tools/flipbookify/spd_times_from_top_panel.pro $
(See general/spedas_tools/flipbookify/spd_times_from_top_panel.pro)