doc: update README.rst with updated installation instructions, badges, and citations

Signed-off-by: Dasun Abeykoon <Dasun20202020@hotmail.com>

Author: dabeycorn

README.rst

@@ -1,34 +1,102 @@
-DistancePrinter
-========================================================================
+|Icon| |title|_
+===============
 
-Software for calculating inter-atomic distance for given structure
+.. |title| replace:: diffpy.distanceprinter
+.. _title: https://diffpy.github.io/diffpy.distanceprinter
 
+.. |Icon| image:: https://avatars.githubusercontent.com/diffpy
+        :target: https://diffpy.github.io/diffpy.distanceprinter
+        :height: 100px
 
-REQUIREMENTS
-------------------------------------------------------------------------
+|PythonVersion| |PR|
 
-The DistancePrinter requires Python 2.7 and the following software:
+|Black| |Tracking|
 
-* ``diffpy.pdffit``
+.. |Black| image:: https://img.shields.io/badge/code_style-black-black
+        :target: https://github.com/psf/black
 
-INSTALLATION
-------------------------------------------------------------------------
+.. |PR| image:: https://img.shields.io/badge/PR-Welcome-29ab47ff
+        :target: https://github.com/diffpy/diffpy.distanceprinter/pulls
 
-To install the DistancePrinter package:
+.. |PythonVersion| image:: https://img.shields.io/badge/python-3.11%20|%203.12%20|%203.13-blue
+        :target: https://pypi.org/project/diffpy.distanceprinter/
 
-    python setup.py install
+.. |Tracking| image:: https://img.shields.io/badge/issue_tracking-github-blue
+        :target: https://github.com/diffpy/diffpy.distanceprinter/issues
 
-By default the files are installed in the system directories, which are
-usually only writeable by the root.  See the usage info "./setup.py install
---help" for options to install as a normal user under a different location.
-Note that installation to non-standard directories you may require adjustments
-to the PATH and PYTHONPATH environment variables.
+Distance Printer, calculate the inter atomic distances. Part of xPDFsuite
 
-CONTACTS
-------------------------------------------------------------------------
+Citation
+--------
 
-For more information on diffpy.Structure please visit the project web-page
+If you use diffpy.distanceprinter in a scientific publication, we would like you to cite this package as
 
-http://www.diffpy.org/
+        Xiaohao Yang, Pavol Juhas, Christopher L. Farrow and Simon J. L. Billinge, xPDFsuite: an end-to-end
+        software solution for high throughput pair distribution function transformation, visualization and
+        analysis, arXiv 1402.3163 (2014)
 
-or email Prof. Simon Billinge at sb2896@columbia.edu.
+Installation
+------------
+``diffpy.distanceprinter`` is normally installed as part of the ``xpdfsuite`` software, so please refer to the
+installation instructions detailed in the ``README.rst`` file of ``xpdfsuite`` `here <https://github.com/diffpy/diffpy.xpdfsuite/blob/main/README.rst>`_.
+
+Independent Installation
+------------------------
+You can also install ``diffpy.distanceprinter`` independently for yourself.
+
+Assuming you have a wheel file in the current working directory, in an active conda environment please type
+
+    pip install ./diffpy.distanceprinter-VERSION.whl
+
+where you replace VERSION with the actual version you have so the command matches the filename of the
+wheel file you have.
+
+The commands to create and activate the conda environment with name "conf-env" is
+
+    conda create -n conf-env python=3.13
+    conda activate conf-env
+
+If you don't have conda installed, we recomment you install `miniconda
+<https://docs.conda.io/projects/miniconda/en/latest/miniconda-install.html>`_
+To install this software from a Python wheel distribution format execute
+
+    pip install ./diffpy.distanceprinter-VERSION.whl
+
+If you are a developer, you can also install this package from sources. First, obtain the source archive
+from `GitHub <https://github.com/diffpy/diffpy.distanceprinter/>`_.
+Install the packages in ``./requirements/conda.txt`` and ``./requirements/tests.txt``
+using the `--file`` command:
+
+    conda activate conf-env
+    conda install --file ./requirements/conda.txt
+    conda install --file ./requirements/tests.txt
+    pip install -e .    # assuming you are in the top level directory of the package
+
+After installing the dependencies, ``cd`` into your ``diffpy.distanceprinter`` directory
+and run the following ::
+
+        pip install .
+
+This package also provides command-line utilities. To check the software has been installed correctly, type ::
+
+        diffpy.distanceprinter --version
+
+You can also type the following command to verify the installation. ::
+
+        python -c "import diffpy.distanceprinter; print(diffpy.distanceprinter.__version__)"
+
+
+To view the basic usage and available commands, type ::
+
+        diffpy.distanceprinter -h
+
+
+Contact
+-------
+
+For more information on diffpy.distanceprinter please visit the project `web-page <https://www.diffpy.org>`_ or email Simon J.L. Billinge Group at sb2896@columbia.edu.
+
+Acknowledgements
+----------------
+
+``diffpy.distanceprinter`` is built and maintained with `scikit-package <https://scikit-package.github.io/scikit-package/>`_.