WuMapPy : Graphic User Interface for sub-surface geophysical survey data processing

Introduction

This project was initiated through cooperation between the french CNRS units UMR5133-Archéorient (FR) and UMR7619-Métis (FR)

Description

WuMapPy is a graphic user interface for friendly sub-surface geophysical survey data processing. All displaying or processing operations are realized by an other python module named GeophPy.

Features

  • Processing data sets with geophysicals methods.
  • Compatibility with Python 3.x

Installation

You can install, upgrade, uninstall wumappy with these commands:

$ pip install wumappy
$ pip install --upgrade wumappy
$ pip uninstall wumappy

Or if you don’t have pip:

$ easy_install wumappy

Or download the zip file “WuMapPy-vx.y” and unzip it.

Then, you can install now WuMapPy with this command:

$ python setup.py install

WuMapPy and GeophPy are using others python modules. If the installation of one of these modules failed on windows, you can install independently thes modules using this useful web site : http://www.lfd.uci.edu/~gohlke/pythonlibs/

Command-line usage

WuMapPy has a command-line script that launches the software.:

$ wumappy

usage: wumappy

Graphical user interface

Introduction

The WuMapPy Graphic User Interface is developped using the “PySide” library.

Main Window

_images/figMainWindow.PNG

Files

_images/figMainWindowFilesMenu.PNG

With this menu, you can open data set opening netcdf file or importing ascii files, and open geographics positions set opening ascii files or importing shapefiles :

_images/figOpenDataSetDlgBox.PNG _images/figOpenGeoPosSet1DlgBox.PNG

(for more informations, cf. GeophPy documentation)

Settings

_images/figMainWindowSettingsMenu.PNG

Language :

The language descriptions are presents as “lng” files in the “MAIN/.wumappy/resources” directory where “MAIN” is the user home directory. The default language for the Graphic User Interface is the english language, and it’s the only one generated by the code and saved as the “english.lng” file:

>>> english
    FILES_ID        Files
    SETTINGS_ID     Settings
    FONT_ID         Font
    MISCSETTINGS_ID Miscellaneous Settings
    HELP_ID         Help
    ABOUT_ID        About

But it’s easy to add and use an other language, duplicating the “english.lng” file as “otherlanguage.lng” and by modifying the file adapting it to the language (the first line, and for all others rows, all fields of the secund column to traduce the expression in the selected language.

With others language files in the “MAIN/wumappy/resources” directory, like “french.lng” and “spanish.lng”, the WuMapPy application automatically detect these languages files, and in the “Settings->Language” menu set the selection of these languages availables :

_images/figLanguageSelectionDlgBox.PNG

Font :

The font type and the font size used in the majority of the windows and dialog box can be modified selecting “Settings->Font” item.

_images/figSelectFontDlgBox.PNG

Miscellaneous settings :

_images/figMiscellaneousSettingsDlgBox.PNG

With this dialog box, it is possible to check/uncheck the flag of real-time update after a modification in a dialog box. If the flag is unchecked, a “Update” button will be displayed in the dialog box.

_images/figDlgBoxButtonsWithoutRealTimeUpdate1.PNG

The cartography at the right of the box will be updated only if this “Update” button is clicked.

Help

In this menu, it’s possible to access to the WuMapPy and GeophPy versions number and documentations in two formats (html or pdf).

_images/figMainWindowHelpMenu.PNG

On Linux operating system, to opening these documentations with the best application, you need, before starting “WuMapPy” application, to write the applications full names to use with html and pdf documents in the “config” file :

>>> [MISC]
    html_viewer = none
    pdf_viewer = none

with ‘none’, the default string, the application launches only the file full name (”.../WuMapPy.pdf” for example), and the operating system define which application to execute to opening the documentation file.

Note : The “config” file is saved in “~/wumappy” on Windows, or “~/.wumappy” on Linux and Mac OS, where ‘~’ is the user directory.

Data Set Window

The data set opened is displayed in a window with a menubar like this :

_images/figDataSetWindow.PNG

Files

_images/figDataSetWindowFilesMenu.PNG

With this menu, it’s possible to save the data set in a netcdf format file, and export the data set in several formats (ascii files, image, ...)

Display Settings

_images/figDataSetDisplaySettingsDlgBox.PNG

Processing

Severals general processing dialog box are availables :

_images/figDataSetPeakFilteringDlgBox.PNG _images/figDataSetMedianFilteringDlgBox.PNG _images/figDataSetFestoonFilteringDlgBox.PNG _images/figDataSetWallisFilteringDlgBox.PNG _images/figDataSetAntiPloughingFilteringDlgBox.PNG _images/figDataSetConstantDestripingDlgBox.PNG _images/figDataSetCubicDestripingDlgBox.PNG

(For more informations about the processing functions, see GeophPy documentation.)

Magnetic Processing

Severals magnetic processing dialog box are availables :

_images/figDataSetLogTransformationDlgBox.PNG _images/figDataSetPoleReductionDlgBox.PNG _images/figDataSetContinuationDlgBox.PNG _images/figDataSetAnalyticSignalDlgBox.PNG _images/figDataSetEquivStratumInMagSusceptDlgBox.PNG _images/figDataSetConversionGradientMagFieldDlgBox.PNG _images/figDataSetEulerDeconvolutionDlgBox.PNG

The “Undo” Button allow to cancel the last action. After having calculated Euler deconvolution for severals zones, it’s possible to save these data in a “csv” file (with ‘;’ as delimiter) by clicking on the “Save” button.

(For more informations about the magnetic processing functions, see GeophPy documentation.)

Georeferencing

This item is available only if a geographic positions set is ever opened and displayed.

_images/figDataSetGeoRefDlgBox.PNG

Geographic Positions Set Window

The geographics positions set opened is displayed in a window with a menubar like this :

_images/figGeoPosSetWindow.PNG

Files

_images/figGeoPosSetWindowFilesMenu.PNG

Configuration

_images/figGeoPosSetConfigDlgBox.PNG

This item allows to georeference geographic positions with (x,y) local positions.

Feedback & Contribute

Your feedback is more than welcome. Write email to lionel.darras@mom.fr and philippe.marty@upmc.fr

Changelog

Version 0.20

Released on 2015-09-10.

  • Initial version.