# README
Ordnance Survey - The National Grid
The Ordnance Survey National Grid is a coordinate system commonly used in the United Kingdom for mapping and survey data.
The base github.com/usedbytes/osgrid
package provides functionality for
parsing, formatting and manipulating coordinates in the OS National Grid system
("grid references").
For example, the OS grid reference of the summit of Snowdon is SH 60986 54375
.
We can find the OS grid reference for the point 300 metres East and 2 kilometres
North like so:
summit, _ := osgrid.ParseGridRef("SH 60986 54375")
point, _ := summit.Add(300 * osgrid.Metre, 2 * osgrid.Kilometre)
fmt.Println(point.String())
osdata
The Ordnance Survey make lots of their mapping data available for free under OS OpenData.
Under osdata
there are two packages for working with a subset of that data:
terrain50
: For accessing the OS Terrain50 dataset, which provides elevation data for the whole of the UK, with 50 m horizontal and 0.1 m vertical resolution.raster
: For accessing raster-format data. This has only been tested with the OS VectorMap District dataset at the time of writing.
Further details on how to use the packages can be found in their respective directories.
cmd/osmodel
osmodel
is a command-line application which uses the other packages in this
repository to generate different representations of the supported
OS OpenData.
datasets.
It has 3 subcommands:
surface
: Generate a "surface" from a specified region of an elevation dataset, e.g. as a CSV file.texture
: Generate an image from a specified region of araster
dataset.mesh
: Generate a 3D model, optionally with a texture, from a specified region of elevation and raster datasets. e.g. as an STL or X3D file, suitable for 3D printing.
Images above contains OS data © Crown Copyright (2021), used under the Open Government License