Ground Control Points¶
Ground control points are useful for correcting distortions in the data and referencing the data to know coordinate systems.
The format of the GCP file is simple.
- The first line should contain the name of the projection used for the geo coordinates. This can be specified either as a PROJ string (e.g.
+proj=utm +zone=10 +ellps=WGS84 +datum=WGS84 +units=m +no_defs), EPSG code (e.g.
EPSG:4326) or as a
WGS84 UTM <zone>[N|S]value (eg.
WGS84 UTM 16N)
- Subsequent lines are the X, Y & Z coordinates, your associated pixels, the image filename and optional extra fields, separated by tabs or spaces:
- Elevation values can be set to “NaN” to indicate no value
- The 7th column (optional) typically contains the label of the GCP.
GCP file format:
<projection> geo_x geo_y geo_z im_x im_y image_name [gcp_name] [extra1] [extra2] ...
+proj=utm +zone=10 +ellps=WGS84 +datum=WGS84 +units=m +no_defs 544256.7 5320919.9 5 3044 2622 IMG_0525.jpg 544157.7 5320899.2 5 4193 1552 IMG_0585.jpg 544033.4 5320876.0 5 1606 2763 IMG_0690.jpg
If you supply a GCP file called
gcp_list.txt then ODM will automatically detect it. If it has another name you can specify using
--gcp <path>. If you have a gcp file and want to do georeferencing with exif instead, then you can specify
--use-exif. If you have high precision GPS measurements in your images (RTK) and want to use that information along with a gcp file, you can specify
This post has some information about placing Ground Control Targets before a flight, but if you already have images, you can find your own points in the images post facto. It’s important that you find high-contrast objects that are found in at least 3 photos, and that you find a minimum of 5 objects.
Sharp corners are good picks for GCPs. You should also place/find the GCPs evenly around your survey area.
gcp_list.txt file must be created in the base of your project folder.
For good results your file should have a minimum of 15 lines after the header (5 points with 3 images to each point).
You can use one of two user interfaces for creating GCP files:
The POSM GCPi is loaded by default on WebODM. An example is available at the WebODM Demo. To use this with known ground control XYZ values, one would do the following:
Create a GCP list that only includes gcp name (this is the label that will be seen in the GCP interface), x, y, and z, with a header with a proj4 string of your GCPs (make sure they are in a planar coordinate system, such as UTM. It should look something like this:
+proj=utm +zone=37 +south +ellps=WGS84 +datum=WGS84 +units=m +no_defs gcp01 529356.250827686 9251137.5643209 8.465 gcp02 530203.125367657 9250140.80991621 15.781 gcp03 530292.136003818 9250745.02372435 11.977 gcp04 530203.125367657 9250140.80991621 15.781 gcp05 530292.136003818 9250745.02372435 11.977
Then one can load this GCP list into the interface, load the images, and place each of the GCPs in the image.
GCP Editor Pro¶
This app needs to be installed separately or can be loaded as a WebODM plugin from https://github.com/uav4geo/GCPEditorPro
Create a CSV file that includes the gcp name, northing, easting and elevation.
GCP Label,Northing,Easting,Elevation gcp01,529356.250827686,9251137.5643209,8.465 gcp02,530203.125367657,9250140.80991621,15.781 ...
Then import the CSV from the main screen and type
+proj=utm +zone=37 +south +ellps=WGS84 +datum=WGS84 +units=m +no_defs in the
The following screen will display a map from where to select the GCPs to tag and import the respective images.