Batch Processing

You can try this functionality in other editions but in this case all results will be saved in restricted trial format which prohibits export of animation.
Contents
Introduction
Batch Processing is a tool useful in the following cases:
- Many steps are required to obtain final result. For instance, the following sequence of processing steps is quite common to obtain high quality results:
- Track Forward starting from the first frame of Region-of-Interest.
- Refine Backward starting from the last frame of Region-of-Interest.
- Jitter Removal with 2 as smoothing value for all body parts.
- One more Refine Backward starting from the last frame of Region-of-Interest.
- One more Jitter Removal with 1 as smoothing value for all body parts.
- Processing of many takes and/or many video files
- Experimenting with different processing and post-processing settings for one and the same source video. For example:
- Tracking with various options for shoulders, spine, head and foot.
- Jitter Removal with various values of smoothing.
- Trying of various actor parameters like actor's height and body mass index.
In all these cases Batch Processing allows you to avoid waiting when current processing step is completed to click button(s) to start the next step. Instead of being "babysitter" for iPi Mocap Studio now you can record a set of all required actions to batch and then start them by one click.
Glossary
- Processing Pass (or just Pass)
- Processing operation on Region-of-Interest for iPiMotion project. Currently the following passes are available:
- Calibration (for color cameras and for depth sensors)
- Track Forward/Backward
- Refine Forward/Backward
- Apply Jitter Removal
- Apply Motion Data for Gyro Sensor
- Batch Step (or just Step)
- Element of batch. Consists of the following information:
- Input iPiMotion project file name
- Output iPiMotion project file name (by default is the same as input)
- Processing Pass (see above)
- Values of Parameters of the Pass
- Current Timeline Position (or just Frame)
- Region-of-Interest
- Batch
- Sequence of Batch Steps. Can be saved to disk, loaded from disk, executed.
Batch Creation
- Switch to Batch tab.
- If required, clear current batch by clicking New button on the top of the tab.
- Click Record to Batch button (or press Ctrl+Shift+B on the keyboard).
- Red ball should appear in the Batch tab header.
-
- Open existing iPiMotion project or create new one and save it to disk.
- Note: Batch processing works with project files on disk. Thus before adding new steps for project to batch, the project should be saved to disk.
-
- Make all required settings for interested processing pass like Region-of-Interest, current position on time-line (current frame) and other parameters specific for the processing pass. The settings should be the same as if you were going to perform the processing pass right now.
- Press the button which corresponds to the interested pass.
- Note: During "Recording to Batch" such buttons are highlighted with pink background color.
-
- You will be prompted on the required action: Add to Batch or Perform Now. Choose the first option if your need to add the pass to the current batch.
-
- If needed, you can change output file name for project and/or choose input project file name from available alternatives. To do it click buttons to the right of input and output fields respectively.
- Also you can check values of the parameters specific for the pass by clicking "i" button to the right of the pass field.
-
- Repeat steps starting from 5 or 6 for all required processing passes, Regions-of-Interest and projects.
- To complete "Recording to Batch" click Stop Batch Recording button on the Batch tab or press Ctrl+Shift+B on the keyboard.
- Optionally, you can save resulted batch to file on disk by clicking Save... button on the top of the Batch tab.
-
Batch Editing
The following editing operations are available for batch steps:
- Delete step.
- Move step up/down in the batch sequence.
-
- Change destination file name. It's required if you want to save results of different processing stages to different files or if you're experimenting with different settings thus results for alternative settings should be in separate project files.
-
- Choose source project from the list. This list consists of all unique output file names of previous steps in the batch which have the same source project as their input. It allows to set alternative processing chains for one and the same source project.
-

Execution of Batch Processing
Batch can be executed as soon as the following conditions are valid:
- Current batch is not empty and contains at least one uncompleted step.
To execute batch processing just click Run Batch button on the bottom of Batch tab. As a result all processing passes from batch steps will be performed one after another.

After batch execution, for all executed steps additional information will appear:
- status
- Status of the step after batch execution. Can be one of the following:
- PROCESSED — processing pass completed successfully.
- ERROR — processing pass can't be performed due to error. To get additional information about error you can click "i" button on the right of status field.
- CANCELED — batch execution was stopped by user while this step was in processing.
- date
- Date of step execution.
- time
- Time period of step execution.
How it Works
During batch execution the following actions are performed for each batch step:
- Loading project from file specified as "input".
- Adjusting of Region-of-Interest to the interval specified in the batch step.
- Moving timeline position to the frame specified in the batch step.
- Changing parameters of the processing pass to values saved in batch step.
- Saving project to file specified as "output".
- Starting appropriate processing pass.
- As soon as pass completes, saving project to file specified as "output".
- Switching to the next batch step if exists.

