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 version snapshots 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 version snapshots are available and retrieve their metadata (record count, creation date):

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

Example Response:

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

To request data from a specific version snapshot, include the version identifier in the path:

# Export the entire v1.0.0 dataset records as JSON
curl -L "https://api.electrospinning-data.org/public/dataset/v1.0.0/export?format=json" \
-o electrospinning_dataset_v1.0.0.json