Skip to main content
Table of Contents

Create and edit a capture session

A capture session contains all data corresponding to a single acquisition mission and consists of one or more camera sessions and/or one lidar session. Based on the input data type, a capture session supports the following combination of sessions:

  • Camera sessions and lidar session of a hybrid aerial sensor

  • Stand-alone camera sessions of a single-camera system or multicamera system

  • Stand-alone lidar session

Import data captured from different missions into separate capture sessions.

Capture sessions

A capture session can contain imagery data, lidar data, or both. Imagery data and lidar data are organized into separate sections and must share the same spatial reference system.

Camera session

A camera session groups the data of a single camera into a single object. A camera session contains the following data:

  • Images—A set of images captured by the same camera during a single mission. Supported formats are TIFF (.tif and .tiff), JPEG (.jpg and .jpeg), PNG (.png), and MRF (.mrf).

  • Orientations—The orientation data for each image in the set of images.

  • Camera—A definition of the camera that captured the images.

Lidar session

A lidar session contains the following data:

  • Trajectories—One or more files that contain the position and time information of the lidar sensor during data acquisition. Supported formats are SBET (.out) and SOL (.sol).

  • Point Clouds—A set of postprocessed point clouds after the data acquisition survey. Each point cloud should correspond to a trajectory file. Supported formats are LAS (.las) up to version 1.3 and LAZ (.laz).

Create a capture session using imagery data

The workflow for creating a capture session depends on the file format of the orientation data of the imagery. The following are the supported orientation file formats:

  • Text (.txt) and .csv)

  • Frames and cameras table (.csv)

  • Trimble Inpho project (.prj)

  • HxMap orientation files (.gori)

  • SURE orientation files (.ori)

    Caution:

    HxMap and SURE orientation files are supported for single-camera systems only.

To create a capture session with imagery data, refer to the section below that corresponds to your orientation file format.

Create a capture session from a text file

To create a capture session from a text file orientation file format, complete the following steps:

  1. On the Home tab or the Landing page, click New Capture Session .

    The Capture Session pane appears.

  2. In the Capture Session Name text box, provide a name for the capture session.

  3. Ensure that the Imagery Data check box is checked .

  4. In the Orientation File Format section, choose the Text file (.txt, .csv) option.

  5. In the Orientation Data Location section, browse to the location of the text file you want to add, and click OK.

  6. In the Spatial Reference section, click Select coordinate system .

    Tip:

    Click the drop-down arrow to set the coordinate system from another data source of the project.

    The Spatial Reference dialog box appears.

  7. Choose the correct horizontal and vertical coordinate systems for the orientation data:

    1. Click the button under Current XY and choose a horizontal coordinate system.

    2. Click the button under Current Z and choose a vertical coordinate system.

    Tip:

    • You can type a search term or EPSG code in the Search text box to find a coordinate system.

    • Right-click a coordinate system and click Add to Favorites to add it to your favorites. Right-click either coordinate system, and click Details to see how they are defined.

  8. Click OK.

  9. In the Data Parsing section, configure the parsing options, and use File view to review how the file will be parsed.

  10. Click Next.

  11. In the Data Labeling section, choose the column from the drop-down options that corresponds to each of the orientation attributes listed.

    The options in the drop-down menu have the column number followed by the first value in the column.

    Tip:

    You can define an additional column in the text file containing the camera name and match it to the Camera Name attribute to automatically link orientations to their respective cameras and fill the Camera System section.

  12. In the Rotation Definition section, select the rotation sequence the orientation angles refer to.

  13. In the Units section, select the Angular Unit value for the orientation data.

  14. In the Camera System Assignment section, provide a Name for each individual camera and its corresponding Camera ID to link the camera to its orientations.

    • Click the Add button to add a camera.

    • Click the Delete button to delete the selected camera.

    The Camera ID is the part of the image name that is used to identify the camera that captured the image. A Camera ID is not needed if all images were captured by the same camera.

  15. Alternatively, import an existing capture session template to automatically fill the sensor definitions of all the cameras:

    1. Click the Menu button in the Camera System section, and click Import Template.

    2. Browse to the template file, select it, and click OK.

  16. In the Capture Session Selection section, choose the camera sessions to add to the capture session.

    At least one camera session must be selected to continue.

    Tip:

    Click the capture session button to automatically select all of its camera sessions.

  17. Click Next.

  18. Define the parameters for each camera session:

    1. Click each camera session and view its details.

    2. Optionally, edit the camera session name or camera name values.

    3. In the Sensor Definition section, provide the information to define the camera sensor.

    4. In the Image Coordinate System section, provide the information to define the image coordinate system.

    5. In the Distortion section, choose the image distortion model used, if any, and the corresponding distortion values.

  19. Click Finish.

