Git Product home page Git Product logo

rockr's Introduction


http://apps.earthsciences.iupui.edu:3838/RockR

RockR

RockR! is a program designed to make plotting data onto geoscience discriminant and classification diagrams easy. It was created as a classroom and laboratory tool for students in petrology, mineralogy, geochemistry, sedimentology/stratigraphy, and introductory geology courses. The application streamlines the process of plotting data onto a variety of discrimination diagrams, as well as styling the plot with straightforward, yet extensive, aesthetic controls. The application output is publication quality and can be easily retrieved. The ease and efficiency of RockR! allows students and researchers using the app more time to devote to data interpretation, rather than lengthy plotting processes.

RockR! provides a graphical user interface to the R programming language. For ternary plots, RockR! wraps functionality provided by the R package ggtern. For TAS diagrams and metamorphic facies diagrams, RockR! wraps functionality provided in the R package ggplot2. Additional R packages used include Shiny, shinywidgets, shinyBS, shinycssloaders, colourpicker, readxl, readr, grid, gridExtra, knitr, ggalt, and png.

If you wish to download RockR! to contribute to or understand the behind-the-scenes workings of it, you can download the files here or fork this repository. If you do, make sure to read and adhere to the license agreement (link at the bottom of this README).

If you wish to see our reference list for RockR!, create a citation for RockR!, or contact the people behind RockR!, please click on the “Credits” tab.

If you’d like to learn how to input data into RockR!, including limitations on data input, click on the “Inputting Data” tab after clicking “Help”. You may also download sample data sets there.

For instructions to create and edit your plots, please click on the “Building Plots” tab after clicking “Help”.

There are a number of discrimination plots, diagrams, and curves pre-programmed into the software. Please click on the “Available Plots” tab to see the current list of pre-programmed options, their designations within the app, and the primary source literature references if available. You will see the “Available Plots” tab after clicking “Help”.

Project Structure

RockR! is divided into three sections: ternary, bivariate, and metamorphic facies. The three sections allow you to plot data onto three different types of plots: ternary diagrams, bivariate plots, and metamorphic facies diagrams respectively. Depending on what plot you want to create, click on the “Bivariate”, “Ternary”, or “Mm Facies” tabs on the top of the page.

Ternary Section

The ternary section includes an introductory walkthrough of ternary diagrams, how they work, and how to plot data onto them. You can plot data on the blank starting plot and assign your own labels to the three axes, or you can select a pre-programmed discrimination diagram using the drop-down menu on the right panel of the Plot tab.

Additional controls for adding or removing plot components are available below the main plot display. In addition, if you have chosen a discrimination diagram, further additional control for color and transparency for individual fields will show below the main plot.

Bivariate Section

The plot axes can be manipulated within a reasonable range to customize plots for publication. Additional plot controls also allow for manipulation of points on the plot, alteration of axis limits, alteration of tick increments, and transformations (i.e. logarithmic).

The bivariate section includes an introductory walkthrough of total alkali-silica (TAS) plots, the classification reasoning for the different igneous rock types, and how to plot data onto them. For TAS plots, there are also options to add and remove a line dividing alkaline and subalkaline rock regions of the plot, and the rock type field labels may also be added or removed from the plot.

Metamorphic Facies Section

The metamorphic facies section includes a brief introduction to metamorphic facies, including links to relevant literature. This section offers two different metamorphic facies plots, the ability to invert the plot to relate depth and pressure to each other visually, and numerous curves and additional features that can be toggled on and off.

Contributors

Acknowledgments

  • Indiana University - Purdue University of Indianapolis (IUPUI)
    • Department of Earth Sciences

How to Cite RockR

License

Licensed under the GNU General Public License v3.0

rockr's People

Contributors

jshukle avatar rockrwebapp avatar tzurloye avatar

Stargazers

 avatar

Forkers

jshukle tzurloye

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.