Starting with BMEGUIStarting with BMEGUI

Prahlad JatPrahlad Jat(1)(1) and Marc Serre and Marc Serre(1)(1)

(1) University of North Carolina at Chapel (1) University of North Carolina at Chapel HillHill

AgendaAgenda

► Installation and Software StructureInstallation and Software Structure►Temporal GIS AnalysisTemporal GIS Analysis►Data PreparationData Preparation►Basic OperationBasic Operation

Installation and Installation and software structuresoftware structure

InstallationInstallation

►RequirementRequirement Python 2.5Python 2.5 GTK 2.10.11GTK 2.10.11 FreeTypeFreeType Python Libraries (PyCairo, PyGObject, Python Libraries (PyCairo, PyGObject,

PyGTK, NumPy, SciPy, Matplotlib)PyGTK, NumPy, SciPy, Matplotlib) MATLAB Component Runtime (MCR)MATLAB Component Runtime (MCR)

BMElib

Software StructureSoftware Structure

BMEGUIBMEGUIFreeFont

Matplotlib

PyGObject

GTK+

PyGtk

SciPy

PyCairo Python Libraries

NumPy

Matlab .exe fileMCR

Features of PythonFeatures of Python

►Cross-platform languageCross-platform language►Very simple syntax rulesVery simple syntax rules►Open source software… Free!Open source software… Free!►Support Object Oriented ProgrammingSupport Object Oriented Programming►Scripting language widely used in Scripting language widely used in

ArcGISArcGIS►A number of additional modulesA number of additional modules

Math and science modulesMath and science modules Graphical user interface modulesGraphical user interface modules

Sample CodeSample Code

u = 0v = 0x = 100y = 30while 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 – 2print u, v

if-statement block

while-statement block

From The Quick Python Book (Manning)

Temporal GIS AnalysisTemporal GIS Analysis

Temporal GIS analysis Temporal GIS analysis processprocess

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 ScreenMean Trend Analysis ScreenSpace/Time Covariance Analysis Screen

BME Estimation Screen

Working Directory and Data Working Directory and Data FileFile

►Working Directory Working Directory ►Data fileData file

Working Directory and Data Working Directory and Data FileFile

►Working Directory Working Directory ►Data fileData file

Data Field ScreenData Field Screen

►Column MatchingColumn Matching► Input units and name of compoundInput units and name of compound

Data Field ScreenData Field Screen

►Column MatchingColumn Matching► Input units and name of compoundInput units and name of compound

Data Distribution ScreenData Distribution Screen

►Basic statisticsBasic statistics►Histogram (Raw data and log-Histogram (Raw data and log-

transformed data)transformed data)

Exploratory Data Analysis Exploratory Data Analysis ScreenScreen

►Time series at monitoring stationTime series at monitoring station►Spatial distributionSpatial distribution►Data aggregationData aggregation

Mean Trend Analysis ScreenMean Trend Analysis Screen

►Display temporal mean trendDisplay temporal mean trend►Display spatial mean trend (Raw & Display spatial mean trend (Raw &

Smooth)Smooth)►Model Parameter (Exponential Model Parameter (Exponential

Smoothing)Smoothing)

Space/Time Covariance Analysis Space/Time Covariance Analysis ScreenScreen

►Display spatial & temporal covarianceDisplay spatial & temporal covariance►Plot covariance modelsPlot covariance models

BME Estimation ScreenBME Estimation Screen

►BME estimation parameters BME estimation parameters

BME Estimation ScreenBME Estimation Screen

►Time series of BME mean estimation Time series of BME mean estimation ►Map of BME mean estimationMap of BME mean estimation►Map of BME error varianceMap of BME error variance

Data PreparationData Preparation

Workspace and Data FileWorkspace and Data File

►WorkspaceWorkspace System files containing estimation System files containing estimation

parameters and resultsparameters and results Initial parameter fileInitial parameter file

►Data File (currently supports two Data File (currently supports two formats)formats) GeoEAS formatGeoEAS format CSV with header CSV with header

WorkspaceWorkspace

►All estimation parameters and results All estimation parameters and results are storedare stored Automatically reproduce the same Automatically reproduce the same

estimation resultestimation result

►ExampleExample Data File: datafile1.csvData File: datafile1.csv

►Work01Work01

Data File: datafile2.txtData File: datafile2.txt►Work02 – Estimation with covariance model 1Work02 – Estimation with covariance model 1►Work03 – Estimation with covariance model 2Work03 – Estimation with covariance model 2

