Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 

Repository files navigation

GitHub (pre-)release GitHub Downloads (all assets, latest release) GitHub Downloads (all assets, specific tag) Github All Releases License: MIT Support TBpack

ClarStructureFinder

Wolfram Mathematica graphical user interface (GUI) for building planar polycyclic aromatic hydrocarbons and analyzing their aromatic sextet structures

Requirements

The code was developed and tested under

  • OS: Microsoft Windows 11 Home
  • Mathematica 14.2.1 for Microsoft Windows (64-bit) (March 17, 2025).

Installation

This repository contains only a notebook with core functions in .../Core folder.

The GUI distributed in releases does not require installation. It can be run as a regular Mathematica Notebook (.nb), which contains a dynamical content and requires enabling upon the start:

Enable_Dynamics_button

Once dynamical content is enabled, the GUI must be active and responsive out-of-the-box.

Demo

The work with GUI starts from building a planar graph of a hydrocarbon molecule on a canvas by specifying position of atoms with a mouse click anywhere on the canvas. This is the Building mode regime:

Welcome_screen

The built graphs can be analysed in two other regimes: Gallai-Edmonds' structure and Clar's structure. The idea behind this approach is explained in detail in the LinkedIn article 50 years of Clar's aromatic sextet... and no automation yet? that accompanied v1.0.0 release.

As a quick start, let us build and analyse in the Clar's structure regime a Kekulene molecule studied in J. Am. Chem. Soc. 141, 15488–15493 (2019):

Clar_Structure_regime

As of v2.0.0. the GUI supports import of carbon skeletons (hydrogens are stripped automatically) from .XYZ, .MOL and .CDXML structure files straight into the canvas, thereby allowing one to avoid manual building. On the other hand, it is possible to export graphs from the canvas into the mentioned structure files with automatic hydrogenation when possible. These two tools can be used interoperably within the GUI.

Supporting the project

Consider becoming a paying user on this project. This is how I earn a living, as I am directly user-supported. Moreover, you will get an exclusive content and an early access to new releases. Anyone making a donation is entitled to request a version without watermarks. If you like the free app, you will love the paying user-only version. Such donations are really appreciated for keeping this project going.

About

Mathematica app for analyzing sextet structures of polycyclic aromatic hydrocarbons

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages