Brain Imaging & Analysis Center

User Tools

Site Tools

You are here: biac » jvs » fscan » manual » chapter2 » movie
jvs:fscan:manual:chapter2:movie

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
jvs:fscan:manual:chapter2:movie [2011/09/06 00:42]
voyvodic 		jvs:fscan:manual:chapter2:movie [2023/02/23 18:43] (current)
Line 3: Line 3:
 **usage: -movie func duration name wsiz offset binsize flag** **usage: -movie func duration name wsiz offset binsize flag**
  
-  * -movie            duration  ref name wsiz skip delay binsize flag\\ +  * -movie            duration  ref name wsiz delay binsize skip flag\\ 
-  * -movie 'mean'       duration  ref name wsiz skip delay binsize flag\\ +  * -movie 'mean'       duration  ref name wsiz delay binsize skip flag\\ 
-  * -movie 'stdev'      duration  ref name wsiz skip delay binsize flag\\ +  * -movie 'stdev'      duration  ref name wsiz delay binsize skip flag\\ 
-  * -movie 'meanstdev'  duration  ref name wsiz skip delay binsize flag\\ +  * -movie 'meanstdev'  duration  ref name wsiz delay binsize skip flag\\ 
-  * -movie 'accumulate' duration  name wsiz skip delay binsize flag\\ +  * -movie 'accumulate' duration  name wsiz delay binsize skip flag\\ 
-  * -movie 'ttest'      duration  ref name wsiz skip delay binsize flag\\ +  * -movie 'ttest'      duration  ref name wsiz delay binsize skip flag\\ 
-  * -movie 'correl'     duration  ref name wsiz skip delay binsize flag\\+  * -movie 'correl'     duration  ref name wsiz delay binsize skip flag\\
   * -movie 'fft'        duration  frequency [fftflg] name wsiz\\   * -movie 'fft'        duration  frequency [fftflg] name wsiz\\
   * -movie 'phase'      duration  name wsiz phaseoffset phasebin phasemax\\   * -movie 'phase'      duration  name wsiz phaseoffset phasebin phasemax\\
 +  * -movie 'subset'     duration ref name ...\\
   * -movie 'images'    imagelistfile [newbxhfile]\\   * -movie 'images'    imagelistfile [newbxhfile]\\
  
 The MOVIE command creates a time series data set. Most usage options involve processing an existing image data set to create a new time series of a specified duration (in seconds). The FUNC argument specifies what type of image processing to do. If FUNC is 'images' the MOVIE command creates a new BXH style XML file (NEWBXHFILE) made of a time series of JPEG images as described in an existing text file list (see "Movie Images" below.) The MOVIE command creates a time series data set. Most usage options involve processing an existing image data set to create a new time series of a specified duration (in seconds). The FUNC argument specifies what type of image processing to do. If FUNC is 'images' the MOVIE command creates a new BXH style XML file (NEWBXHFILE) made of a time series of JPEG images as described in an existing text file list (see "Movie Images" below.)
  
-Movies can be generated by combining images across multiple time series, where each time series is defined relative to some starting event. If REF is specified it is the name of a reference time course and the movie starting events are event time points in REF. If no REF is specified, the starting event points are uniformly spaced every DURATION seconds.+Movies are generated by averaging images across multiple epochs within a time series, where each epoch is defined by a DURATION relative to some starting event. If REF is specified it is the name of a reference time course and the movie starting events are event time points in REF. If no REF is specified, the starting event points are uniformly spaced every DURATION seconds.
  
-The SKIP argument allows you to skip some time at the beginning of the data set (in case there are start-up transient signals).\\ 
 The DELAY argument allows you to shift the starting events DELAY seconds before (negative DELAY values) or after (positive values) the REF (or every DURATION) time events.\\ The DELAY argument allows you to shift the starting events DELAY seconds before (negative DELAY values) or after (positive values) the REF (or every DURATION) time events.\\
-Note that SKIP and DELAY both affect which images are included at the beginning of the movie cycle, but in different ways. If you have a 24s cycle and you skip 6s, then your first cycle will start at time 0 but would ignore the first 6s so that cycle would only include 18s of data and your cycle start times would be at 0, 24s, 48s, etc. But if you have 24s cycle and you delay 6s, then your first cycle will start at time 6s, and all your cycles are shifted by 6s, with start times at 6s, 30s, 54s, etc. 
  
 The BINSIZE argument lets you specify how many seconds of input image time points should be combined in each movie frame. By default, BINSIZE is 1 input image volume time point ([[jvs:fscan:manual:chapter4:tres|$TRES]]) by default. The BINSIZE argument lets you specify how many seconds of input image time points should be combined in each movie frame. By default, BINSIZE is 1 input image volume time point ([[jvs:fscan:manual:chapter4:tres|$TRES]]) by default.
 The number of frames generated in the output movie is DURATION/BINSIZE. The number of frames generated in the output movie is DURATION/BINSIZE.
 +
 +The SKIP argument allows you to skip some time at the beginning of the data set (in case there are start-up transient signals).\\
 +
 +Note that SKIP and DELAY both affect which images are included at the beginning of the movie cycle, but in different ways. If you have a 24s cycle and you skip 6s, then your first cycle will start at time 0 but would ignore the first 6s so that cycle would only include 18s of data and your cycle start times would be at 0, 24s, 48s, etc. But if you have 24s cycle and you delay 6s, then your first cycle will start at time 6s, and all your cycles are shifted by 6s, with start times at 6s, 30s, 54s, etc.
  
 The way a movie is generated is controlled by the FUNC name, which is a key word appearing as the first argument (not counting "verbose"). FUNC can be any of the following: The way a movie is generated is controlled by the FUNC name, which is a key word appearing as the first argument (not counting "verbose"). FUNC can be any of the following:
Line 46: Line 49:
  
 ImageList Format:\\ ImageList Format:\\
-The ImageList is a plain text file with lines that contain a JPEG file name and its onset time. Any line that does not start with the name of a valid JPEG file will be ignored. +The ImageList is a plain text file with lines that contain a JPEG file name and its onset time. Any line that does not start with the name of a valid JPEG file will be ignored. Two different syntax forms are recognized: 
-Onset times are specified in milliseconds (by default). +  * 2 entries per line - the first is the JPEG file name, and the second is the image onset time in seconds. 
-If the text line has only 2 items the second item is assumed to be the onset time.+  * 4 or more entries per line - the file is assumed to be in the form of a CIGAL paradigm input file ([[jvs:cigal:showplay:manual:chapter1:ppf|CIGAL PPF]])\\ 
 +    * the first item is the JPEG file name 
 +    * the 4th item is the image onset time in milliseconds 
 +    * the 5th (optional) is the image duration in milliseconds 
 +    * if the onset time is negative, then that image onset will be calculated as the end of the previous image (i.e. previous image onset plus previous duration). 
  
-The ImageList text file can be a CIGAL paradigm input file ([[jvs:cigal:manual:paramfile|CIGAL PPF]]). +The Movie Images command simply converts the ImageList file to a BXH file; it does not load the new data set.
-If there are 4 or more items on the text line, the 4th item is assumed to be the onset time. +
-If there are 5 or more items on the text line, the 5th item is assumed to be the image duration. +
-If image durations are specified and an image onset time is '-1', then that image onset will be  +
-calculated as the end of the previous image (i.e. previous image onset plus previous duration). +
  
 **See Also:**\\ **See Also:**\\
jvs/fscan/manual/chapter2/movie.1315269741.txt.gz · Last modified: 2014/08/04 16:03 (external edit)

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki