- Open Access
Chemotion-ELN part 2: adaption of an embedded Ketcher editor to advanced research applications
Journal of Cheminformatics volume 10, Article number: 38 (2018)
The Ketcher editor, available as an Open Source software package for drawing chemical structures, has been expanded to include several features that allow storage, management and application of templates, as well as the use of symbols for a planning and processing of solid phase synthesis. In addition, tools for the drawing of coordinative bonds to represent e.g. organometallic compounds were added. The editor has been implemented into an Electronic Lab Notebook (ELN) application which enables the use of the Ketcher editor for advanced operations in chemistry research. The developments of the ELN-integrated Ketcher (ketcher-rails) support the retrieval of identifiers and structure-related information from external databases and the molecule-based calculation of analytical values. The reworked editor can be used to generate molecular structures in reaction templates and to generate syntheses plans.
Information and identifiers
The obtained identifiers and names of molecules are not only used for the completion of molecule forms of the ELN, but are also directly available in the UI of the molecule editor. This direct availability of information is of particular interest, as structures and sub-structures can be investigated in a very fast manner e.g. according to their molecular weight and exact mass without the need to save the information in the ELN (please see Additional file 1: Figure S1).
Drawing and processing of coordinative bonds
The availability of coordinative bonds has been a highly demanded feature by the students using the Chemotion ELN. We therefore implemented a basic functionality that allows to draw and store e.g. organometallic structures (Fig. 2). The molfile format V3000 officially supports, since November 2011, coordinative bonds through a type 9 declaration in the bond block. Ketcher reads molecule structures in V3000 molfile, but exports in V2000 format. However, the type 9 declaration could be backported with V2000 format. The coordinative bonds can be drawn by selection of either a dashed bond or a dative bond symbol in the ketcher-rails UI.
Management of common templates and template categories
The ELN-embedded ketcher-rails editor was modified to facilitate the input of structures and to maximize its benefits for the user. While the original Ketcher editor offers only a small selection of standard templates by default, a general approach towards the addition of common templates that are persisted in the Chemotion-ELN DB was developed. To this aim, the ELN serves as an environment for the ketcher-rails editor to allow the management of templates through an advanced management model. Within this model, a moderator role was implemented which restricts the permissions of the template registration only to authorized users. The authorized moderator has access to a special UI of the ELN which allows the management of (1) common template categories, (2) single templates, (3) abbreviations, and (4) monomers for the generation of oligomeric structures. Only a moderator can create, edit or delete template categories or common templates (see Additional file 1: Figure S2). The currently available template categories supported by ketcher-rails v0.1.3 and the amount of currently assigned templates are shown in Table 1.
The creation of new templates and the assignment to a template category is managed by an input UI that supports the drawing of new templates via the ketcher-rails editor, the use of a molfile for the import of one molecule or the use of a sd file (sdf) which contains multiple chemical table files. The imported structures are saved and can be edited at any time to add the name of the template, the category to which it belongs, and to define the status of the template generation. While all loaded structures obtain the status “pending” automatically, only templates of which the status is changed into “approved” are passed to the molecule editor’s common template selection. Once the template is added to the template list with an approved status, the user can select the template via choosing the corresponding template category. A list of all category members is shown and the desired template can be added to the ketcher-rails editor UI (see Additional file 1: Figure S3). Templates which are not in the desired presentation can be improved via the ketcher-rails clean up function (see Additional file 1: Figure S4). The data for several templates and template categories are available with the current ketcher-rails and can be imported through a rails rake task to populate the ketcher-rails DB tables. This allows the ELN users to benefit from our previously imported structures. The ten currently available template groups, which are represented with an icon are summarized in Table 1.
Regarding the ketcher-rails editor embedded in our ELN, the most often requested feature by users was the availability of additional user defined templates, in addition to the above mentioned standard templates. The creation of the user-defined templates enables a fast input and change of chemical structures combined with a basic management of the stored structures for the assignment of a name, the text-based search for saved structures and their deletion. The user can either draw a molecule from scratch, can import a molfile to the editor, or open and modify an existing molecule from the ELN to load the necessary structural information (Fig. 3a). The given structure is added automatically to the user’s list of templates with the specified name (Fig. 3b) and the corresponding image of the template is generated as a SVG and a smaller PNG image to be used as an icon. The feature is designed to be used as easy-to-access collection of the most used chemical structure templates. Each template created by a user is restricted to be accessed only by the creator.
Definition of oligomers and input to the editor
As organic chemistry is not only the chemistry of small molecules but also covers the synthesis and use of oligomeric to polymeric material, a suitable molecule editor should reflect mechanisms for a fast input of structures with diverse repetitions of known components. The definition of these components should also be adaptable to the user group of the editor or the ELN to which it is embedded. Therefore, a registration process was designed based on the above described template registration. Several additional requirements had to be implemented because of the more complex application of these types of templates. One of the most important requirements for the registration of monomers is the definition of attachment points which have to be assigned to particular atoms of the monomer. This was solved via the information panel already available in the ketcher-rails editor. The panel was complemented with an additional checkbox that allows the assignment of not only one atom to an attachment point but also the assignment of a second atom to a secondary attachment point (see Additional file 1: Figure S5). We designed the oligomer-generation tool for peptoid-drawings as this function was requested very often in our research group but the structure of the oligomer-building function allows also the creation other types of oligomers since the monomer generation and the assignment of attachment points can be adapted to the user’s preferences. In a previous step, several monomers with common abbreviations according to peptoid-monomer nomenclature were added as monomer templates. The desired, exemplarily chosen sequence (N2Ph-N1cPr-N2iPr-N2Me-N3m-N1ph-N1ppg) was added to the editor giving the desired product as output view in the ketcher-rails editor. Several adaptions can be made to improve the representation of the given peptoid. The user can, for example, switch from normal to reversed order which changes the sequence order from N to C terminus and vice versa (see Additional file 1: Figure S6).
Polymer supported reactions and reactions on surfaces
The work with an embedded editor requiring the definition of well-defined structures involves problems concerning the registration and processing of polymers which are at least to some extent undefined. To the best of our knowledge, challenges to process polymers as partially undefined structures have not been solved and current editors do not tackle this problem. The latter issue still causes severe limitations for the use of electronic management and storage systems in the field of chemistry. In order to allow the presentation and processing of molecules immobilized on polymers, we introduce a polymer symbol and a symbol for surfaces to be used in combination with the ELN environment to process information for adequate calculations with the undefined molecule. This solution can be applied to all solid-supported reactions as it reflects the constitution of the polymer (elemental composition) which is necessary for reaction planning and calculation. However, for advanced applications in polymer chemistry, the herein suggested model has to be further improved and extended. According to current developments, solid-supported molecules are created by adding the commonly used symbol for polymers to a chemical structure (Fig. 4).
The polymer-connected structure is then passed to a molfile by substitution of the polymer symbol with a methyl group as a chemically similar replacement. The detailed definition of the polymeric part of the molecule (polymer type, cross linkage, average formula of polymer composition, and loading etc.) is done in the ELN-UI where the user can add information on type and composition of the polymer. The latter additional data are used for the calculation of sample-specific values like the elemental composition of the polymeric material. Separating the classification of the molecule via the molecule editor and the definition of the polymeric material in the ELN environment results in the availability of two datasets: a molfile of an approximated reactive molecule site and the information about the combined composition of the polymeric material. The molfile allows the query of information for the defined part of the molecule via OpenBabel and PubChem while being searchable in chemistry databases. The information on the polymeric material can be used for the differentiation of different types of polymers for e.g. loading-dependent calculations. One example for such a calculation is given in Fig. 5 and further details and examples can be retrieved from the supporting information (Sect. 4). The ELN currently supports four types of calculations for polymers with known [calculation (1)] and unknown compositions [calculations (2)–(4)].
Calculation of the elemental composition for a given polymer type with information about loading of the material, its formula, and the formula of the immobilized non-polymeric part.
The calculation of the yield of the polymer-supported reaction is obtained based on the amount and properties of the starting material (mass and loading) and the obtained mass of the polymer-supported reaction product.
The ELN supports further calculations for the yield of the polymer-supported reaction, based on the amount and properties of the starting material and the obtained elemental analysis of the polymer-supported reaction product.
The calculation of the loading of the polymer-supported material can be done for an assumed full conversion based on the obtained amount and properties of the starting material, and the obtained mass of the polymer-supported reaction product.
User feedback and reflections
Technically, the new ketcher rails-editor covers the main features that are also available by the well-known commercial ChemDraw editor. Several features are still missing but other actions can be managed additionally, therefore the establishment of the editor as a standard tool was considered to be relatively easy. We became aware that the acceptance of the ketcher-rails editor strongly depends on the age and experience of the scientists. Users who are long-term users of ChemDraw disliked the switch to an alternative software and were constantly asking for the embedding of ChemDraw to the Chemotion-ELN even though the necessary functions were available by the use of ketcher-rails as well. This adaption process takes some time for long-term users of ChemDraw but the available benefits through the ELN integration accelerate the acceptance in general. The most requested features to be added to the original Ketcher editor were the creation of user defined templates and the option to draw coordinative bonds. The latter feature was needed by many users working in the field of catalysis and the integration of the coordinative bond type convinced additional interested people to use ketcher-rails. One point to be mentioned which leads to inconveniences for some scientists is the fact that ketcher-rails is developed as a professional tool allowing the processing of structures for their addition to databases which includes no tolerance of wrong structures. The latter fact is very advantageous to guide users to a well-written documentation but is not favorable for users that tend to a more “quick and dirty” documentation. In particular through the connection to the ELN, non-accurate drawings have direct influence on the availability of the correct name of the compound and its calculated properties and values.
The molecule editor Ketcher was extended concerning its functionality and was embedded to an ELN environment which enables the use for advanced applications in chemistry research. The developments on the ELN-integrated ketcher-rails editor support the retrieval of identifiers and structure-related information from external databases, and the molecule-based calculation of analytical values. A model for the addition of common templates and the definition of user defined templates was created to facilitate the input of molecules and the adaption of the editor’s possibilities to the needs of research. The embedded editor offers a straightforward solution for the representation of polymer supported molecules, their processing with PubChem or OpenBabel, and their use for calculations with polymeric material. In addition, the drawing of coordinative bonds was enabled which allows to draw e.g. organometallic complexes. In summary, our additions and improvements to the original Ketcher source code and the interaction with the ELN allow researchers to manage their data more efficiently and will support the efforts of the community to adapt the current chemistry research infrastructure to their needs. We hope that the developments will support the efforts to develop other suitable scientific applications or Open Source software for chemists.
Electronic Laboratory Notebook
Cascading Style Sheets
Coles S, Frey J, Bird C, Whitby R, Day A (2013) First steps towards semantic descriptions of electronic laboratory notebook records. J Cheminform 5:52
Day A, Coles S, Bird C, Frey J, Whitby R, Tkachenko V, Williams A (2015) ChemTrove: enabling a generic ELN To Support chemistry through the use of transferable plug-ins and online data sources. J Chem Inf Model 55:501–509
Lütjohann D, Jung N, Bäse S (2015) Open source life science automation, part 1: design of experiments and data acquisition via “dial-a-device. Chemometr Intell Lab 144:100–107
https://en.wikipedia.org/wiki/Molecule_editor. Accessed 9 Aug 2018
Bird C, Willoughby C, Frey J (2013) Laboratory notebooks in the digital era: the role of ELNs in record keeping for chemistry and other sciences. Chem Soc Rev 42:8157–8175
Bird C, Frey J (2013) Chemical information matters: an e-Research perspective on information and data sharing in the chemical sciences. Chem Soc Rev 42:6754–6776
Ihlenfeldt WD, Bolton EE, Bryant SH (2009) The PubChem chemical structure sketcher. J Cheminform 1:20
Hartenfeller M, Eberle M, Meier P, Nieto-Oberhuber C, Altmann KH, Schneider G, Jacoby E, Renner S (2011) J Chem Inf Model 51:3093–3098
Ertl P (2010) Molecular structure input on the web. J Cheminform 2:1
Mohebifar M, Sajadi F (2015) Chemozart: a web-based 3D molecular structure editor and visualizer platform. J Cheminform 7:56
Earley CW (2013) CH5M3D: an HTML5 program for creating 3D molecular structures. J Cheminform 5:46
Abraham M, Varghese V, Tang H (2010) Using molecular representations to aid student understanding of stereochemical concepts. J Chem Edu 87:1425–1429
Hanwell MD, Curtis DE, Lonie DC, Vandermeersch T, Zurek E, Hutchison GR (2012) Avogadro: an advanced semantic chemical editor, visualization, and analysis platform. J Cheminform 4:17
ChemDraw, a product of PerkinElmer. http://www.cambridgesoft.com/software/overview.aspx. Accessed 9 Aug 2018
Li Z, Wan H, Shi Y, Ouyang P (2004) Personal experience with four kinds of chemical structure drawing software: review on ChemDraw, ChemWindow, ISIS/Draw, and ChemSketch. J Chem Inf Comput Sci 44:1886–1890
VectorMol: http://sciformation.com/vectormol.html. Accessed 9 Aug 2018
Krause S, Willighagen E, Steinbeck C (2000) JChemPaint—using the collaborative forces of the: 1 to develop a free editor for 2D chemical structures. Molecules 5:93–98
MarvinSketch. https://chemaxon.com/products/marvin. Accessed 9 Aug 2018
Chemsketch. http://www.acdlabs.com/resources/freeware/chemsketch/. Accessed 9 Aug 2018
ChemDoodle 2D Sketcher. http://web.chemdoodle.com/demos/sketcher. Accessed 9 Aug 2018
Ketcher. http://lifescience.opensource.epam.com/ketcher/#overview. Accessed 9 Aug 2018
Karulin B, Kozhevnikov M (2011) Ketcher: web-based chemical structure editor. J Cheminform 3:P3
http://www.chemspider.com/StructureSearch.aspx. Accessed 9 Aug 2018
Github repository for EPAM developments on Ketcher: https://github.com/epam/ketcher. Accessed 9 Aug 2018
Tremouilhac P, Nguyen A, Huang Y-C, Kotov S, Lütjohann DS, Hübsch F, Jung N, Bräse S (2017) Chemotion ELN: an open source electronic lab notebook for chemists in academia. J Cheminform 9:54
http://lifescience.opensource.epam.com/contact.html. Accessed 9 Aug 2018
SK adapted, improved and implemented the Ketcher Editor into a ketcher-rails gem and did most of the necessary changes of the ELN. PT coordinated the developments with those of the ELN and contributed to the necessary changes of the ELN-structure. NJ and SB are corresponding authors of this publication, they planned the overall structure and requirements of the ELN and the chemotion-Ketcher, in particular the necessary calculations including chemical information. All authors read and approved the final manuscript.
We acknowledge support by Deutsche Forschungsgemeinschaft and Open Access Publishing Fund of Karlsruhe Institute of Technology. This work was supported by the Helmholtz program Biointerfaces in Technology and Medicine (BIFTM). We are very thankful to the members of the Stefan Bräse group who contributed with manifold suggestions to an ongoing improvement of the ELN.
The authors declare that they have no competing interests.
Availability and requirements
Availability of data and materials
The Supporting Information covers technical aspects and details of the software and programming e.g. the use of predefined templates and their moderation, the installation requirements and the details of the Docker image, and explanations for the use of ketcher-rails in other rails applications. Additionally, we give a summary of the information that is gained via the Ketcher editor and a comparison of the functionalities of Ketcher as an embedded version in the Chemotion ELN with respect to other Ketcher versions. The Supporting Information contains also a collection of formulas that were used for the calculations with solid supports.
Consent for publication
Ethics approval and consent to participate
This project has been funded by the German Research Foundation (Deutsche Forschungsgemeinschaft, BR1750/34-1).
Springer Nature remains neutral with regard to jurisdictional claims in published maps and institutional affiliations.
Additional file 1.
Technical aspects and details of the software and programming e.g. the use of predefined templates and their moderation, the installation requirements and the details of the Docker image, and explanations for the use of ketcher-rails in other rails applications. Some additional explanations concerning the interaction of ELN and ketcher-rails are given, including several images to illustrate selected functions of the editor.
Rights and permissions
Open Access This article is distributed under the terms of the Creative Commons Attribution 4.0 International License (http://creativecommons.org/licenses/by/4.0/), which permits unrestricted use, distribution, and reproduction in any medium, provided you give appropriate credit to the original author(s) and the source, provide a link to the Creative Commons license, and indicate if changes were made. The Creative Commons Public Domain Dedication waiver (http://creativecommons.org/publicdomain/zero/1.0/) applies to the data made available in this article, unless otherwise stated.
About this article
Cite this article
Kotov, S., Tremouilhac, P., Jung, N. et al. Chemotion-ELN part 2: adaption of an embedded Ketcher editor to advanced research applications. J Cheminform 10, 38 (2018). https://doi.org/10.1186/s13321-018-0292-9
- Molecule editor
- Electronic Lab Journal
- Open Source software
- Ruby on Rails
- Solid supports