AnalyzerBatch Commands & Arguments

Brian Genna -

Running Analyzerbatch

Command: Analyzerbatch – The main command to run AnalyzerBatch. Requires another command related to specific desired functionality (see below). If run without an accompanying command, running analyzerbatch will open a list of the other commands that can be used.

 

Creating a new job

Command: Newjob – Use the newjob command with analyzerbatch to create a new Analyzer tracking job.

Syntax: AnalyzerBatch.exe NewJob <MovieFile> <FwtFile> [-autoValidFrames TopLeft|BottomLeft|TopRight|BottomRight #RGB valid|invalid] [-manualValidFrames frameRanges] [-manualSize [1-100] [1-100]] [-imageRotate 0|90|180|270] [-frameBurnin] [-analysisDefintion C:\Path\To\AnalysisDefinitionFile.xml] [-autotrack s|h|hbw] [-smoothing] [-neutralframe C:\Path\To\NeutralFrame]

 

Required Arguments:

MovieFile: This is the path to the movie file that you want to import.

FwtFile: This is the path to the fwt file that you want to create. This is the main project file for the new job.

 

Optional Arguments: 

-autoValidFrames: Automatically determine valid video regions by looking for a colored square in one of the corners of the video.

  • #RGB – The first argument is the color of the square
  • TopLeft|BottomLeft|TopRight|BottomRight - The second argument is the corner to look in where the colored square is located. (If you are rotating the image, then this value will be where the square is in the original video, not after it's been rotated.)
  • valid|invalid - The third is a boolean indicating whether the existence of the square means that the frame is valid or not. Valid means the frames with the square are valid frames and are meant to be tracked, invalid means the opposite. 

-manualValidFrames: Manually specify valid video regions. Expects a comma separated list of frame ranges (e.g. 0-100,200-300). 

-manualSize: Manually specify size and quality of Jpeg images used when retargeting.

  • The first value is the size as a percentage of the source video size.
  • The second value is the quality as a value from 1-100. 

-imageRotate: Rotate video images clockwise at 90 degree increments. Valid values are 0, 90, 180, and 270. 

-frameBurnin: Burns the frame number into video.

 -analysisDefinition: File path to alternative analysis definition file.

 -autotrack: Track the entire newly created job with Autotrack.

  • s|h|hbw - This argument specifies which tracker to use (s-static, h-headcam color, hbw-headcam black&white).
  • -smoothing: Applies some smoothing to the autotrack results. Optional argument for use with the -autotrack option.
  • -neutralframe: Path to a previously created neutral frame file (.fwlf) Optional argument for use with the -autotrack option.

  

Tracking a previously created job

Command: Track – Use the track command to track a previously created job with Autotrack or user-created tracking models.

Syntax: AnalyzerBatch.exe Track <FwtFile> [-autotrack s|h|hbw] [-neutralframe C:\Path\To\NeutralFrame file] [-smoothing] [-model C:\Path\To\Custom Model file]

 

Required Arguments: 

FwtFile: This is the path to the fwt file that you want to track. 

-autotrack: Track the entire newly created job with Autotrack.

  • s|h|hbw - This argument specifies which tracker to use (s-static, h-headcam color, hbw-headcam black&white).
  • -smoothing: Applies some smoothing to the autotrack results. Optional argument for use with the -autotrack option.
  • -neutralframe: Path to a previously created neutral frame file (.fwlf) Optional argument for use with the -autotrack option.

 

Optional Arguments: 

-model: Uses custom tracking models created with the “Export Tracking Model...” function in Analyzer. Requires a separate argument for each different model. For example:

analyzerbatch.exe track “c:\job.fwt” -autotrack s -model “c:\folder\Eyes.mat” -model “c:\folder\Brows.mat” -model “c:\folder\Mouth.mat”

*Note – When creating tracking models for use with Analyzerbatch, it is highly recommended to only train the three nose landmarks in the Eyes group. For the other groups, lock the nose landmarks before training. Otherwise, the nose in every group will likely have an adverse effect on your tracking quality.



Parameterizing a job 

Command: Parameterize – The parameterize command is used to take an already tracked Analyzer job and parameterize it to convert the data into a form that Retargeter can use to apply animation.

Syntax: AnalyzerBatch.exe Parameterize <FwtFile> <Username> <Password> [-actormodel "C:/MyFiles/NeutralFrame.fwlf"] [-url http://webserviceurl:port] [-ranges [valid|specified]] [-includetrackingresults]

 

Required Arguments: 

FwtFile: This is the path to the fwt file which will contain the parameter data for retargeting.

Username: This is your username for the Parameterization service.

Password: This is your password for the Parameterization service.

 

Optional Arguments: 

-actormodel: The file name following this argument specifies a neutral frame (.fwlf) to parameterize with AutoSolve.

-url: Alternate Parameterization service URL

-ranges: Specifies which frame range is to be parameterized. Defaults to all frames if this argument does not specify otherwise.

  • valid|specified – A selection of which frames to parameterize in the shot. Valid specifies only valid frames, or specific ranges can be entered separated by commas (100-200,300-400,etc)

-includetrackingresults: Include this optional flag if you'd like to create a secondary image sequence with burned-in tracking results. The images will show the landmarks positions on the face for each frame.



Exporting landmark positions

Command: Export Landmark Positions - Exports the positions of all facial landmarks from each frame to an XML file. 

Syntax: AnalyzerBatch.exe ExportLandmarkPositions <FwtFile> <XmlFile>

 

Required Arguments: 

FwtFile: This is the path to the Analyzer job file (.fwt) that you want to export landmark positions from.

XmlFile: This is the path to the XML file that you want to save the data to. A new file will be created if it does not exist already.

 


Help

Command: Help – Lists the arguments and syntax for each command

Syntax: Analyzerbatch.exe Help [Command]

 

Required Arguments:

 

Command: This is the command that the user desires help for. Can be:

  • NewJob
  • Track
  • ExportLandmarkPositions
  • Parameterize
  • CountValidFrame
  • Help
Have more questions? Submit a request

Comments

this.location="http://support.facewaretech.com"
Powered by Zendesk