Skip to main content

No project description provided

Project description

MolPDF: A PDF Document Generator for SMILES!

License: MPL 2.0 Python PyPI version DOI

Welcome to MolPDF! The document generator for cheminformatics! MolPDF does one thing right now and is convert a list of 1D SMILES to a 2D image into a PDF! It's super lightweight and only requires python 3.4 >+.

MolPDF is super new and under heavy development so if there are any bugs then please report them! Eventually, I will be able to get some docs, jupyter notebooks, and some asciis but in the meantime check out the source code and play around.

Announcements

  • June 7th 2020 First version 0.1.0 is released to the public
  • June 19th 2020 Second version 0.2.0 is released to the public with MolPDFParser

Installation

MolPDF is going to be distribute via PyPi and as the content store grows we can expand it to other pieces of software making it accessible to all regardless of what you use. Alternatively, you could have a glance at the source code and copy/paste it yourself.

QuickStart

Generate a PDF of SMILES

    
    document = MolPDF(name='example.pdf')
    document.add_title('Chemical Library Test')
    document.add_spacer()
    smiles_list = ['C(CNC(C(C)N)=O)(=O)O', 'C(CNC(C(C)N)=O)(=O)O', 'C(CNC(C(C)N)=O)(=O)O']
    document.generate(smiles=smiles_list)

Read a MolPDF Generated File into SMILES


    document = MolPDFParser('example.pdf')
    smiles_list = document.extract_smiles()
    print (smiles_list)
    >>> ['C(CNC(C(C)N)=O)(=O)O', 'C(CNC(C(C)N)=O)(=O)O', 'C(CNC(C(C)N)=O)(=O)O']


Generate a List a PDF of Amino Acids


    # Turning an Amino Acid List into a PDF
    

    amino_acid_side_chains = {
        "alanine": "C",  "arginine": "CCCCNC(N)=N", "asparagine": "CCC(N)=O", "aspartic acid": "CC(O)=O",
        "cysteine": "CS", "glutamic acid": "CCC(O)=O", "glutamine": "CCC(N)=O", "glycine": "[H]",
        "histidine": "CC1=CNC=N1", "isoleucine": "C(CC)([H])C", "leucine": "CC(C)C", "lysine": "CCCCN",
        "methionine": "CCSC", "phenylalanine": "CC1=CC=CC=C1", "proline": "C2CCCN2", "serine": "CO",
        "threonine": "C(C)([H])O", "tryptophan": "CCC1=CNC2=C1C=CC=C2", "tyrosine": "CC1=CC=C(O)C=C1",
        "valine": "C(C)C"
    }

    document = MolPDF(name='amino_acids.pdf')
    document.add_title('Chemical Library Test')
    document.add_spacer()

    smiles_amino_acids = list(amino_acid_side_chains.values())
    document.generate(smiles=smiles_amino_acids)
    

Performance

Generating the 2D images into a PDF can be cumbersome if you have a large chemical library - below I have some average time statistics of how fast a PDF can be generated and parsed using MolPDF and MolPDFParser.

Method: 'MolPDF.generate()'

Length of Smiles: 10 | Time to execute: ~ 0.19 seconds Length of Smiles: 100 | Time to execute: ~ 1.29 seconds Length of Smiles: 1000 | Time to execute: ~ 12.17 seconds

Structure of MolPDF

Currently, the main subpackages are:

  • molpdf: molpdf main class.

Genesis

MolPDF was developed so I could publish chemical libraries in an easy supporting information minable data for publications. I hope to make it easy for folk by making it a solely lightweight python package with only requirements to be reportlab.


External links

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

molpdf-0.2.2.tar.gz (8.0 kB view details)

Uploaded Source

File details

Details for the file molpdf-0.2.2.tar.gz.

File metadata

  • Download URL: molpdf-0.2.2.tar.gz
  • Upload date:
  • Size: 8.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.6

File hashes

Hashes for molpdf-0.2.2.tar.gz
Algorithm Hash digest
SHA256 b0b9fc4cb4a86e9bfebe699b9c5ff786ecfb3105aaefbc95c85a7ec2b46f0c65
MD5 49941668f039953cd267a455388fdbcd
BLAKE2b-256 7506da3aa9433afc4a83bffb14dec37c58f71de33d7c22b88a1f64e4a587b304

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