Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/strawlab/dlt
DLT (direct linear transform) algorithm for camera calibration
https://github.com/strawlab/dlt
camera-models computer-vision photogrammetry rust
Last synced: about 1 month ago
JSON representation
DLT (direct linear transform) algorithm for camera calibration
- Host: GitHub
- URL: https://github.com/strawlab/dlt
- Owner: strawlab
- License: apache-2.0
- Created: 2020-03-20T14:09:41.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2024-12-23T07:50:05.000Z (about 1 month ago)
- Last Synced: 2024-12-23T08:30:26.032Z (about 1 month ago)
- Topics: camera-models, computer-vision, photogrammetry, rust
- Language: Rust
- Size: 57.6 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
- Code of conduct: code_of_conduct.md
Awesome Lists containing this project
README
# Crate `dlt` for the [Rust language](https://www.rust-lang.org/)
[](https://crates.io/crates/dlt)
[](https://docs.rs/dlt/)
[](https://crates.io/crates/dlt)
[](https://deps.rs/repo/github/strawlab/dlt)
[](https://github.com/strawlab/dlt/actions?query=branch%3Amaster)
DLT (direct linear transform) algorithm for camera calibration
This is typically used for calibrating cameras and requires a minimum of 6
corresponding pairs of 2D and 3D locations.
## Testing
### Unit tests
To run the unit tests:
```
cargo test
```
### Test for `no_std`
Since the `thumbv7em-none-eabihf` target does not have `std` available, we
can build for it to check that our crate does not inadvertently pull in std.
The unit tests require std, so cannot be run on a `no_std` platform. The
following will fail if a std dependency is present:
```
# install target with: "rustup target add thumbv7em-none-eabihf"
cargo build --no-default-features --target thumbv7em-none-eabihf
```
## Example
```rust
use dlt::{dlt_corresponding, CorrespondingPoint};
let points: Vec> = vec![
CorrespondingPoint {
object_point: [-1., -2., -3.],
image_point: [219.700, 39.400],
},
CorrespondingPoint {
object_point: [0., 0., 0.],
image_point: [320.000, 240.000],
},
CorrespondingPoint {
object_point: [1., 2., 3.],
image_point: [420.300, 440.600],
},
CorrespondingPoint {
object_point: [1.1, 2.2, 3.3],
image_point: [430.330, 460.660],
},
CorrespondingPoint {
object_point: [4., 5., 6.],
image_point: [720.600, 741.200],
},
CorrespondingPoint {
object_point: [4.4, 5.5, 6.6],
image_point: [760.660, 791.320],
},
CorrespondingPoint {
object_point: [7., 8., 9.],
image_point: [1020.900, 1041.800],
},
CorrespondingPoint {
object_point: [7.7, 8.8, 9.9],
image_point: [1090.990, 1121.980],
},
];
let pmat = dlt_corresponding(&points, 1e-10).unwrap();
// could now call `cam_geom::Camera::from_perspective_matrix(&pmat)`
```
## See also
You may also be interested in:
- [`cam-geom`](https://crates.io/crates/cam-geom) - Rust crate with 3D
camera models which can use the calibration data from DLT.
- [`dlt-examples`](https://github.com/strawlab/dlt/blob/master/dlt-examples)
- Unpublished crate in the dlt repository which demonstrates usage with
cam-geom library.
## Regenerate `README.md`
The `README.md` file can be regenerated with:
```text
cargo readme > README.md
```
## Code of conduct
Anyone who interacts with this software in any space, including but not limited
to this GitHub repository, must follow our [code of
conduct](code_of_conduct.md).
## License
Licensed under either of these:
* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or
https://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or
https://opensource.org/licenses/MIT)