drillcore-transformations

Drillcore Transformations allows for alpha, beta and gamma drillcore structural measurement transformations.

https://github.com/nialov/drillcore-transformations

Repository

Drillcore Transformations allows for alpha, beta and gamma drillcore structural measurement transformations.

README.rst

Drillcore Transformations
=========================

|Documentation Status| |PyPI Status| |CI Test| |Coverage|

Features
--------

-  Transforms measurements from drillcores.
-  Supports alpha, beta and gamma measurements.
-  Supports .csv and .xlsx files.
-  Supports adding the column names of your data files to a custom-built
   config.ini file for each user.
-  TODO: Convention support
-  Currently supported convention explanation found in `Documentation
   and Help `__
-  **Documentation and Help**:
   https://drillcore-transformations.readthedocs.io.

Running tests
-------------

To run pytest in currently installed environment:

.. code:: bash

   poetry run pytest

To run full extensive test suite:

.. code:: bash

   poetry run doit
   # Add -n  to execute tasks in parallel
   # E.g.
   poetry run doit -n 8 -v 0
   # -v 0 is added to limit verbosity to mininum (optional)
   # doit makes sure tasks are run in the correct order
   # E.g. if a task uses a requirements.txt file that other task produces
   # the producer is run first even with parallel execution

Formatting and linting
----------------------


Formatting & linting:

.. code:: bash

   poetry run doit pre_commit
   poetry run doit lint

Building docs
-------------

Docs can be built locally to test that ``ReadTheDocs`` can also build
them:

.. code:: bash

   poetry run doit docs

doit usage
----------

To list all available commands from ``dodo.py``:

.. code:: bash

   poetry run doit list

Development
~~~~~~~~~~~

Development dependencies for ``drillcore_transformations`` include:

-  ``poetry``

   -  Used to handle Python package dependencies.

   .. code:: bash

      # Use poetry run to execute poetry installed cli tools such as invoke,
      # nox and pytest.
      poetry run 


-  ``doit``

   -  A general task executor that is a replacement for a ``Makefile``
   -  Understands task dependencies and can run tasks in parallel
      even while running them in the order determined from dependencies
      between tasks. E.g. requirements.txt is a requirement for running
      tests and therefore the task creating requirements.txt will always
      run before the test task.

   .. code:: bash

      # Tasks are defined in dodo.py
      # To list doit tasks from command line
      poetry run doit list
      # To run all tasks in parallel (recommended before pushing and/or
      # committing)
      # 8 is the number of cpu cores, change as wanted
      # -v 0 sets verbosity to very low. (Errors will always still be printed.)
      poetry run doit -n 8 -v 0

-  ``nox``

   -  ``nox`` is a replacement for ``tox``. Both are made to create
      reproducible Python environments for testing, making docs locally, etc.

   .. code:: bash

      # To list available nox sessions
      # Sessions are defined in noxfile.py
      poetry run nox --list

-  ``copier``

   -  ``copier`` is a project templater. Many Python projects follow a similar
      framework for testing, creating documentations and overall placement of
      files and configuration. ``copier`` allows creating a template project
      (e.g. https://github.com/nialov/nialov-py-template) which can be firstly
      cloned as the framework for your own package and secondly to pull updates
      from the template to your already started project.

   .. code:: bash

      # To pull copier update from github/nialov/nialov-py-template
      poetry run copier update


-  ``pytest``

   -  ``pytest`` is a Python test runner. It is used to run defined tests to
      check that the package executes as expected. The defined tests in
      ``./tests`` contain many regression tests (done with
      ``pytest-regressions``) that make it almost impossible
      to add features to ``drillcore_transformations`` that changes the results of functions
      and methods.

   .. code:: bash

      # To run tests implemented in ./tests directory and as doctests
      # within project itself:
      poetry run pytest


-  ``coverage``

   .. code:: bash

      # To check coverage of tests
      # (Implemented as nox session!)
      poetry run nox --session test_pip

-  ``sphinx``

   -  Creates documentation from files in ``./docs_src``.

   .. code:: bash

      # To create documentation
      # (Implemented as nox session!)
      poetry run nox --session docs

Big thanks to all maintainers of the above packages!

Credits
-------

-  PhD Jussi Mattila for tips, code snippets and sample materials.
-  Authors of `Orientation uncertainty goes
   bananas `__ for great article and
   complementary excel-file.

License
~~~~~~~

Copyright © 2020, Nikolas Ovaskainen.

-----


.. |Documentation Status| image:: https://readthedocs.org/projects/drillcore-transformations/badge/?version=latest
   :target: https://drillcore-transformations.readthedocs.io/en/latest/?badge=latest
.. |PyPI Status| image:: https://img.shields.io/pypi/v/drillcore-transformations.svg
   :target: https://pypi.python.org/pypi/drillcore-transformations
.. |CI Test| image:: https://github.com/nialov/drillcore-transformations/workflows/test-and-publish/badge.svg
   :target: https://github.com/nialov/drillcore-transformations/actions/workflows/test-and-publish.yaml?query=branch%3Amaster
.. |Coverage| image:: https://raw.githubusercontent.com/nialov/drillcore-transformations/master/docs_src/imgs/coverage.svg
   :target: https://github.com/nialov/drillcore-transformations/blob/master/docs_src/imgs/coverage.svg

Owner

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:

- family-names: Ovaskainen
  given-names: Nikolas
title: "drillcore-transformations"
version: "0.2.6.post9.dev0+a7d935e"
date-released: "2022-09-02"
keywords:
  - python
  - data
contact:
  - email: "nikolasovaskainen@gmail.com"
url: "https://github.com/nialov/drillcore-transformations"
repository-code: "https://github.com/nialov/drillcore-transformations"

GitHub Events

Committers

Last synced: about 3 years ago

Issues and Pull Requests

Last synced: 8 months ago

Packages