Data FileData File

► Two data file format (CSV and GeoEAS)Two data file format (CSV and GeoEAS)► CSV formatCSV format

First line must be column namesFirst line must be column names File extension: .csv File extension: .csv

►GeoEAS formatGeoEAS format Standard format in BMElib (Matlab)Standard format in BMElib (Matlab)

►1st line: File description1st line: File description►22ndnd line: Number of data column line: Number of data column►33rdrd ~ (3+# in 2 ~ (3+# in 2ndnd line) line: Name of data column line) line: Name of data column►Tab separated dataTab separated data

File extension: .txtFile extension: .txt

ExampleExample

Tetrachloroethene (micrograms per liter) in New Jersey7LONGITUDELATITUDENUMDAYSYEARDATATYPEVAL1VAL2-74.5278 40.5594 880 2001 0 0.01 0.01-74.7781 40.2217 376 2000 0 0.01 0.01

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

CSV formatCSV format

GeoEAS formatGeoEAS format

Data ColumnsData Columns

►Data file must have at least 4 columnsData file must have at least 4 columns X Field, Y Field: Spatial CoordinatesX Field, Y Field: Spatial Coordinates

►Ex.) Longitude/Latitude etcEx.) Longitude/Latitude etc►3-D space is not supported3-D space is not supported

T Field: Time eventsT Field: Time events►Ex.) Days/Year/Hour etcEx.) Days/Year/Hour etc

Data Value: Measurement ValuesData Value: Measurement Values

►Station ID: Unique ID assigned to each Station ID: Unique ID assigned to each measurement locationmeasurement location

Station ID and System IDStation ID and System ID

►Station IDStation ID User-defined IDUser-defined ID Alphanumeric valueAlphanumeric value Used in label of the plot Used in label of the plot System automatically create Station ID, if System automatically create Station ID, if

data does not contain Station ID columndata does not contain Station ID column

►System IDSystem ID System assigns sequential number to System assigns sequential number to

each stationeach station

Basic OperationBasic Operation

Launch BMEGUI toolLaunch BMEGUI tool

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

Data Field ScreenData Field Screen

►Select data columns used for X Field, Y Select data columns used for X Field, Y Field, Time Field, and Data ValueField, Time Field, and Data Value

► Input Space Unit, Time Unit, Data Unit Input Space Unit, Time Unit, Data Unit and Name of Data and Name of Data

Select Column Name

Input Units and Name of Data

Data Distribution ScreenData Distribution Screen

►Basic statistics Basic statistics Mean, Standard deviation, Skewness, Mean, Standard deviation, Skewness,

KurtosisKurtosis

►Histogram – Raw data, Log-transformed Histogram – Raw data, Log-transformed datadata

Data Log-transformationData Log-transformation

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

► Tab automatically switch to “Log Data”Tab automatically switch to “Log Data”

Exploratory Data Analysis Exploratory Data Analysis ScreenScreen

►Time series at monitoring stationTime series at monitoring station►Spatial map at specific timeSpatial map at specific time►Data aggregationData aggregation

Time series at monitoring Time series at monitoring stationstation

► Select Station ID from the listSelect Station ID from the list► Input System ID in the entryInput System ID in the entry► Click “Next” or “Back” buttonClick “Next” or “Back” button

Select Monitoring Station Spatial coordinate of

monitoring station

Location of monitoring station

Zoom in/out

Spatial map at specific timeSpatial map at specific time

► Select time from the listSelect time from the list► Click “Next” or “Back” buttonClick “Next” or “Back” button

Select time

Zoom in/out

Data aggregationData aggregation

►Check “Aggregation Period” boxCheck “Aggregation Period” box►Enter aggregation period and click Enter aggregation period and click

“Aggregate Data” button“Aggregate Data” button

Quit BMEGUIQuit BMEGUI

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

Recovery from errorRecovery from error

►You will get an error messageYou will get an error message►Check error message and correct the Check error message and correct the

problem (Data file, Parameters, etc)problem (Data file, Parameters, etc)►Check a error message file Check a error message file

“err(yymmdd).txt” in your work space“err(yymmdd).txt” in your work space►Contact Info.Contact Info.

BMElab: MH0014BMElab: MH0014 Email: Email: jat [at] live.unc.edujat [at] live.unc.edu