The command-line interface supports setting up a camera configuration through a subcommand. To see the options
simply call the subcommand on a command prompt with --help as follows:
$ pyorc camera-config --help.. program-output:: pyorc camera-config --help
To setup a camera configuration, you will at minimum need to provide the following:
- A video, made with a specific camera, oriented to a fixed point of view, using known and fixed settings. With "fixed" we mean here that any additional video supplied to pyorc should be taken with the same settings and the same exact field of view.
- Ground control points. These are combinations of real-world coordinates (possibly in a geographical coordinate reference system) and column, row coordinates in the frames of the video. By assigning where in the world a column, row coordinate is, and do this for several locations, the field of view of the camera can be projected into a real-world view.
- 4 corner points that approximately indicate the bounding box of your area of interest. These must be provided in the order upstream-left, downstream-left, downstream-right, upstream-right, where left is the left-bank as seen while looking in downstream direction.
- If you wish to use the video only from a selected frame (for instance if the first frames/seconds are bad quality, or
moving) then you must also provide the frame number from which you would like to start the analysis and provide the
camera configuration information. This is done with the
-for--frame-sampleoption. In the interactive views that will support you, this frame will be displayed. If you do not provide-fthen the first frame (index 0) will be displayed.
There are several ways to assign this information, further explained below.