Merge develop into master

.appveyor.yml

@@ -0,0 +1,22 @@
+environment:
+  matrix:
+#    - PYTHON: "C:\\Python35-x64"
+    - PYTHON: "C:\\Python36-x64"
+
+build: false
+
+install:
+  - cmd: set PATH=%PYTHON%\;%PYTHON%\Scripts;%PATH%
+  - cmd: echo %PATH%
+  - cmd: dir %PYTHON%
+  - python --version
+  - "python -m pip install -U pip setuptools"
+  - "python -m pip install Cython==0.28.3"
+  - "python -m pip install -r requirements.txt"
+  - "python -m pip install -r test-requirements.txt"
+
+before_test:
+  - "python utils/build_uic.py dgp/gui/ui"
+
+test_script:
+  - "pytest --cov=dgp tests"

.coveragerc

@@ -0,0 +1,13 @@
+[run]
+branch = True
+
+[report]
+omit =
+    dgp/resources_rc.py
+    dgp/gui/ui/*.py
+    dgp/__main__.py
+
+exclude_lines =
+    pragma: no cover
+    def __repr__
+    raise NotImplementedError

.gitignore

@@ -1,8 +1,26 @@
+# Ignored file extensions
 *.idea
+*.pdf
 *.pyc
 *.pyo
+*.coverage
+*.vsdx
+*.hdf5
+*.h5
+
+# Ignored directories
 __pycache__/
 scratch/
-*.pdf
 venv/
-*.coverage
+docs/build/
+.cache/
+.pytest_cache/
+build/
+dist/
+
+# Specific Directives
+examples/local*
+tests/sample_data/eotvos_long_result.csv
+tests/sample_data/eotvos_long_input.txt
+dgp/gui/ui/*.py
+dgp/resources_rc.py

.travis.yml

@@ -1,11 +1,25 @@
 language: python
+cache: pip
 python:
-  - "3.5"
   - "3.6"
+before_install:
+  - sudo apt-get install -y libgeos-dev
+  - sudo apt-get install -y proj-bin
 install:
+  - pip install Cython==0.28.3
   - pip install -r requirements.txt
-  - pip install coverage
+  - pip install -r test-requirements.txt
+before_script:
+  - "export DISPLAY=:99.0"
+  - "sh -e /etc/init.d/xvfb start"
+  - sleep 3
+  - python utils/build_uic.py
 script:
-  coverage run --source=dgp -m unittest discover
+  pytest --capture=no --cov=dgp tests
+after_success:
+  - coveralls
 notifications:
-    slack: polargeophysicsgroup:FO0QAgTctTetembHbEJq8hxP
+    slack:
+      rooms:
+        - polargeophysicsgroup:FO0QAgTctTetembHbEJq8hxP
+      on_success: change

README.rst

@@ -3,17 +3,65 @@ DGP (Dynamic Gravity Processor)
 .. image:: https://travis-ci.org/DynamicGravitySystems/DGP.svg?branch=master
     :target: https://travis-ci.org/DynamicGravitySystems/DGP
 
+.. image:: https://ci.appveyor.com/api/projects/status/np3s77n1s8hpvn5u?svg=true
+    :target: https://ci.appveyor.com/project/bradyzp/dgp
+
+.. image:: https://coveralls.io/repos/github/DynamicGravitySystems/DGP/badge.svg?branch=feature%2Fproject-structure
+    :target: https://coveralls.io/github/DynamicGravitySystems/DGP?branch=develop
+
+.. image:: https://readthedocs.org/projects/dgp/badge/?version=develop
+    :target: https://dgp.readthedocs.io/en/develop
+    :alt: Documentation Status
+
+What is it
+----------
+**DGP** is an library as well an application for processing gravity data collected
+with dynamic gravity systems, such as those run on ships and aircraft.
+
+The library can be used to automate the processing workflow and experiment with
+new techniques. The application was written to fulfill the needs of of gravity
+processing in production environment.
+
+The project aims to bring all gravity data processing under a single umbrella by:
+
+- accommodating various sensor types, data formats, and processing techniques
+- providing a flexible framework to allow for experimentation with the workflow
+- providing a robust and efficient system for production-level processing
+
+Dependencies
+------------
+- numpy >= 1.13.1
+- pandas >= 0.20.3
+- scipy >= 0.19.1
+- matplotlib >= 2.0.2
+- PyQt5 >= 5.9
+- PyTables_ >= 3.0.0
+
+.. _PyTables: http://www.pytables.org
+
+License
+-------
+`Apache License, Version 2.0`_
+
+.. _`Apache License, Version 2.0`: https://www.apache.org/licenses/LICENSE-2.0
+
+Documentation
+-------------
+The Sphinx documentation included in the repository and hosted on readthedocs_
+should provide a good starting point for learning how to use the library.
+
+.. _readthedocs: http://dgp.readthedocs.io/en/latest/
+
+Documentation on how to use the application to follow.
+
+Contributing to DGP
 -------------------
-Package Structure
--------------------
-1. dgp
-    1. lib
-        1. gravity_ingestor.py - Functions for importing Gravity data
-        2. trajectory_ingestor.py - Functions for importing GPS (Trajectory) data
-    2. ui
-        - Contains all Qt Designer UI files and resources
-    3. main.pyw - Primary GUI classes and code
-    4. loader.py - GUI Threading code
-    5. resources_rc.py - Compiled PyQt resources file
-2. docs
-3. tests
+All contributions in the form of bug reports, bug fixes, documentation
+improvements, enhancements, and ideas are welcome.
+
+If you would like to contribute in any of these ways, then you can start at
+the `GitHub "issues" tab`_. A detailed guide on how to contribute can be found
+here_.
+
+.. _`GitHub "issues" tab`: https://github.com/DynamicGravitySystems/DGP/issues
+.. _here: http://dgp.readthedocs.io/en/latest/contributing.html

dgp/__init__.py

@@ -0,0 +1,13 @@
+# -*- coding: utf-8 -*-
+__version__ = "0.1.0"
+
+__about__ = f"""
+DGP version {__version__}
+
+DGP (Dynamic Gravity Processor) is an open source project licensed under the Apache v2 license.
+
+The source for DGP is available at https://github.com/DynamicGravitySystems/DGP
+
+DGP is written in Python, utilizing the Qt framework with the PyQt5 Python bindings.
+
+"""

dgp/__main__.py

@@ -1,18 +1,45 @@
-# coding: utf-8
-
-import os
+# -*- coding: utf-8 -*-
 import sys
+import time
+import traceback
 
-sys.path.append(os.path.dirname(__file__))
-
-# from dgp import resources_rc
-from dgp import resources_rc
+from PyQt5.QtCore import Qt
+from PyQt5.QtGui import QPixmap
+from PyQt5 import QtCore
 from PyQt5.QtWidgets import QApplication, QSplashScreen
-from dgp.gui.splash import SplashScreen
 
-"""Program Main Entry Point - Loads SplashScreen GUI"""
-if __name__ == "__main__":
-    print("CWD: {}".format(os.getcwd()))
+from dgp.gui.main import MainWindow
+
+app = None
+
+
+def excepthook(type_, value, traceback_):
+    """This allows IDE to properly display unhandled exceptions which are
+    otherwise silently ignored as the application is terminated.
+    Override default excepthook with
+    >>> sys.excepthook = excepthook
+
+    See: http://pyqt.sourceforge.net/Docs/PyQt5/incompatibilities.html
+    """
+    traceback.print_exception(type_, value, traceback_)
+    QtCore.qFatal('')
+
+
+def main():
+    _align = Qt.AlignBottom | Qt.AlignHCenter
+    global app
+    sys.excepthook = excepthook
     app = QApplication(sys.argv)
-    form = SplashScreen()
+    splash = QSplashScreen(QPixmap(":/icons/dgp_large"))
+    splash.showMessage("Loading Dynamic Gravity Processor", _align)
+    splash.show()
+    time.sleep(.5)
+    window = MainWindow()
+    splash.finish(window)
+    window.sigStatusMessage.connect(lambda msg: splash.showMessage(msg, _align))
+    window.load()
     sys.exit(app.exec_())
+
+
+if __name__ == "__main__":
+    main()

dgp/core/__init__.py

@@ -0,0 +1,6 @@
+# -*- coding: utf-8 -*-
+from .oid import OID
+from .types.reference import Reference
+from .types.enumerations import DataType, StateAction, Icon
+
+__all__ = ['OID', 'Reference', 'DataType', 'StateAction', 'Icon']

dgp/core/controllers/__init__.py

@@ -0,0 +1 @@
+# -*- coding: utf-8 -*-

dgp/core/controllers/controller_helpers.py

@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*-
+import shlex
+import sys
+from pathlib import Path
+from typing import Optional, Union
+
+from PyQt5.QtCore import QObject, QProcess
+from PyQt5.QtWidgets import QWidget, QMessageBox, QInputDialog
+
+__all__ = ['confirm_action', 'get_input', 'show_in_explorer']
+
+
+def confirm_action(title: str, message: str,
+                   parent: Optional[Union[QWidget, QObject]]=None):  # pragma: no cover
+    """
+    Prompt the user for a yes/no confirmation, useful when performing
+    destructive actions e.g. deleting a project member.
+
+    Parameters
+    ----------
+    title : str
+    message : str
+    parent : QWidget, optional
+        The parent widget for this dialog, if not specified the dialog
+        may not be destroyed when the main UI application quits.
+
+    Returns
+    -------
+    bool
+        True if user confirms the dialog (selects 'Yes')
+        False if the user cancels or otherwise aborts the dialog
+
+    """
+    dlg = QMessageBox(QMessageBox.Question, title, message,
+                      QMessageBox.Yes | QMessageBox.No, parent=parent)
+    dlg.setDefaultButton(QMessageBox.No)
+    dlg.exec_()
+    return dlg.result() == QMessageBox.Yes
+
+
+def get_input(title: str, label: str, text: str = "", parent: QWidget=None):  # pragma: no cover
+    """
+    Get text input from the user using a simple Qt Dialog Box
+
+    Parameters
+    ----------
+    title : str
+    label : str
+    text : str, optional
+        Existing string to display in the input dialog
+
+    parent : QWidget, optional
+        The parent widget for this dialog, if not specified the dialog
+        may not be destroyed when the main UI application quits.
+
+    Returns
+    -------
+
+    """
+    new_text, result = QInputDialog.getText(parent, title, label, text=text)
+    if result:
+        return new_text
+    return False
+
+
+def show_in_explorer(path: Path):  # pragma: no cover
+    """Reveal the specified path in the OS's explorer/file-browser/finder
+
+    Parameters
+    ----------
+    path : :class:`pathlib.Path`
+
+    """
+    dest = path.absolute().resolve()
+    if sys.platform == 'darwin':
+        target = 'oascript'
+        args = f'-e tell application "Finder" -e activate -e select POSIX file ' \
+               f'"{dest!s}" -e end tell'
+    elif sys.platform == 'win32':
+        target = 'explorer'
+        args = shlex.quote(f'{dest!s}')
+    elif sys.platform == 'linux':
+        target = 'xdg-open'
+        args = shlex.quote(f'{dest!s}')
+    else:
+        return
+
+    QProcess.startDetached(target, shlex.split(args))
+