The capture session is created and can be viewed in the Project Tree pane.

Create a capture session from a frames and camera table

To create a capture session from a frames and camera table, complete the following steps:

  1. On the Home tab or the Landing page, click New Capture Session .

    The Capture Session pane appears.

  2. In the Capture Session Name text box, provide a name for the capture session.

  3. Ensure that the Imagery Data check box is checked.

  4. In the Orientation File Format section, choose the Frames and Cameras Table (.csv) option.

  5. In the Orientation Data Location section, browse to the location of the frames and camera table you want to add, and click OK.

  6. In the Spatial Reference section, click Select coordinate system .

    Tip:

    Click the drop-down arrow to set the coordinate system from another data source of the project.

    The Spatial Reference dialog box appears.

  7. Choose the correct horizontal and vertical coordinate systems for the orientation data:

    1. Click the button under Current XY and choose a horizontal coordinate system.

    2. Click the button under Current Z and choose a vertical coordinate system.

  8. Click OK.

  9. In the Capture Session Selection section, choose the camera sessions to add to the capture session.

    At least one camera session must be selected to continue. Click the capture session button to automatically select all of its camera sessions.

  10. Click Next to view details about the camera sessions.

    Alternatively, click Finish, and the camera sessions will be created as defined in the frames and camera table.

  11. Click a camera session to view and edit its details as needed.

  12. Click Finish.

The capture session is created and can be viewed in the Project Tree pane.

Create a capture session from a Trimble Inpho project file

To create a capture session from an Inpho project file, complete the following steps:

  1. On the Home tab or the Landing page, click New Capture Session .

    The Capture Session pane appears.

  2. In the Capture Session Name text box, provide a name for the capture session.

  3. Ensure that the Imagery Data check box is checked.

  4. In the Orientation File Format section, choose the Inpho project (.prj) option.

  5. In the Orientation Data Location section, browse to the location of the Inpho project file you want to add, and click OK.

  6. In the Spatial Reference section, click Select coordinate system .

    Tip:

    Click the drop-down arrow to set the coordinate system from another data source of the project.

    The Spatial Reference dialog box appears.

  7. Choose the correct horizontal and vertical coordinate systems for the orientation data:

    1. Click the button under Current XY and choose a horizontal coordinate system.

    2. Click the button under Current Z and choose a vertical coordinate system.

    Tip:

    • If the Inpho project file has a spatial reference defined, it is applied to the capture session automatically.

    • You can type a search term or EPSG code in the Search text box to find a coordinate system.

    • Right-click a coordinate system and click Add to Favorites to add it to your favorites. Right-click either coordinate system, and click Details to see how they are defined.

  8. Click OK.

  9. In the Capture Session Selection section, choose the camera sessions to add to the capture session.

    At least one camera session must be selected to continue. Click the capture session button to automatically select all of its camera sessions.

  10. Click Next to view details about the camera sessions.

    Alternatively, click Finish and the camera sessions will be created as defined in the Inpho project file.

  11. Click a camera session to view and edit its details as needed.

  12. Click Finish.

The capture session is created and can be viewed in the Project Tree pane.

Create a capture session from HxMap or SURE orientation files

Caution:

Only HxMap or SURE orientation files from single camera systems are supported.

To create a capture session from HxMap or SURE orientation files, complete the following steps:

  1. On the Home tab or the Landing page, click New Capture Session .

    The Capture Session pane appears.

  2. In the Capture Session Name text box, provide a name for the capture session.

  3. Ensure that the Imagery Data check box is checked.

  4. In the Orientation File Format section, choose the HxMap orientation (.gori) or SURE orientation (.ori) option, depending on the file format.

  5. In the Orientation Data Location section, browse to and select the folder containing the orientation files you want to add, and click OK.

  6. In the Spatial Reference section, click Select coordinate system .

    Tip:

    Click the drop-down arrow to set the coordinate system from another data source of the project.

    The Spatial Reference dialog box appears.

  7. Choose the correct horizontal and vertical coordinate systems for the orientation data:

    1. Click the button under Current XY and select a horizontal coordinate system.

    2. Click the button under Current Z and select a vertical coordinate system.

    Tip:

    • If the HxMap .gori files have a spatial reference defined, it is applied to the capture session automatically.

    • You can type a search term or EPSG code in the Search text box to find a coordinate system.

    • Right-click a coordinate system and click Add to Favorites to add it to your favorites. Right-click either coordinate system, and click Details to see how they are defined.

  8. Click OK.

  9. In the Capture Session Selection section, choose the camera sessions to add to the capture session.

    At least one camera session must be selected to continue. Click the capture session button to automatically select all of its camera sessions.

  10. Click Next.

  11. Define the parameters for each camera session:

    1. Click the camera session and view its details.

    2. Provide a name in the a Camera Name text box.

    3. Edit the other parameters as necessary.

  12. Click Finish.

