Package: incognita
IncognitaIncognita is a tool to map UK Scout data and enable geospatial analysis.We use ONS open data to link scout areas (Groups, Districts, etc.) to UK
administrative geographies.Incognita comes fromTerra Incognita,or Parts Unknown - solving the known
unknowns!Where to get itThe source code for the project is hosted on GitHub atthe-scouts/incognitaWestronglyrecommended usingcondato installIncognita, however pip
can be used with a number of manual installation steps as below.To installIncognitawith Conda, run the following commands in the terminal# condacondaenvcreate-nincognita_env
condaactivateincognita_env
condainstall--channelconda-forgegeopandas# or PyPIpipinstallincognitaIf installing withpip, you will need to manually install geopandas and its
dependencies. Please follow below:Installing geopandas on Windows:Westronglyrecommended usingcondato installIncognita.However, to install geopandas using pip on Windows, please followthese instructions.DependenciesThis project is written and tested in Python 3.9, and depends on:geopandas,pandas- for (geospatial) data
transformation and arrangementshapely,pygeos- for manipulation and
analysis of geometric objectsdash- for simple web-appsJavaScript dependencies are:Leaflet.js- for slippy mapschroma.js- for choropleth colour scalesGetting Started:You will need to obtain the latest version of the ONS Postcode Directory. Note
that this has some open licences attached to it.If this is not May 2018, then you will need to create another child class of
ONSPostcodeDirectory inONS_data.pyYou will need to populate the settings.json file with the appropriate file pathsGenerating the data fileTo generate the datafile needed for most operations, runsetup_data_file.pywith clean prototype extract.You may also runsetup_reduce_onspd.pyto produce a smaller ONS Postcode
Directory file to speed up lookup operations and reduce memory consumption.Directory Structure:To runIncognitalocally, you will need to create a data folder as below, and
populate it with the ONS Postcode Directory files and a copy of the Scout
Census extract.data/ONS_PD_DATE/Scout Census Data/Census Extract FilesResources:Postcode Directory:LatestONS Postcode DirectoryAPI endpoints:To find API endpoints, find a geography from the below resources and click on
theAPI Explorertab.
``Shapefiles:Administrative/Electoral Geographies:Use the same boundary resolution for each of the following (BFE, BFC, BGC, BUC)BFE: Full Extent of the Realm; BFC: Full Extent Clipped; BGC: Generalised Clipped; BSC: Super Generalised ClippedLocal Authority Districts Boundaries UK BGCCounties and Unitary Authorities Boundaries UK BGCWards Generalised Clipped Boundaries UKWestminster Parliamentary Constituencies UK BGCCensus Geographies:England and Wales:Lower Layer Super Output AreasMiddle Layer Super Output AreasScotland:Data ZonesIntermediate GeographiesNorthern Ireland:Single year of age profiles:Westminster Parliamentary Constituencies:England and WalesNorthern IrelandScotlandOther useful data sourcesSchool locationsGuide:TheBeginner's Guide to UK Geographycan be useful as an introduction for those new to GIS.BranchesThe heroku branch is specifically for the heroku application:http://scout-mapping.herokuapp.com. It contains a cut down requirements file to ensure that it
loads into heroku correctly.LicenseIncognitais naturallyopen sourceand is
licensed under theMIT license.