# PDAL Bindings for Rust

This crate provides Rust bindings for the [PDAL](https://pdal.io) library.

THIS IS A WORK IN PROGRESS.  The API is not stable (nor complete) and is subject to change.

Contributions welcome! Please open an issue or PR if you have any feedback or would like to contribute. 
Come discuss the project with other GeoRust contributors at our [Discord server](https://discord.gg/Fp2aape).

## Minimalist Example

```rust, no_run
use pdal::Pipeline;
use pdal_sys::core::DimTypeId;
use std::error::Error;

fn main() -> Result<(), Box<dyn Error>> {
    // get filename from args
    let filename = std::env::args().nth(1).expect("missing filename argument");
    let pipeline_json = format!(
        r#"
        {{
            "pipeline": [
                {{
                    "type": "readers.las",
                    "filename": "{filename}"
                }},
                {{
                    "type": "writers.null"
                }}
            ]
        }}
    "#
    );

    let pipeline = Pipeline::new(pipeline_json)?;
    let results = pipeline.execute()?;

    let views = results.point_views()?;
    let view = views.first().ok_or("no point view")?;
    for pid in view.point_ids().take(3) {
        let x = view.point_value_as::<f64>(DimTypeId::X, pid)?;
        let y = view.point_value_as::<f64>(DimTypeId::Y, pid)?;
        let z = view.point_value_as::<f64>(DimTypeId::Z, pid)?;
        println!("{}: ({}, {}, {})", pid, x, y, z);
    }

    Ok(())
}
```