/dddToStrikeDip

Bash script that converts dip/dip direction measurements to strike/dip measurement in various formats

Primary LanguageShellGNU General Public License v3.0GPL-3.0

dddToStrikeDip

Bash script that converts planar measurements in dip-dip direction format to strike-dip format.

Contents

Target User

Engineering geologists, structural geologists, geotechnical engineers having planar measurements in dip-dip direction format that should be converted to the ones in strike-dip format.

Building and Installation

Don't have to build anything, related bash shell script can be used by copying the script file in your system, setting file permissions and executing with required command-line arguments.

Requirements

Operating System: Linux

Distro          : Any

Shell           : bash          ≥ 4.3.48

Other           : All numerical measurements must be integer values

Building

Doesn't require a building process, can be used directly.

Installation

Doesn't require an installation process, can be directly copied anywhere.

Removal

Can be removed by directly deleting the related script file.

Usage

Usage: ./dddToStrikeDip (-a | -b | -A | -B) [-r] [-d DELIM] (MEASUREMENT | MEASUREMENT_FILE)...
-a output in RHR-azimuth format, dip direction 90⁰ clockwise from strike
-b output in RHR-bearing format, dip direction 90⁰ clockwise from strike
-A output in UK-RHR-azimuth format, dip direction 90⁰ counter-clockwise from strike
-B output in UK-RHR-bearing format, dip direction 90⁰ counter-clockwise from strike
-d DELIM use DELIM instead of space as the delimiter of output values
-r print out number of converted and invalid measurements
-h Display help

where

  • an example of MEASUREMENT is 32/315,
    for option -a a value of 225/32NW,
    for option -b a value of S45E/32NW,
    for option -A a value of 045/32NW,
    for option -B a value of N45E/32NW.

  • a MEASUREMENT_FILE is a list of MEASUREMENTs all having a common format, each written in a single line (measurements having different formats are not allowed in a MEASUREMENT_FILE)

  • any MEASUREMENT value that DOESN'T conform to the related format will be counted as Invalid or
    if located in a MEASUREMENT_FILE will be counted as Invalid Infile

Example:
$ ./dddToStrikeDip -aAbBrd ', ' 32/315
225/32NW, S45W/32NW, 045/32NW, N45E/32NW,
Converted Infile : 0
Invalid Infile : 0
Converted : 1
Invalid : 0

Support

All types of constructive criticisms and contributions are welcome, and I'll try my best for solving your problems related with the scripts and patches presented in this repo as an engineering geologist, a self-learner and a guy who enjoys coding.

For further info please check SUPPORT.md.

Roadmap

Essentially I've created this repo to solve my problem at the first place and I've to admit I really have no idea in the beginning but with time I've learned lots of stuff from the guys and the gals like myself who has tried to solve their problems and decided to share their findings with other individuals who might face similar problems. Remembering all of them individually at this point is a bit hard for me so I've created this repo to show my graditude.

Additional ideas related with the future are welcomed.

Code of Conduct

Contributor Covenant version 2.1 is the effective code of conduct for this project.

For further info please check CODE_OF_CONDUCT.md.

Contributing

Please check CONTRIBUTING.md.

License

Software presented in this repository is licensed with GPLv3.

For further info please check COPYING.

Project Status

This project is actively maintained by Necib ÇAPAR.