Community Sensor Model (CSM) compliant sensor models created by USGS Astrogeology Science Center.
CSM-CameraModel contains two different sensor models. The first, is a generic framing camera model written from scratch. The second is a generic line scan camera model based on code from BAE Systems Information and Electronic Systems Integration Inc.
This library is a CSM plugin library that is intended to be dynamically loaded at run time along side the CSM API library.
Once, the library is loaded, it can be accessed through the CSM Plugin interface. For an example of how to do through the CSM c++ interface see the SensorModelFactory class in SensorUtils. For an example of how to do this through the CSM Python bindings see this notebook.
From the CSM Plugin interface, a generic framing camera model (USGS_ASTRO_FRAME_SENSOR_MODEL) or generic line scan camera model (USGS_ASTRO_LINE_SCANNER_SENSOR_MODEL) can be instantiated from suitable Image Support Data (ISD). Under the CSM standard, each plugin library can define its own ISD format. This library uses an auxiliary JSON formatted file that must be next to the image file passed to the CSM::ISD class. We provide an OpenAPI server for generating these, pfeffernusse. The swagger specification is located on swaggerhub.
- cmake 3.10 or newer
- GNU-compatible Make
- a c++11 compliant compiler
This repository has all of its external c++ dependencies included in it. The
excellent header-only JSON library
JSON for Modern C++ is included directly in
the source code. The other two dependencies, the CSM API library, and gtest
are included as git submodules. When you clone this library make sure you add
the --recursive flag to your git clone command. Alaterntively, you can run
git submodule update --init --recursive after cloning. The library can also be
compiled against an installed versions of the CSM API by setting the BUILD_CSM
flag to OFF during cmake configuration.
CSM-CameraModel uses a standard cmake build system. To compile the library, and tests use the following commands:
mkdir build && cd buildcmake .. && cmake --build .
All of the tests for CSM-CameraModel are written in the googletests framework
and are run via ctest. To run all of the tests simply run ctest in the build.
All of the tests are purposefully written to use generic data that values have
been hand validated for. This data can be found under tests/data.