The capture session is created and can be viewed in the Project Tree pane.

Create a capture session using lidar data

To create a capture session with lidar data, complete the following steps:

  1. On the Home tab or the Landing page, click New Capture Session .

    The Capture Session pane appears.

  2. In the Capture Session Name text box, provide a name for the capture session.

  3. In the Imagery Data section, define the orientation data of imagery following the workflow described in the sections above.

    To import lidar data only, check the Imagery Data check box to disable it.

  4. Check the Lidar Data check box, and do the following:

    1. In the Trajectory Data Location section, browse to and select the folder containing the trajectory files or the trajectory files themselves, and click OK.

    2. In the Point Cloud Data Location section, browse to the folder or list of point clouds, and click OK.

  5. In the Spatial Reference section, click Select coordinate system .

    Tip:

    Click the drop-down arrow to set the coordinate system from another data source of the project.

    The Spatial Reference dialog box appears.

  6. Choose the correct horizontal and vertical coordinate systems for the orientation data:

    1. Click the button under Current XY and choose a horizontal coordinate system.

    2. Click the button under Current Z and choose a vertical coordinate system.

    Tip:

    • You can type a search term or EPSG code in the Search text box to find a coordinate system.

    • Right-click a coordinate system and click Add to Favorites to add it to your favorites. Right-click either coordinate system, and click Details to see how they are defined.

  7. Click OK.

    The lidar session is automatically added to the capture session. If orientation data of imagery is imported, the lidar session is displayed with the camera sessions of the capture session.

  8. Click Next to view details about the lidar session.

    Alternatively, click Finish, and the capture session will be created.

  9. Click a lidar session to view and edit its name as needed.

  10. Click Finish.

The capture session is created and can be viewed on the Data tab of the Project Tree pane.

Add images to a camera session

Once a capture session is created, images can be added to each camera session in the capture session.

To add images to a camera session, complete the following steps:

  1. In the Project Tree pane, right-click the camera session you want to add images to, and click Add Images on the contextual menu.

    Alternatively, select the camera session, and on the Camera Session contextual tab, click Add Images .

    Note:

    If you are using an Inpho project file that has valid image paths, the images are automatically added.

  2. Browse to the location of the images you want to add, select them, and click OK.

    Tip:

    You can specify a text file containing a list of file paths corresponding to the images you want to add. Each line in the text file should contain a single file path.

The images are added to the camera session.

Edit a capture session

To edit a capture session, complete the following steps:

  1. In the Project Tree pane, right-click the capture session you want to edit, and click Edit Capture Session .

    The Capture Session pane appears in edit mode.

  2. In the Capture Session pane, edit the camera sessions as necessary.

  3. Alternatively, import an existing capture session template to overwrite the sensor definition of the cameras in the capture session:

    1. Click Manage camera system template in the Camera Sessions section, and click Import Template .

    2. Browse to the template file, select it, and click OK.

  4. Click Finish.

The capture session is updated.

Capture session template

A capture session template is a .json file that stores all the parameters that define the cameras of a capture session. Once you create a capture session, you can export it as a template. When creating a capture session, you can use a capture session template to automatically fill the camera parameters of the camera system.

Export a capture session template

To export a capture session template, complete the following steps:

  1. In the Project Tree pane, right-click the capture session to export it as a template.

  2. On the contextual menu, click Export , and click Template.

  3. Browse to the desired location, and name the template.

  4. Click Save.

    The capture session template is exported to the specified location.

Note:

Alternatively, in the Capture Session pane, click the options button , and click Export Template .

Import a capture session template

To import an existing capture session template, follow the steps in the Create a capture session from a text file or Edit a capture session sections above.

Back to top