.. highlight:: rst

.. image:: images/ml8.png
    :height: 80px
    :align: left

|

########
cosymlib
########

**Cosymlib** is a python library for computing continuous symmetry & shape measures (CSMs & CShMs).
Although its main aim is to provide simple and ready-to-use tools for the analysis of the symmetry &
shape of molecules, many of the procedures contained in **cosymlib** can be easily applied to
any finite geometrical object defined by a set of vertices or a by mass distribution function.

The basic tasks included in the current version of **cosymlib** are:

1. **Molecular structure analysis**

    * Calculation of Continuous Shape Measures (CShMs)
    * Calculation of Continuous Symmetry Measures (CSMs)
    * Calculation of Continuous Chirality Measures (CCMs)

2. **Electronic structure analysis**

    * Pseudosymmetry analysis of molecular orbitals & wavefunctions
    * Continuous Symmetry & Chirality Measures for the molecular electron density

.. toctree::
    :maxdepth: 1
    :caption: cosymlib

    introduction
    install
    usage
    tutorials
    links
    api

**Cosymlib** is being developed by the **Electronic Structure & Symmetry (ESS)** group
at the Department de Ciència de Materials i Química Física
and the Institut de Química Teòrica i Computacional (IQTCUB). University of Barcelona.

------

.. image:: images/logo-ess.png
    :height: 52px
    :align: left
    :target: http://www.ee.ub.edu

.. image:: images/logo_ub.jpg
    :height: 52px
    :align: left
    :target: https://www.ub.edu/

.. image:: images/logo_iqtc.png
    :height: 52px
    :align: left
    :target: https://www.iqtc.ub.edu

.. image:: images/logo_mmaeztu.png
    :height: 52px
    :align: left