Skip to content

dylangrandmont/ionwc

Repository files navigation

ionwc

Eye on Western Canada Code Package README Author: Dylan Grandmont, (C) 2016-2018

Introduction

Eye on Western Canada (IONWC) has three components:

This folder contains the Database Parser component. It generally works as follows:

  • Data is downloaded from online government sources
  • Data is parsed into consistent formats and placed in database files (csv files)
  • The databases are uploaded and stored in Google Fusion Tables
  • Finally, http://ionwc.com reads these Fusion tables and plots them in dynamic maps and charts

These steps are automated as much as possible, this README details the manual steps involved

Getting Started

System Requirements

This code package was developed on Ubuntu operating system but will work on most Linux distributions

Depedencies:

  • Python 2.7
  • wget

Setting Environment Variables

One environment variable, 'IONWC_HOME', must be set. This variable is the directory location of this folder (i.e. this directory must sit in $IONWC_HOME/scripts)

Package Contents

IONWC_HOME/data

  • Raw data (txt, pdf, etc.) as downloaded from online government sources IONWC_HOME/dbs
  • Final databases (csv files) of all data IONWC_HOME/scripts
  • All code for updating databases

Running the Package

To perform updates and run this package, simply type

		python run.py

into your command line. This will update all raw data, determine any new additions, and then send those additions to the Fusion Tables Database. You will be prompted with login credentials in order to update the Fusion Tables Database.

Information for Developers

Running Unit Tests

To run the full suite, execute

python -m unittest discover

Manual Maintainence

SK Land Postings

The URLs for Land Postings and Results are not organized in a predictable manner. Because of this, they must be chcked and downloaded manually

Data Retrieval Dates

URLs used in data retrieval require an input of the year. Currently, these are string constants. Improvements should be made to grab the current year, next year, etc. instead of using constants.

Constants.py

BC_POSTING_DATES_TO_SALE_DATE_MAP SK_POSTING_NUMBER_TO_SALE_DATE

Data Sources

Well Licences

Drilling

Land Postings (Offerings)

Land Postings (Results)

All Wells

Facilities

Formations

https://landman.ca/pdf/CORELAB.pdf

Copyright Notice

This README and the entire contents of this directory are copyright of Dylan Grandmont, 2016-2018.

Releases

No releases published

Packages

No packages published

Languages