pavdata 0.1.0

Transportation Infrastructure Data Toolbox

PavData (Python)

PavData is an open-source library for storing, validating and exploring asphalt pavement laboratory data. The information is organized in a relational model of eight entities — samples, binders, aggregates, mixtures and their tests, plus the references of origin — and stored in the open .pavdata format, based on JSON.

This is the Python implementation. There is also an equivalent R package that reads and writes the same format.

Installation

pip install pavdata

For the plotting functions, also install matplotlib:

pip install matplotlib

Usage

import pavdata

# Create an object
b = pavdata.pav_new("binder", name="CAP 50/70", binder_type="CAP 50/70",
                    penetration_mm=52, viscosity_135c_cp=305)

# Validate
pavdata.pav_check(b)

# Write and read
pavdata.pav_write(b, "my_data.pavdata")
objects = pavdata.pav_read("my_data.pavdata")

The package includes a dataset of 296 real samples, accessible through the SAMPLE_DATA_PATH constant:

import pavdata
data = pavdata.pav_read(pavdata.SAMPLE_DATA_PATH)

License

The software is distributed under the MIT license. The example data that ships with the library is distributed under the CC-BY-4.0 license.

Links

• Project site: https://cdavidrmelo.github.io/pavdata/
• Repository: https://github.com/cdavidrmelo/pavdata