Pointerra

Contact Us
  1. Support
  2. Managing Project Datasets
  3. 360/Panoramic Photos
  4. Uploading panoramic images with a CSV metadata file
Updated: 16 January 2026

Uploading panoramic images with a CSV metadata file

The most flexible way to provide the metadata for panoramic images (i.e. epirectangular jpegs, typically captured as part of a mobile scan) is via a CSV file.

We currently support four formatted metadata types:

  • Ladybug via RiProcess

  • Leica Spheres via Leica Pegasus

  • NavVis panorama image poses file

  • Leica Cyclone REGISTER 360

Note that you may not have data for all columns (if you are converting from another format), but we still expect to find following columns. Just leave the field empty (but include it) if you don't have a value for it.

Ladybug via RiProcess Metadata fields

Timestamp, Filename, Origin Easting, Origin Northing, Origin Height, Direction East, Direction North, Direction Height, Up East, Up North, Up Height, Roll[deg], Pitch[deg], Yaw[deg], Omega[deg], Phi[deg], Kappa[deg]

A CSV file that has the following 17 columns (this should match what is output by RiProcess for ladybug camera systems). We currently only read the values from the following columns (but still require the others to be present with empty values) -

* Timestamp

* Filename - must match the name of the jpg image plus the file extension

* Origin Easting

* Origin Northing

* Origin Height

* Roll (degrees)

* Pitch (degrees)

* Yaw (degrees)

All other columns are ignored and can have dummy values if you are generating them yourself.

Leica Spheres via Leica Pegasus Metadata fields

Note: This is for the non-extended version that is exported from Leica Pegasus.

Filename; Time; X1; Y1; Z1; Omega [deg]; Phi [deg]; Kappa [deg]; M11; M21; M31; M12; M22; M32; M13; M23; M33

File structure Columns : Semicolon separated (char59), no headers, with exact order as the example above.

This is normally called pano-poses.csv and is located in the panos folder in a NavVis project.

# pano poses v1.0: ID; filename; timestamp; pano_pos_x; pano_pos_y; pano_pos_z; pano_ori_w; pano_ori_x; pano_ori_y; pano_ori_z

This is a standard NavVIs format and the file structure is a semicolon separated. See this NavVis help file for further information on the contents.

Leica Cyclone REGISTER 360 file

This file must be named SetupInfo.csv for the format to be detected.

SetupName/Filename,Position(X),Position(Y),Position(Z),Orientation(W),Orientation(X),Orientation(Y),Orientation(Z)

The file contains a header row and is comma separated. The rotation is expressed as a quaternion.

Terraphoto IML (Image List) Files

Pointerra supports basic import of Terraphoto IML v5 files. This can be a practical option when your image metadata is already stored in a similar format.

Support is limited to the following fields:

  • Image (image filename)

  • Xyz (position)

  • Hrp (orientation)

Other fields defined in the IML specification are ignored.

To be recognised as a valid IML file:

  • The file must use the .iml extension

  • The file must start with the exact header line shown below (case- and character-exact)

An example of the required file structure is shown below.

[TerraPhoto image list v5]

Image=pano1.jpg
Xyz=663422.243976194 5806508.025751778 961.712348561
Hrp=82.517762856 -0.721691677 -1.427257346
Camera=8

Image=pano2.jpg
Xyz=663432.161139986 5806509.471112479 961.780210119
Hrp=82.217108242 -1.132781653 -1.201028412
Camera=8

Image=pano3.jpg
Xyz=663442.069053575 5806510.826175113 961.859900263
Hrp=82.989597019 -0.959688510 -1.402506633
Camera=8

...

Extra information

NOTE: If your coordinates are geographic (e.g. WGS84), then values should be in decimal degrees, and the photo center columns should be ordered as Longitude, Latitude, Height (replacing the Easting, Northing, Height columns)

NOTE: Yaw is assumed to be the rotation counter-clockwise from East (i.e. a Yaw of 0 indicates the direction of East, and 90 indicates North). This is the opposite of the more commonly used heading value, where heading is rotation clockwise from North (East = 90).

If you don't have valid information about the Roll, Pitch, and Yaw, put 0 values in these columns, and choose the "Hide heading indicator" option when creating the dataset to avoid showing an incorrect heading indication on the map view.