Starting with BMEGUI Prahlad Jat (1) and Marc Serre (1) (1) University of North Carolina at Chapel Hill

Agenda ► Installation and Software Structure ► Temporal GIS Analysis ► Data Preparation ► Basic Operation

Installation and software structure

Installation ► Requirement  Python 2.5  GTK  FreeType  Python Libraries (PyCairo, PyGObject, PyGTK, NumPy, SciPy, Matplotlib)  MATLAB Component Runtime (MCR)

BMElib Software Structure BMEGUI FreeFont Matplotlib PyGObject GTK+ PyGtk SciPy PyCairo Python Libraries NumPy Matlab.exe fileMCR

Features of Python ► Cross-platform language ► Very simple syntax rules ► Open source software… Free! ► Support Object Oriented Programming ► Scripting language widely used in ArcGIS ► A number of additional modules  Math and science modules  Graphical user interface modules

Sample Code u = 0 v = 0 x = 100 y = 30 while x > y: u = u + y x = x – y if x < y+2: v = v + x x = 0 else: v = v + y + 2 x = x – y – 2 print u, v if-statement block while-statement block From The Quick Python Book (Manning)

Temporal GIS Analysis

Temporal GIS analysis process Read Data File Check Data Distribution Exploratory Data Analysis Mean Trend Analysis Covariance Analysis BME Analysis Data Field Screen Data Distribution Screen Exploratory Data Analysis Screen Mean Trend Analysis Screen Space/Time Covariance Analysis Screen BME Estimation Screen

Working Directory and Data File ► Working Directory ► Data file

Working Directory and Data File ► Working Directory ► Data file

Data Field Screen ► Column Matching ► Input units and name of compound

Data Field Screen ► Column Matching ► Input units and name of compound

Data Distribution Screen ► Basic statistics ► Histogram (Raw data and log-transformed data)

Exploratory Data Analysis Screen ► Time series at monitoring station ► Spatial distribution ► Data aggregation

Mean Trend Analysis Screen ► Display temporal mean trend ► Display spatial mean trend (Raw & Smooth) ► Model Parameter (Exponential Smoothing)

Space/Time Covariance Analysis Screen ► Display spatial & temporal covariance ► Plot covariance models

BME Estimation Screen ► BME estimation parameters

BME Estimation Screen ► Time series of BME mean estimation ► Map of BME mean estimation ► Map of BME error variance

Data Preparation

Workspace and Data File ► Workspace  System files containing estimation parameters and results  Initial parameter file ► Data File (currently supports two formats)  GeoEAS format  CSV with header

Workspace ► All estimation parameters and results are stored  Automatically reproduce the same estimation result ► Example  Data File: datafile1.csv ► Work01  Data File: datafile2.txt ► Work02 – Estimation with covariance model 1 ► Work03 – Estimation with covariance model 2

Data File ► Two data file format (CSV and GeoEAS) ► CSV format  First line must be column names  File extension:.csv ► GeoEAS format  Standard format in BMElib (Matlab) ► 1st line: File description ► 2 nd line: Number of data column ► 3 rd ~ (3+# in 2 nd line) line: Name of data column ► Tab separated data  File extension:.txt

Example Tetrachloroethene (micrograms per liter) in New Jersey 7 LONGITUDE LATITUDE NUMDAYS YEAR DATATYPE VAL1 VAL LONGITUDE, LATITUDE,NUMDAYS, YEAR,DATATYPE,VAL1,VAL , ,880,2001,0,0.01, , ,376,2000,0,0.01,0.01 CSV format GeoEAS format

Data Columns ► Data file must have at least 4 columns  X Field, Y Field: Spatial Coordinates ► Ex.) Longitude/Latitude etc ► 3-D space is not supported  T Field: Time events ► Ex.) Days/Year/Hour etc  Data Value: Measurement Values ► Station ID: Unique ID assigned to each measurement location

Station ID and System ID ► Station ID  User-defined ID  Alphanumeric value  Used in label of the plot  System automatically create Station ID, if data does not contain Station ID column ► System ID  System assigns sequential number to each station

Basic Operation

Launch BMEGUI tool ► Go to ‘’ ► Double-click “Create_DeskTop_Sortcut” ► Desktop shortcut appears (red circle)

Data Field Screen ► Select data columns used for X Field, Y Field, Time Field, and Data Value ► Input Space Unit, Time Unit, Data Unit and Name of Data Select Column Name Input Units and Name of Data

Data Distribution Screen ► Basic statistics  Mean, Standard deviation, Skewness, Kurtosis ► Histogram – Raw data, Log-transformed data

Data Log-transformation ► If you want to use log-transformed data in the following analysis, check “Use Log-transformed Data” ► Tab automatically switch to “Log Data”

Exploratory Data Analysis Screen ► Time series at monitoring station ► Spatial map at specific time ► Data aggregation

Time series at monitoring station ► Select Station ID from the list ► Input System ID in the entry ► Click “Next” or “Back” button Select Monitoring Station Spatial coordinate of monitoring station Location of monitoring station Zoom in/out

Spatial map at specific time ► Select time from the list ► Click “Next” or “Back” button Select time Zoom in/out

Data aggregation ► Check “Aggregation Period” box ► Enter aggregation period and click “Aggregate Data” button

Quit BMEGUI ► Click “Quit” button ► Dialog shows up, then click “OK”

Recovery from error ► You will get an error message ► Check error message and correct the problem (Data file, Parameters, etc) ► Check a error message file “err(yymmdd).txt” in your work space ► Contact Info.  BMElab: MH0014  jat [at] live.unc.edu