OS NGD Versioning

A Lightning Talk

PreviousChange only updates NextCreating a topographic map from OS NGD Data

Last updated 6 months ago

Was this helpful?

OS NGD Versioning

A Lightning Talk

What is OS NGD schema versioning?

Ordnance Survey is implementing schema versioning to OS NGD feature types to allow the easy flow of data updates to each data theme.

For example:

Type of data releases

New Schema - The release of a new schema will cause a feature type to have a new version. A new schema is created when additional fields are added or when the addition or removal of attribution has occurred

Data Enhancement - The release of a data enhancement will not cause a feature type to have a new version. A data enhancement is when the existing data quality has been improved, but there are no changes to the fields or attribution specified in the dataset

New Feature - The release of a brand new feature will be known as version 1 of that feature type. A new feature will contain the original schema, and can be adapted by data enhancements

What does versioning look like over time?

As new data updates are made and released, the versioning will continue (V1, V2, V3 etc…)
To manage versioning over time there will be a ‘latest’ version and ‘maintenance’ versions
Once a new ‘latest’ version is released, the previous version will become a ‘maintenance’ version : V 1 – maintenance, V 2 – latest
A maintenance version is still available in OS NGD and usable through OS Select+Build
There will be no more than three versions available in OS NGD at any one time (one ‘Latest’ and up to two ‘Maintenance’ versions) : V 1 – Maintenance, V 2 – Maintenance, V 3 – Latest
Once three versions have been released, Version 1 will be removed from OS NGD, and will no longer be available through OS Select+Build

An example with OS NGD Address

Built Address is a feature type found under the Address theme, and in the GB Address collection

It is an existing feature type which means it has a current Version number. As there hadn’t been any data updates since it was first released to OS NGD, it was released as Version 1

There have now been updates made to the Built Address schema as some new fields and attributions have been added

Updates to feature types are released in OS NGD updates (every 6 months – March or September)

When a new version is available the feature type, in this example we choose Built Address, and it defaults to the newest version available, which is then Version 2

Recipes

When a new version of the feature type is live, you can choose what version you want to download by selecting the feature type and choosing from the dropdown list. In this example we select Built Address and choose version 2

Version 1 is the Built Address feature type with the original schema containing the original fields and attribution (no new fields or attribution will be in this version)

Version 2 is the Built Address feature type with the new schema containing the original and new fields and attribution

You can find out what the new fields and attribution are by navigating to the National Geographic Database Platform on the OS Gitbook site

Gitbook help

When a new schema version is released (or close to release), the OS NGD Platform on Gitbook will be updated

Using the OS NGD Address example; A notification will appear under the applicable Address feature types that are receiving updates and changes in the new version when a release is planned but not yet live

Under each field that is available within the feature type a new metadata point ‘Data Schema Version’ has been added which says what versions of this feature type has this field in it

For either new fields or fields receiving new attribution that are not in the original version but are in the new version, the ‘Data Schema Version’ will only specify the new version

Versioning in the Recipe Library

When viewing your recipe in the Recipe Library you can tick the box ‘Show schema version’ to view what version of the feature types are included in that recipe