Select page from this chapter: Job List, Output Methods, Processing Methods, Video Preview & Frame Range

Job List


The "Job List" panel lists all the jobs in the project, and provides summary status data for each one. From left to right is shown the "job state", "current task state", "current task pipelines", frame range, and video filename.

Selected and Displayed

Multiple jobs can be "selected" (try CTRL + click) - these are shown in orange. Many operations (including all those listed under the Selected menu) apply to all selected jobs. These operations, thus, affect more than one job.

Only one job can be "displayed" - this job is indicated by the double chevron mark >>. Some operations (including all those listed under the Displayed menu) can only be performed on one job, and it is the displayed job they act upon.

An example of an operation that acts upon selected jobs is "delete". Can you delete more than one job at once? Yes, you can, so this operation acts on the selected jobs. An example of an operation that acts upon the displayed job is the image display in the Video Preview window. Can you display a frame from more than one job at once? No, you can't, so this operation acts on the displayed job.

Job status

Job status will shift between RO (read only), LW (locked for writing, but not modified), MO (modified) and LE (locked elsewhere). Job locking is implemented so that a project can be opened in two places at once. This is very useful if you want to compute some jobs in a project, but continue working on parametrising other jobs in the same project. Unless you are doing something like this, you can ignore job status entirely.

RO indicates that the job has not been locked for writing. It will be locked automatically when you try to modify it. This will succeed, unless it has been locked elsewhere in the meantime.

LW indicates that the job has been locked for writing, but is unmodified. The job returns to this status when you modify it, then save it. In this state, the job cannot be locked elsewhere (e.g. for processing). To release selected jobs for processing elsewhere, use Selected/Release Write Lock (or close the project).

MO indicates that the job has been modified, and has not been saved.

LE indicates that the job is locked elsewhere. In this state, you cannot modify the job, but you can read it (e.g. to review tracking results).

NB: If Matlab crashes, or under some other conditions, you may find some of your jobs are marked LE when you know that they are not in use elsewhere. To unlock them, see Release Locked Elsewhere on the Selected Menu.

NB: DO NOT unlock jobs manually if they ARE in use elsewhere - data corruption will result.

Current task state

Each job has zero or more tasks associated with it. The most recent task is known as the "current task" - see Multiple Tasks. The state of the current task of the job is indicated by the coloured dot in the project listbox.

The state of the current task can be "closed" (grey dot), "open" (light blue dot), or "finished" (green dot or red cross, depending on whether an error occurred). A couple of extra states exist - "started" is a temporary state during execution, which is indicated by a pair of blue chevrons; "absent" is the state of there not being a current task, and is indicated also by the grey dot since it is functionally equivalent to the "closed" state.

A dark blue dot also appears - this indicates that the flag "parametrized" is set; that is, you have run the Parameters GUI on this job, or otherwise parametrized the job. This flag may help you to keep track of your preparations for tracking - it can be removed by selecting Selected/Clear Flags.

Current task pipelines

Each task has one to three processing pipelines associated with it. These are chosen from (O)bject, (S)nout and (W)hisker. When the current task state is not "closed", the OSW indicators will be present to indicate which pipelines are present in the current task of each job. When the current task is closed (or absent), the OSW indicators are not shown.

Frame range, filename and tag

The remaining parts of the entry in the listbox are the frame range of the job, the short filename of the associated video, and, if one is set (CTRL+T), the user's job tag. To obtain complete information about the job, try CTRL+I.