Skip to main content

Continuous measures of shape and symmetry

Project description

Build Status Coverage Status PyPI version DOI Open In Colab

CoSymLib

Python library to compute continuous shape and symmetry measures of molecular structures
Online manual: http://cosymlib.readthedocs.io

Main features

  • Continuous Shape and Symmetry measures of molecular geometries
  • Continuous Symmetry measures of electronic structure of molecules
  • Support for common file types including XYZ, coor, pdb & fchk
  • Usage through python API or command line tools

Requirements

  • Python 2.7/3.4 or higher
  • Matplotlib
  • Numpy
  • PyYaml
  • Symgroupy
  • Wfnsympy
  • Huckelpy
  • Blas & Lapack libraries
  • Fortran compiler

Examples using command line tools

Shape measure

$ shape cf4.xyz -c 1 -l

----------------------------------------------------------------------
 COSYMLIB v0.10.5
 Electronic Structure & Symmetry Group
 Institut de Quimica Teorica i Computacional (IQTC)
 Universitat de Barcelona
----------------------------------------------------------------------

Available reference structures with 4 Vertices:

Label       Sym       Info

SP-4        D4h       Square
T-4         Td        Tetrahedron
SS-4        C2v       Seesaw
vTBPY-4     C3v       Axially vacant trigonal bipyramid



$ shape cf4.xyz -c 1 -m all

----------------------------------------------------------------------
 COSYMLIB v0.10.5
 Electronic Structure & Symmetry Group
 Institut de Quimica Teorica i Computacional (IQTC)
 Universitat de Barcelona
----------------------------------------------------------------------

Structure         SP-4       T-4        SS-4       vTBPY-4

cf4,             33.333,     0.000,     9.790,     3.573,


----------------------------------------------------------------------
                    End of calculation
----------------------------------------------------------------------

Geometrical symmetry measure

$ gsym cf4.xyz -l

----------------------------------------------------------------------
 COSYMLIB v0.10.6
 Electronic Structure & Symmetry Group
 Institut de Quimica Teorica i Computacional (IQTC)
 Universitat de Barcelona
----------------------------------------------------------------------

Available symmetry groups

E      Identity Symmetry
Ci     Inversion Symmetry Group
Cs     Reflection Symmetry Group
Cn     Rotational Symmetry Group (n: rotation order)
Sn     Rotation-Reflection Symmetry Group (n: rotation-reflection order)



$ gsym cf4.xyz -m Ci

----------------------------------------------------------------------
 COSYMLIB v0.10.6
 Electronic Structure & Symmetry Group
 Institut de Quimica Teorica i Computacional (IQTC)
 Universitat de Barcelona
----------------------------------------------------------------------

Evaluating symmetry operation : Ci
 
cf4          16.667

----------------------------------------------------------------------
                    End of calculation
----------------------------------------------------------------------

Wave function symmetry analysis

$ mosym NF3.fchk -m C3 -mo

----------------------------------------------------------------------
 COSYMLIB v0.10.6
 Electronic Structure & Symmetry Group
 Institut de Quimica Teorica i Computacional (IQTC)
 Universitat de Barcelona
----------------------------------------------------------------------


Symmetry group : C3
Molecule : NF3
--------------------------------------
Atomic Coordinates (Angstroms)
--------------------------------------
N    -0.000022    0.000014    0.483415
F     1.225707   -0.219543   -0.125324
F    -0.802975   -0.951706   -0.125331
F    -0.422715    1.171239   -0.125335

WaveFunction: Irred. Rep. Decomposition
     ------------------
        A        E   
     ------------------
a-wf  1.000    0.000
b-wf  1.000    0.000
WFN   1.000    0.000

Symmetry axis orientation
center:   0.00000036   -0.00000023    0.00244913
axis  :   0.00001508   -0.00001685    1.00000000
axis2 :   0.00000000    1.00000000    0.00001685

Molecule : NF3
--------------------------------------
Atomic Coordinates (Angstroms)
--------------------------------------
N    -0.000022    0.000014    0.483415
F     1.225707   -0.219543   -0.125324
F    -0.802975   -0.951706   -0.125331
F    -0.422715    1.171239   -0.125335

