Starting with BMEGUI

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

2. Agenda • Installation and Software Structure • Temporal GIS Analysis • Data Preparation • Basic Operation

3. Installation and software structure

4. Installation • Requirement • Python 2.5 • GTK 2.10.11 • FreeType • Python Libraries (PyCairo, PyGObject, PyGTK, NumPy, SciPy, Matplotlib) • MATLAB Component Runtime (MCR)

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

6. 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

7. 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 while-statement block if-statement block From The Quick Python Book (Manning)

8. Temporal GIS Analysis

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

10. Working Directory and Data File • Working Directory • Data file

11. Working Directory and Data File • Working Directory • Data file

12. Data Field Screen • Column Matching • Input units and name of compound

13. Data Field Screen • Column Matching • Input units and name of compound

14. Data Distribution Screen • Basic statistics • Histogram (Raw data and log-transformed data)

15. Exploratory Data Analysis Screen • Time series at monitoring station • Spatial distribution • Data aggregation

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

17. Space/Time Covariance Analysis Screen • Display spatial & temporal covariance • Plot covariance models

18. BME Estimation Screen • BME estimation parameters

19. BME Estimation Screen • Time series of BME mean estimation • Map of BME mean estimation • Map of BME error variance

22. Data Preparation

23. 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

24. 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

25. 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 • 2nd line: Number of data column • 3rd ~ (3+# in 2nd line) line: Name of data column • Tab separated data • File extension: .txt

26. Example CSV format LONGITUDE, LATITUDE,NUMDAYS, YEAR,DATATYPE,VAL1,VAL2 -74.5278,40.5594,880,2001,0,0.01,0.01 -74.7781,40.2217,376,2000,0,0.01,0.01 GeoEAS format Tetrachloroethene (micrograms per liter) in New Jersey 7 LONGITUDE LATITUDE NUMDAYS YEAR DATATYPE VAL1 VAL2 -74.5278 40.5594 880 2001 0 0.01 0.01 -74.7781 40.2217 376 2000 0 0.01 0.01

27. 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

28. 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

29. Basic Operation

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

31. 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

32. Data Distribution Screen • Basic statistics • Mean, Standard deviation, Skewness, Kurtosis • Histogram – Raw data, Log-transformed data

33. 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”

34. Exploratory Data Analysis Screen • Time series at monitoring station • Spatial map at specific time • Data aggregation

35. 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

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

37. Data aggregation • Check “Aggregation Period” box • Enter aggregation period and click “Aggregate Data” button

38. Quit BMEGUI • Click “Quit” button • Dialog shows up, then click “OK”

39. 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 • Email: jat [at] live.unc.edu