sctincman / oasa Goto Github PK

OASA is a free python library for manipulating and analyzing chemical
structures and is distributed under GNU GPL. The program is provided as is
without warranty of any kind. For details see the file "gpl.txt" in main oasa
directory.
More info can be found on http://bkchem.zirael.org/oasa_en.html

INSTALL
--------------------------------------------------
OASA needs Python 2.6 or higher to run properly.
To use it, you can either copy the oasa directory inside your projects directory
or you may use

python setup.py install

to make a system-wide install

To use OASA from a python program use "import oasa"


STATUS
--------------------------------------------------
Bellow are summarized the limitations of the library. It does by no means mean that there
are no other limitations, however, for these it has no sense to write bugreports :)


OVERALL:
- no documentation beyond the source code is available
- stereochemistry support is limited to cis/trans stereochemistry on double bonds
  and only in some formats
- not much effort was invested into optimalization of the code, it may be pretty slow sometimes
- the API might be unstable


SMILES:
- cis/trans stereochemistry is supported, some attempt were made to make tetrahedral stereochemistry
  work, but it is not very much tested


InChI:
- reading is done natively by OASA
- for writing the original InChI program is needed (cInChI, cInChI.exe)


MOLFILE
- not all data in the properties block (after the bond block) are supported
  (this means that molfiles containing a properties block might not be read properly)


COORDS GENERATOR:
- coords for molecules like calix[4]arene and similar do not give a very nice picture
- tetrahedral stereochemistry is not taken into account


CAIRO_OUT:
- pycairo is required to make use of cairo_out functionality
- PNG, PDF and SVG export is supported now