Alpha MOs: Irred. Rep. Decomposition
     ------------------------------------
       occup    E(eV)     A        E   
     ------------------------------------
   1     1   -708.54    0.994    0.006
   2     1   -708.53    0.002    0.998
   3     1   -708.53    0.004    0.996
   4     1   -424.19    1.000    0.000
   5     1    -45.23    1.000    0.000
   6     1    -41.57    0.000    1.000
   7     1    -41.57    0.000    1.000
   8     1    -26.74    1.000    0.000
   9     1    -18.48    0.000    1.000
  10     1    -18.48    0.000    1.000
  11     1    -18.40    1.000    0.000
  12     1    -15.18    0.000    1.000
  13     1    -15.18    0.000    1.000
  14     1    -14.24    1.000    0.000
  15     1    -13.54    0.000    1.000
  16     1    -13.54    0.000    1.000
  17     1    -10.69    1.000    0.000
  18     0     12.21    0.000    1.000
  19     0     12.21    0.000    1.000
  20     0     12.52    1.000    0.000

Beta MOs: Irred. Rep. Decomposition
     ------------------------------------
       occup    E(eV)     A        E   
     ------------------------------------
   1     1   -708.54    0.994    0.006
   2     1   -708.53    0.002    0.998
   3     1   -708.53    0.004    0.996
   4     1   -424.19    1.000    0.000
   5     1    -45.23    1.000    0.000
   6     1    -41.57    0.000    1.000
   7     1    -41.57    0.000    1.000
   8     1    -26.74    1.000    0.000
   9     1    -18.48    0.000    1.000
  10     1    -18.48    0.000    1.000
  11     1    -18.40    1.000    0.000
  12     1    -15.18    0.000    1.000
  13     1    -15.18    0.000    1.000
  14     1    -14.24    1.000    0.000
  15     1    -13.54    0.000    1.000
  16     1    -13.54    0.000    1.000
  17     1    -10.69    1.000    0.000
  18     0     12.21    0.000    1.000
  19     0     12.21    0.000    1.000
  20     0     12.52    1.000    0.000

----------------------------------------------------------------------
                    End of calculation
----------------------------------------------------------------------

Example using Python API

from cosymlib import Molecule, Geometry


# Define geometry
geometry = Geometry(positions=[[ 0.0000,  0.0000,  0.0000],
                               [ 0.5288,  0.1610,  0.9359],
                               [ 0.2051,  0.8240, -0.6786],
                               [ 0.3345, -0.9314, -0.4496],
                               [-1.0685, -0.0537,  0.1921]],
                    symbols=['C', 'H', 'H', 'H', 'H'])

# Shape measure
shp_measure = geometry.get_shape_measure('T-4', central_atom=1)

# Geometrical symmetry measure
sym_geom_measure = geometry.get_symmetry_measure('C3', central_atom=1)

#Create molecule from geometry (generate electronic structure with Extended Hukel method)
molecule = Molecule(geometry)

# Wave function symmetry measure
wf_sym_measure = molecule.get_wf_symmetry('Td')

# Electronic density measure
dens_sym_measure = molecule.get_dens_symmetry('Td')

Contact info

Abel Carreras
abelcarreras83@gmail.com
Donostia International Physics Center (DIPC)

