The UKHab & BNG Platform #1: Setting up a Project
This is the first document in a series looking at how to use the UKHab & BNG Platform. In this document we’ll be taking you through how to set up a new UKHab project. If you prefer, we also have a video tutorial that will take you through it step by step (note this is available for customers only and is password protected).
Logging in to the platform
You can login to the UKHab & BNG Platform using the same credentials that you use to login to the Coreo admin area and app. Note that what you see within the Platform will be governed by your Coreo permissions and what access you have (if any) to UKHab Projects.
Once you are logged in you will enter the home page.
The Home Page
The home page is where you select your existing projects for use within the platform and create new projects from scratch. The page is divided between:
- Project List: Where you can select your projects or create a new project.
- An interactive map which shows any projects which contain a redline boundary.
If you are a member of multiple organisations you will be able to select the organisation you wish to work with from the top down menu in the top right. This will change the available UKHab projects to those associated with the organisation you have selected.
Your available projects will be displayed in the left hand list, you can scroll through the list or use the search box in the upper right hand corner of the list to find an existing project to work on. If you don’t see any projects, this will either be due to permissions (speak to your Organisation owner or admins) or because you haven’t yet created any projects.
Creating a new project
To create a new project you will either need to be the Owner or the Admin of the organisation you are working in:
- Click the blue ‘Create a new project button’.
A new window will open prompting you to provide a name for your new project. Note that your project name must contain more than four characters. You can also add an optional description to your project if you wish.
- Click the blue ‘Next’ button once you have filled in the name and description.
Adding a Red Line Boundary
You will now be prompted to add a red line boundary. You can skip this step if it’s not relevant or you’d prefer to add your boundary later on. For this walkthrough we will assume you wish to add your boundary on project creation.
Note: Before uploading your project boundary ensure your file is in the correct format. Files should be either a GeoJson (.geojson extension) or shapefile. Shapefiles should be zipped and files should contain only one polygon or multipolygon and be under 1 MB in size.
Once your chosen boundary file is ready simply add it to your project using one of two methods:
- Drag and drop the file into the upload box.
- Click the ‘Browse Files’ button and locate and select your file on your device.
If your file is in the correct format and of the correct size the ‘Upload Files’ window will show a success message. You can also remove the boundary you just uploaded should you wish to replace it at this stage by using the ‘Clear’ button.
- Once you have uploaded your chosen boundary click the ‘Next’ button.
You’ll now have the opportunity of adding team members to your project.
- Once complete, select ‘Create new project‘.
A new window will open confirming that your project was successfully created.
- Click the blue ‘Go to project’ button.
You will now be taken to your project.
Adding Pre-Survey data
While you can go into the field and collect UKHab Survey data directly, it is common practice to undertake a pre-survey. There are two ways to add pre-survey data to a project via the The UKHab & BNG Platform. You can import existing pre-survey data or add your pre-survey records into the portal directly using our GIS tools.
Before you can begin adding pre-survey data you will need to navigate to the pre-survey page.
- Click the white ‘Pre-Survey’ tab in the upper right of the page
Importing existing data
Importing existing pre-survey data is very straightforward. Simply upload a shapefile containing your pre-survey data.
- Click the blue ‘Import Pre-Survey’ button in the upper right hand corner of the pre-survey page.
The ‘Upload pre-survey data’ window will now open.
Should you need help with the format of your file you can download a template using the ‘Get Pre-survey template’ button
Just as with uploading a redline boundary you will have two options for uploading your pre-survey data.
Either:
- Drag and drop the file into the upload box
- Click the white ‘Browse Files’ button and locate and select your file on your device.
- Once your file is uploaded click the blue ‘next button’
The ‘Match your data’ dialogue gives you the option of mapping Level 2 codes or notes from your source file into the pre-survey form.
- When finished click the blue ‘import button
While your file is being imported you will see a ‘spinning wheel’ icon denoting that the upload is taking place. Depending on the size of your import this process may take a while.
Once the process is complete your records will appear on the map and table, ready to use.
Manually adding records
You can also use the UKHab & BNG Platform to add pre-survey records directly.
- Click the blue ‘+’ icon in the bottom right corner of the map
You will now have access to the full suite of polygon geometry tools, the same as those found in the app and admin area. You can read about how these work in more detail here.
- To create a new pre-survey record use your preferred tools to draw or place your shape
- Once your polygon is complete lick the blue ‘Save Changes’ button
You can now add a level 2 habitat to the record should you wish to.
- Select the record on the map or in the table.
- In the table, click the ‘Select a L2 Habitat’ dropdown and then select the appropriate habitat type.
Repeat this process until you have completed all your pre survey records.
Your project is now set up and you’re ready to go out and collect your field data, using the Coreo app. For more information on how to use the Coreo App to conduct a UKHab Survey, check out our UKHab focused documentation here.
In the next user guide we’ll look at the baseline tab and working with the map.