Add Particle Analysis Documentation

Author: TomSlater

docs/particle_analysis.rst

@@ -2,4 +2,43 @@
 
 *****************
 Particle Analysis
-*****************
+*****************
+
+Once you have chosen your segmentation parameters and successfully prepared a prameters object you can use this to perform Particle Analysis.
+
+.. code-block:: python
+
+    >>> import hyperspy.api as hs
+    >>> data = hs.load('ParticleSpy/Data/JEOL HAADF Image.dm4')
+    >>> params = ps.parameters()
+    >>> params.load()
+    >>> particles = ps.ParticleAnalysis(data, params)
+
+Particle Analysis will run the segmentation on your data and calculate a number of parameters for each particle.
+
+The calculated parameters include:
+- Area
+- Equivalent circular diameter
+- Major and minor axes lengths
+- Circularity
+- Eccentricity
+- Total particle intensity
+- Zone axis (if atomic resolution images of fcc structure, looking to expand this!)
+
+.. code-block:: python
+
+    >>> #Syntax for accessing particle properties.
+    >>> particles.list[0].properties['area']
+
+In addition, Particle Analysis will also segment and process EDS data if given as an additional dataset in the data list.
+
+Particle Analysis can do the following processing on EDS data:
+- Obtain the EDS spectrum of each particle.
+- Obtain elemental maps of each particle.
+- Get the composition of each particle if k-factors or zeta-factors are supplied in the parameters object.
+
+.. code-block:: python
+
+    >>> params = ps.parameters.load()
+    >>> params.generate_eds(eds_method='CL',elements=['Pt','Au'],factors=[1.7,1.9],store_maps=False)
+    >>> particles = ps.ParticleAnalysis(data, params)