Pere Alemany
p.alemany@ub.edu
Electronic Structure & Symmetry group
Department of Materials Science and Physical Chemistry
Institut de Química Teòrica i Computacional (IQTC-UB)
University of Barcelona

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cosymlib-0.12.1.tar.gz (78.4 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

cosymlib-0.12.1-cp312-cp312-win_amd64.whl (219.5 kB view details)

Uploaded CPython 3.12Windows x86-64

cosymlib-0.12.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

cosymlib-0.12.1-cp312-cp312-macosx_11_0_arm64.whl (272.8 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

cosymlib-0.12.1-cp311-cp311-win_amd64.whl (219.5 kB view details)

Uploaded CPython 3.11Windows x86-64

cosymlib-0.12.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

cosymlib-0.12.1-cp311-cp311-macosx_11_0_arm64.whl (209.9 kB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

cosymlib-0.12.1-cp310-cp310-win_amd64.whl (219.5 kB view details)

Uploaded CPython 3.10Windows x86-64

cosymlib-0.12.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

cosymlib-0.12.1-cp310-cp310-macosx_11_0_arm64.whl (147.7 kB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

File details

Details for the file cosymlib-0.12.1.tar.gz.

File metadata

  • Download URL: cosymlib-0.12.1.tar.gz
  • Upload date:
  • Size: 78.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for cosymlib-0.12.1.tar.gz
Algorithm Hash digest
SHA256 ab99f14f354636edfd6d446fb165dfe633a6d36693e53d8c232e728e657c5627
MD5 d3f7455c169857910228d125baa41bce
BLAKE2b-256 8d66f7bbe782a8e1fea0b524cf6244cc067ed9306b4c56a1ba9ca65899ffee46

See more details on using hashes here.

File details

Details for the file cosymlib-0.12.1-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: cosymlib-0.12.1-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 219.5 kB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for cosymlib-0.12.1-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 7f674bf0a175d8a109c02451a54fa2c95f059cbb10c60449c0177be14dc5e17c
MD5 9e85d7b27f927d368094ed773b50ad5f
BLAKE2b-256 56815b78286a4b57a930943fdcda3750ff4c9c5fd616eac04a7ec0be9c166063

See more details on using hashes here.

File details

Details for the file cosymlib-0.12.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for cosymlib-0.12.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 06c78128039e2cdf44465521cd2bb2a4393c76620b1b679694eae4735ce0e124
MD5 6a0f925bfad83e422498c0a56c91706d
BLAKE2b-256 f0bd0a5a739c746a457a3b5e0c53f490f2a5e07e1f07d64f19cfa5bece05b00c

See more details on using hashes here.

File details

Details for the file cosymlib-0.12.1-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for cosymlib-0.12.1-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 4b58a8c5ada78a8e35e785f031674a0c7c9ff3b81b54d1adb932569f9bab612a
MD5 422e8f1a6ea0aa21daac80ed99836c02
BLAKE2b-256 4a46f5e7ff3261b060877f9112bfd92ef11d65798dc54f64c448ddd4e979791d

See more details on using hashes here.

File details

Details for the file cosymlib-0.12.1-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: cosymlib-0.12.1-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 219.5 kB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for cosymlib-0.12.1-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 6cac3122ad7c7a7247e6bfd4bac9b8d9804ba4dbbc89ce926b4c540e742e1473
MD5 b7a026b3a59b8abd1619c40d4a130206
BLAKE2b-256 361be2f880421cecd67feb8989b3f88235ff1920cc143ccd2af062332301df39

See more details on using hashes here.

File details

Details for the file cosymlib-0.12.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for cosymlib-0.12.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 c750db790b871541a87e3649ca5253d5cee10a71f6059d9964f128033ccf49ac
MD5 d615a3b470f8ce6059e261a616013c20
BLAKE2b-256 d7e0d2cf5cf8d502bd6135b8450bf7ca6bee8ffe5480b6eac168de51315e50a4

See more details on using hashes here.

File details

Details for the file cosymlib-0.12.1-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for cosymlib-0.12.1-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 fef60b2458e7c0cb659fbb80ad17f0ca9fa56cde39b2898454c85bf323abcb1d
MD5 4dec3d14d83ad2abd180b239aef3d3bf
BLAKE2b-256 177fabd2fba33ded841e29e294de3669eafa4402e535a70fc2bfffeaf39c963a

See more details on using hashes here.

File details

Details for the file cosymlib-0.12.1-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: cosymlib-0.12.1-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 219.5 kB
  • Tags: CPython 3.10, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for cosymlib-0.12.1-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 84324c6e63822a1239fe994d21c7bed01aa9017c413cba35dbaba272d651a4fc
MD5 c68aa996ee41958fa2ef6b94f83bf3d5
BLAKE2b-256 9753af299b0c7f649d10a9e0cf4c474ea70ae89ed51fb9302d88cf0db56264b3

See more details on using hashes here.

File details

Details for the file cosymlib-0.12.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for cosymlib-0.12.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 9b9aec5004e7e84ff00b6a9b1243cfea524546e03fffc9c5be4f7cbe925e57eb
MD5 cecbdcda264a7a87bba845ae48b7ab09
BLAKE2b-256 71006fbba41185898ac8370344c61cbdc7e0349535b286a91b1d607362ff99fe

See more details on using hashes here.

File details

Details for the file cosymlib-0.12.1-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for cosymlib-0.12.1-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 ff2a565e110fb07541786b161605cb95b03aab06e96171a4bda398aca06966fb
MD5 231655350bedc1c5ad6ba919e61778a7
BLAKE2b-256 5cf163d8eeccce3bbbc1c9c65d14eb41969e23c9904e0d05ac4c617480a55366

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page