Skip to content

Commit

Permalink
changes in docs due to the release of v1.1
Browse files Browse the repository at this point in the history
  • Loading branch information
marcoalopez committed Mar 23, 2016
1 parent a57efca commit 1281541
Show file tree
Hide file tree
Showing 7 changed files with 70 additions and 63 deletions.
2 changes: 1 addition & 1 deletion DOCS/FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ Frequently Asked Questions

***Who this script is for?***

This script is targeted at anyone who wants to: i) obtain a set of single 1D measures of grain size to estimate the magnitude of differential stress (or rate of mechanical work) in dynamically recrystallized rocks and ii) to derive some features of the actual 3D population of grain sizes from the population of apparent grain sizes measured in thin sections. These features include the estimation of the volume occupied by a particular grain size fraction and the estimation of the parameters that best describe the population of grain sizes (assuming that the distribution of grain sizes is log-normal). The methods implemented within the script assume that grains have near-equant or not to far from near-equant shapes, which seems acceptable most of the time for some of the most common dynamically recrystallized non-tabular grains in crustal and mantle shear zones such as olivine, quartz, feldspar, calcite or even ice when bulging (BLG) or sub-grain rotation (SGR) are the main recrystallization processes. For studies involving objects geometrically more complex than near-equant objects, we recommend other approaches such as those implemented in the *CSDCorrections* (Higgins 2000). For details see: http://www.solid-earth.net/6/475/2015/se-6-475-2015.html
This script is targeted at anyone who wants to: i) obtain a set of single 1D measures of grain size to estimate the magnitude of differential stress (or rate of mechanical work) in dynamically recrystallized rocks and ii) to derive some features of the actual 3D population of grain sizes from the population of apparent grain sizes measured in thin sections. These features include the estimation of the volume occupied by a particular grain size fraction and the estimation of the parameters that best describe the population of grain sizes (assuming that the distribution of grain sizes follows a lognormal distribution). The methods implemented within the script assume that grains have near-equant or not to far from near-equant shapes, which seems acceptable most of the time for some of the most common dynamically recrystallized non-tabular grains in crustal and mantle shear zones such as olivine, quartz, feldspar, calcite or even ice when bulging (BLG) or sub-grain rotation (SGR) are the main recrystallization processes. For studies involving objects geometrically more complex than near-equant objects, we recommend other approaches such as those implemented in the *CSDCorrections* (Higgins 2000). For details see: http://www.solid-earth.net/6/475/2015/se-6-475-2015.html

***Does the script works with Python 2.7.x and 3.4.x?***

Expand Down
2 changes: 1 addition & 1 deletion DOCS/Requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ Requirements

The scripts requires [Python][1] 2.7.x or 3.4.x and the scientific libraries [*Numpy*][2], [*Scipy*][3], [*Pandas*][9] and [*Matplotlib*][4] installed in the system. We recommend installing the [Continuum Anaconda][5] or the [Enthought Canopy][6] (maybe more easy-friendly for newbies) distributions, since they are free (at least the basic versions) and provide the most popular Python scientific packages including those named above. Both packages also provide academic free licenses for more advanced versions. In case you have space problems, there is a distribution named [miniconda][7] that only installs the packages you actually need.

The approach of the script is based on the estimation of the areas of the grain profiles obtained from thin sections. It is, therefore, necessary to measure them in advance and store the results in a text/csv file in order to use the script and derive the actual grain size population. To measure the grain sectional areas, we highly encourage you to use the [*ImageJ*][8] program, or one of their different flavours (see [here](http://fiji.sc/ImageJ)), since it is a public-domain image processing program widely used for scientific research that runs on Windows, OS X, and Linux platforms. The main aim of this documentation is not to describe how to measure the areas of the grain profiles with the *ImageJ* application but how to treat the data obtained from this or similar applications. If you are not familiarized with the *ImageJ* application don't worry, there are many tutorials on the web. Just search the terms *'ImageJ'* and *'areas'* in your favorite search engine and you will find your answers. Furthermore, you have a quick step-by-step tutorial [here](https://github.com/marcoalopez/GrainSizeTools/blob/master/DOCS/imageJ_tutorial.md)
The approach of the script is based on the estimation of the areas of the grain profiles obtained from thin sections. It is, therefore, necessary to measure them in advance and store the results in a text/csv file in order to use the script. For this task, we highly encourage you to use the [*ImageJ*][8] program, or one of their different flavours (see [here](http://fiji.sc/ImageJ)), since they are public-domain image processing programs widely used for scientific research that runs on Windows, OS X, and Linux platforms. The main aim of this documentation is not to describe how to measure the areas of the grain profiles with the *ImageJ* application but how to treat the data obtained from this or similar applications. If you are not familiarized with the *ImageJ* application don't worry, there are many tutorials on the web. Just type the terms *'ImageJ'* and *'areas'* in your favorite search engine and you will find your answers. Furthermore, you have a quick tutorial [here](https://github.com/marcoalopez/GrainSizeTools/blob/master/DOCS/imageJ_tutorial.md)



Expand Down
Loading

0 comments on commit 1281541

Please sign in to comment.