🔃Managing OS Select+Build recipes

Step-by-step instructions on how to create and manage your OS Select+Build recipes.

This guide will help you get started with creating, managing and deleting recipes in your OS Select+Build Recipe Library.

The following sub-sections on this page cover:

Creating new recipes

Finding your OS Select+Build Recipe Library

Checking what's in a recipe

Deleting recipes

🔃 How do I create a new recipe?

Before you create a data package to receive your OS NGD data, you'll need to create a recipe.

YouTube video showing how to create a recipe using OS Select+Build, add filters to the recipe, then create a data package to receive your OS NGD data.

To create a new recipe:

1

Log into your OS Data Hub account

Click Login on the OS Data Hub menu bar to log into your account.

Screenshot showing the OS Data Hub homepage.

2

Navigate to the OS Data Hub workspace

Select Data from the menu bar to view your workspace.

3

Navigate to the OS Select+Build Recipe Library

Choose Downloads > OS Select+Build Recipe Library from the left-hand-side secondary navigation menu.

Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub.

Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub.

4

Choose Create a new recipe

Click the Create a new recipe button at the top right-hand-side of the screen.

5

Add details to the recipe

• Give your recipe a descriptive name.

• Add a detailed description for your recipe.

• Select your OS NGD data by choosing the themes, collections and feature types you want to include in your recipe.

• (Optional) Add filters to the feature types, if needed; more information about this is available on the Getting started with attribute filtering page.

(Optional) Choose a data schema version

If you wish to choose which schema version (where applicable) you'd like to receive the data in for a feature type, click on the feature type name within the tree view in the secondary navigation menu, then choose a data schema version from the drop-down box in the right-hand side panel.

Screenshot showing an example of selecting a data schema version for a feature type in a new recipe using OS Select+Build in the OS Data Hub.

6

Finish creating the recipe

Click the Create recipe button. Your new recipe will now instantly be available in your OS Select+Build Recipe Library.

Please note

• We recommend defining a naming convention for your organisation before creating OS NGD recipes and / or data packages.

• Adding filters to feature types is an optional step for those with advanced OS data knowledge; see the Getting started with attribute filtering page for more information on applying filters and step-by-step instructions.

• Selecting a data schema version for a feature type is an optional step; if you don't choose a particular data schema version for a feature type, OS Select+Build will always select the latest available data schema version for you for each feature type by default. We recommend using the pre-selected latest data schema version for feature types unless you have a specific need to use an earlier one. See the Data schema versioning page for more information.

What's next?

📚 Getting started with data packages

Once you've created a recipe, you'll need to add a data package against it to receive your OS NGD data. This guide takes you through creating a new data package to apply against your new recipe.

How do I find my OS Select+Build Recipe Library?

Any recipes created by your organisation will be stored in your OS Select+Build Recipe Library in the OS Data Hub.

To find your OS Select+Build Recipe Library:

1

Log into your OS Data Hub account

Click Login on the OS Data Hub menu bar to log into your account.

Screenshot showing the OS Data Hub homepage.

2

Navigate to the OS Data Hub workspace

Select Data from the menu bar to view your workspace.

3

Navigate to the OS Select+Build Recipe Library

Choose Downloads > OS Select+Build Recipe Library from the secondary navigation menu. You will then be taken to your organisation's OS Select+Build Recipe Library.

Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub.

How do I check what's in a recipe?

You can easily check details about any of your organisation's existing recipes, including a recipe's name, description, creation date, author, the filters used (if applicable), and what OS NGD themes, collections and feature types are included in a recipe.

To check what's in an existing recipe:

1

Log into your OS Data Hub account

Click Login on the OS Data Hub menu bar to log into your account.

Screenshot showing the OS Data Hub homepage.

2

Navigate to the OS Data Hub workspace

Select Data from the menu bar to view your workspace.

3

Navigate to the OS Select+Build Recipe Library

Choose Downloads > OS Select+Build Recipe Library from the secondary navigation menu. You will then be taken to your organisation's OS Select+Build Recipe Library.

Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub.

4

Navigate to the recipe you'd like to find out more about

Select the recipe you're interested in from the menu. In this view, you can see the following high-level details about a recipe:

• The recipe's name

• The recipe's author

• The date the recipe was created

• A description of the recipe, if one has been added

• OS NGD theme tags to show which themes are included in the recipe

In the screenshot below, you can see that the example recipe includes the following OS NGD themes: Land, Buildings, and Structures:

Screenshot of the OS Select+Build Recipe Library screen, which shows high-level details about the contents of an example recipe.

5

Find out what OS NGD themes, collections and feature types are in a recipe

Clicking on a recipe opens the detailed information view, where you can find more information about the recipe, including:

• The recipe's name

• A description of the recipe, if one has been added

• An option to view all of the filters applied to feature types in the recipe (if applicable)

• The date the recipe was created

• The recipe's author

• An option to show the data schema version of each feature type in the recipe

• A recipe tree detailing the OS NGD themes, collections, and feature types included in the recipe

Screenshot of the OS Select+Build Recipe details screen, which shows in-depth information about the contents of an example recipe.

How do I delete a recipe?

A recipe can be deleted within your recipe library. You can do this if you are the author of the recipe or an admin user.

To delete a recipe:

1

Log into your OS Data Hub account

Click Login on the OS Data Hub menu bar to log into your account.

Screenshot showing the OS Data Hub homepage.

2

Navigate to the OS Data Hub workspace

Select Data from the menu bar to view your workspace.

3

Navigate to the OS Select+Build Recipe Library

Choose Downloads > OS Select+Build Recipe Library from the secondary navigation menu. You will then be taken to your organisation's OS Select+Build Recipe Library.

Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub.

4

Find the recipe you want to delete

In your organisation's OS Select+Build Recipe Library, scroll or search for the recipe you want to delete.

5

Open the detailed recipe view

Click on the name of the recipe to view the recipe details. In this view, you will be able to see the Recipe actions dropdown (where you can share, edit or delete a recipe).

6

Open the recipe actions dropdown

7

Delete the recipe

• Click on the name of the recipe to view the recipe details.

  • If there are no data packages associated with the recipe, you will be asked to confirm the deletion of the recipe.

  • Where there are data packages associated, you will see the following warning:

  

• Click the Delete recipe button.

A shared recipe cannot be deleted.