This information is for Vicon Shogun 1.2. For up-to-date help, see the latest Shogun documentation.

Shogun PDFs

It is assumed that your Vicon system hardware (including the Vicon cameras, Vicon connectivity units, and any supported third-party devices) has been set up and connected and that Shogun is installed and licensed.

If you're installing your Vicon system yourself, see the Vicon documentation that was supplied with your hardware and Installing and licensing Vicon Shogun, together with any relevant videos (see the video links below). If you need further help with setting up your Vicon system, please contact Vicon Support.

Important

To benefit from the latest enhancements and bug fixes for your Vicon system, remember to check the Firmware downloads on the Vicon website regularly between major Vicon releases, to make sure your firmware is up-to-date.

To prepare your Vicon system for motion capture with Vicon Shogun Live, complete the following procedures in the order shown:

You can watch a Vicon video: 2 - Shogun Live - System Setup‌, which shows these steps. (If your system includes Vicon video cameras, see also 3 - Shogun Live - Setting up Vue video camera‌.)


Create a folder hierarchy to store takes

Before you begin motion capture with Vicon Shogun Live, you must create a hierarchy of folders in which to store the files associated with your motion capture takes. You can do this either in Vicon Shogun Post or in Vicon Eclipse running as a standalone application.

To create the folder hierarchy to store your takes:

  1. Start Vicon Shogun Post or Vicon Eclipse .
  2. If you are using Shogun Post, open the Data Management panel (press F2, or on the Panels tab on the ribbon, click Data Management).

  3. In the Data Management panel or in Eclipse, click the Create a new database button . (Note that the the Eclipse buttons are slightly different from the Data Management ones, but their function is the same.)

  4. In the New Database dialog box:

    1. In the Location field, browse to or enter the required location. This can be anywhere where you normally save data, for example in your Documents folder.

    2. In the Name field, supply a name and (if required) a description in the Description field.

    3. In the Based on list, click Shogun Animation Template.eni.
  5. Click Create and in the next dialog box, ensure your new database is selected and click Open.
  6. In the Data Management pane, create the structure in which Shogun Live will store your take:
    1. Right-click in the window, point to New and then click Project and supply a suitable name for your project.
    2. Click in the Project line you just created, then right-click, point to New and click Capture day.
    3. Click in the new Capture day node, right-click, point to New and then click Session.
      Data Management pane

      Tip

      You can enlarge images in Vicon documentation by clicking on them.

  7. Open Windows Explorer and view the folder structure you just created.

    Note that the .enf file has the name you gave to your database. It contains the file structure instructions to Eclipse that tells it which is the main folder and which are the subfolders for this database. The subfolder structure reflects the Project, Capture day and Session that you specified. Each subfolder contains an .enf file that indicates to Eclipse where it belongs in the hierarchy.

    You now have an active session, ready to store your Shogun Live takes.

Before you begin capturing, to save your captured takes into the newly created folder hierarchy, you will specify the path to it in Shogun Live, as described in Capture a take.

Position the cameras and markers

With your Vicon system set up, installed and licensed, the first task in setting up your capture space is to position the cameras and markers.

  1. Position your cameras around the capture volume, ensuring that two or more cameras can see every point in the volume in which you intend to capture motion.
  2. Place Vicon retroreflective markers around the floor to outline your capture volume.
     
  3. Place five markers in a cross shape to identify the volume origin.

Tip

You may find it helpful to create an asymmetrical pattern along the perimeter, as shown above, to help orient your view. For example, for a rectangular volume, place a different number of markers at each corner. For an elliptical volume, vary the spacing between markers as you place them around the perimeter.

Check the coverage of the capture volume

After you have positioned cameras and markers in the capture volume, the next task is to ensure that the cameras can see the whole of the volume.

  1. Ensure your cameras are physically connected to the system (for details, see the hardware documentation supplied with your Vicon system).
  2. Switch on your Vicon system and start Vicon Shogun Live.
  3. In the System panel (by default located on the left of the Shogun Live window), SHIFT+click to select all the cameras or, for a large number of cameras, right-click and click the relevant Select All option.
  4. In the Workspace ensure that the Cameras view is selected.
  5. Keeping all the cameras selected, in the Optical Mode section below, change Grayscale Mode to All.
  6. Using the default lens settings on each camera, ensure that:
    • You can see 2D marker images from each connected optical camera.
    • Two or more cameras can see every point in the volume in which you intend to capture motion.

Adjust the focus and aperture

To achieve a good marker image you may need to adjust the camera lens. Depending on your Vicon camera model, you may find two or three adjustment rings on the lens. These control the focus and aperture, and if the camera has an additional ring, the focal length.

Vicon MX T-Series:

Vicon Bonita:

Vicon Vantage:      Vicon Vero:

       

Note that for Vantage cameras (as with T-Series cameras), for 8.5 and 12.5 mm lenses, the order of the aperture and focus rings is reversed from that shown above.

To focus a camera:

  1. Fully open the Aperture ring.
  2. Adjust the Focus ring so that the markers become round and clear. As you rotate the focus ring, notice the marker images get smaller and then at some point will begin to get larger again. Good focus is when the marker is at its smallest size. Leaving this setting at infinity is normally suitable. Aim for a marker image similar to the following:
  3. Close the Aperture ring so that as much background noise as possible is removed without compromising the quality of the marker image. Try to obtain good, clear images of markers even when they are close together, as shown in the following image, where the markers on the left are touching. The markers should not be too small, and the center should be just off-white (not fully saturated) when viewed from the middle of the volume.

