Skip to main content

Dataset Versions

For scientific reproducibility, a dataset must remain static once published so that a statistical analysis can be replicated years later.

electrospinning-data.org solves this by offering strictly numbered dataset versions alongside a dynamic "latest" cache.

Latest Dataset​

The latest version includes all approved entries as of the moment you run the query. This is great for exploratory research but is not recommended for published papers because your query results might change over time as new data is added.

Static Versions (v1.x.x)​

Every few months, the dataset is frozen into a semantic version (e.g., v1.0.0). When writing queries, you should explicitly target a version if reproducible science is your goal.

Accessing Versions Programmatically​

To lookup how many versions are available and retrieve their metadata (record count, creation date):

curl -X GET "https://electrospinning-data.org/api/public/dataset/versions"

Example Response:

[
  {
    "versionIdentifier": "v1.0.0",
    "recordCount": 5420,
    "createdAt": "2024-05-10T12:00:00Z"
  }
]

To request data for a specific version, include the version header or parameter depending on the endpoint:

# Export the entire v1.0.0 dataset as JSON
curl -X GET "https://electrospinning-data.org/api/public/dataset/export/json?version=v1.0.0"