Optimize camera settings

To ensure optimum marker recognition, you adjust the camera settings in Shogun Live.

To optimize camera settings:

  1. In Vicon Shogun Live, make sure you are viewing 2D data from your cameras in one or more Cameras views. (To display the necessary layout, you can click the Load saved view list in the menu bar near the top of the Shogun window, then click System Setup.)
  2. Have someone wave the calibration device around in the capture volume and ensure you can see marker images moving in each Cameras view.

  3. In the System panel, SHIFT+click to select all the cameras, go to the Optical Mode section below and adjust the following camera settings as necessary:
    • Gain: To start with, leave the setting at the default of 1x to ensure 2D marker images are bright enough to see clearly. If the markers appear too faint or if the cameras have trouble distinguishing them, adjust this setting.
    • Threshold: A good starting value is 0.2 to 0.3. This setting determines the minimum value at which data is registered by pixels on the camera sensor and considered for circle fitting. As this setting acts like a high-pass filter, reducing this value increases the data that is allowed to pass through the sensor.
    • Strobe Intensity: Adjust this setting to increase the effective brightness of the strobe and therefore the distance at which and clarity with which it is likely to illuminate. A good starting value is 1.0 (100%), which is why this is the default setting.

If you need to further adjust any of the above settings for individual cameras, in the System panel, click the name of the relevant camera and change the required setting(s) in the Optical Mode section.

When you have finished focusing and optimizing the cameras, with all cameras selected, in the Optical Mode section change Grayscale Mode back to Auto.

Set timecode (optional step)

If your system includes an external timecode generator, before you calibrate the cameras, you need to set the required timecode in Shogun Live.

To set the timecode:

  1. In the System panel, in the Connectivity section, click on your device to view its current settings.

  2. At the top of the System panel, view the system settings.

  3. From the Genlock Standard list, select the standard you want to use.

  4. In the Frame Rate (Hz) list, select the required frame rate. The following example shows the PAL standard and a frame rate of 100 selected:
  5. In the Genlock and Timecode section for the selected connectivity device, to enable genlock, select the Genlock Enabled check box.
  6. In the Timecode Source list, select the required option.
  7. In the Data Capture panel (by default displayed at the bottom of the Camera Calibration panel, on the right of the Shogun Live window), the timecode is now displayed.

    It is also shown as part of the information displayed at the bottom of the Workspace.

Prepare video cameras (optional step)

Vicon Vue and Vicon Bonita Video cameras can be calibrated as part of a Vicon system, enabling you to see an accurate video overlay both during a live shoot and offline.

If your Vicon system includes supported video cameras, ensure you have set up your PC to work with the video cameras, physically connected the video cameras to your Shogun system, and set an IP address for each video camera as described in the Vicon video: 3 - Shogun Live - Setting up Vue video camera‌.




Set up aliases for video capture

Shogun Live enables you to provides an alias and specify the location to which to capture video. By having a dedicated disk (normally an SSD) for each video camera, you avoid any impact on the main system resources.

Before you begin a capture that includes video, ensure you have specified the required location for video capture, as described in the following steps.

To specify the location to which to capture video:

  1. On the Settings menu, click Show Preferences (or press SHIFT+P).
  2. In the Preferences dialog box, set up a different alias  for each video camera in your system, each pointing to a different SSD as follows:
    1. On the System Preferences tab, click New.
    2. In the Create New Device Capture Folder dialog box, in the Alias field enter a name for the folder and in the Capture Folder field, enter or browse to the required location and click OK.

  3. When you have finished, click Save Changes.
  4. In the System panel, in the Video Cameras section, for each video camera, ensure that the correct alias is selected from the Capture Directory list.

Configure video cameras in Shogun Live

After you initially connect your Vicon video camera(s), set up IP addresses and open Shogun Live, icons that represent the cameras are displayed in the System panel. However, when you click on a video camera, nothing is displayed in the Cameras view. The yellow warning icon next to the video camera name indicates that you need to configure the video camera.

To configure video cameras:

In the System panel, select a video camera, and then set the following attributes: 

  1. In the General section, ensure Enabled is selected and set the Stream IP Address for the selected video camera. This must be the address that was set for this video camera in the Windows Network and Sharing Center, as shown in  the Vicon video: Vicon Vue Configuration (see above). Ensure the camera’s IP address is not the same as that used by any other optical or video camera, or any other device. As the address ending in 192.168.10.1 is always reserved for the system, normally video cameras take the next available IP addresses (for example, 192.168.10.2, 192.168.10.3, etc).
    The video stream is now displayed in the Cameras view of the selected video camera.
    You can now calibrate the video camera, along with the other cameras (see Calibrate cameras).
  2. To configure the capture settings:
    1. Note that for the best performance and to avoid running out of disk space, in the Capture section, set the Capture Directory to a drive that is different from that used by the Data Management or Eclipse database. If possible, specify a different drive for each video camera, as described in Set up aliases for video capture. If not, at least divide the video cameras into separate groups, depending on the drive speed, and allocate a separate drive to each group.
      The folder structure created by setting the Capture Directory duplicates the structure of the Data Management capture path.
    2. To change the sampling rate for video cameras, in the System panel, in the Video cameras section, click to select the required video camera and in the General section select the required option from the Sub Sampling Divisor list.

    3. If you need to adjust the saturation, click Show Advanced and change the relevant setting in the Video Mode section.