LaTeX/Chemical Graphics
chemfig is a package used to draw 2D chemical structures. It is an alternative to ochem. Whereas ochem requires Perl to draw chemical structures, chemfig uses the tikz package to produce its graphics. chemfig is used by adding the following to the preamble:
This page was last edited 11 months ago, and may be abandoned This page has not been edited since 22 November 2023, but other pages in this book might have been. Check out related changes to see what the state of this book is. You can help by editing and updating this book. Remove {{under construction}} from this page if it is not being actively edited. Ask for help at WB:PROJECTS. |
\usepackage{chemfig}
Basic Usage
editThe primary command used in this package is \chemfig{}:
\chemfig{<atom1><bond type>[<angle>,<coeff>,<tikz code>]<atom2>}
<angle> is the bond angle between two atoms (or nodes). There are three types of angles: absolute, relative, and predefined. Absolute angles give a precise angle (generally, 0 to 360, though they can also be negative), and are represented with the syntax [:<absolute angle>]. Relative angles require the syntax [::<relative angle>] and produce an angle relative to the angle of the preceding bond. Finally, predefined angles are whole numbers from 0 to 7 indicating intervals of 45 degrees. These are produced with the syntax [< predefined angle>]. The predefined angles and their corresponding absolute angles are represented in the diagram below.
\chemfig{(-[:0,1.5,,,draw=none]\scriptstyle\color{red}0)
(-[1]1)(-[:45,1.5,,,draw=none]\scriptstyle\color{red}45)
(-[2]2)(-[:90,1.5,,,draw=none]\scriptstyle\color{red}90)
(-[3]3)(-[:135,1.5,,,draw=none]\scriptstyle\color{red}135)
(-[4]4)(-[:180,1.5,,,draw=none]\scriptstyle\color{red}180)
(-[5]5)(-[:225,1.5,,,draw=none]\scriptstyle\color{red}225)
(-[6]6)(-[:270,1.5,,,draw=none]\scriptstyle\color{red}270)
(-[7]7)(-[:315,1.5,,,draw=none]\scriptstyle\color{red}315)
-0}
|
<bond type> describes the bond attaching <atom1> and <atom2>. There are 9 different bond types:
\chemfig{A-B}\\
\chemfig{A=B}\\
\chemfig{A~B}\\
\chemfig{A>B}\\
\chemfig{A<B}\\
\chemfig{A>:B}\\
\chemfig{A<:B}\\
\chemfig{A>|B}\\
\chemfig{A<|B}\\
|
\chemfig{C(-[:0]H)(-[:90]H)(-[:180]H)(-[:270]H)}
<coeff> represents the factor by which the bond's length will be multiplied.
<tikz code> includes additional options regarding the color or style of the bond.
A methane molecule, for instance, can be produced with the following code:
\chemfig{C(-[:0]H)(-[:90]H)(-[:180]H)(-[:270]H)}
|
Linear molecules (such as methane) are a weak example of this, but molecules are formed in chemfig by nesting.
Skeletal Diagrams
editSkeleton diagrams can be produced as follows:
\chemfig{-[:30]-[:-30]-[:30]}
|
\chemfig{-[:30]=[:-30]-[:30]}
|
Rings
editRings follow the syntax <atom>*<n>(code), where "n" indicates the number of sides in the ring and "code" represents the specific content of each ring (bonds and atoms).
\chemfig{A*6(-B-C-D-E-F-)}
|
\chemfig{A*5(-B-C-D-E-)}
|
\chemfig{*6(=-=-=-)}
|
\chemfig{**5(------)}
|
Lewis Structures
editLewis structures use the syntax \charge{<position1>=<charge1>,<position2>=<charge2>...}{atom}
, where <position>
is in polar coordinates as <angle>:<shift>
, though the :<shift>
can be omitted if no additional shift is required. In the charge field, \.
and \:
will give unpaired and paired electrons respectively. Paired electrons can also be represented by a bar, using \|
.
\charge{0=\.,90=\.,180=\.,270=\.}{C}
|
Lewis structures can also be included within \chemfig{}
.
\chemfig{H-[:52.24]\charge{45=\:,135=\:}{O}-[::-104.48]H}
|
Ions
editFor example, consider an acetate ion:
\chemfig{-(-[1]O^{-})=[7]O}
|
Because the chemfig commands enters the math mode, ion charges can be added as superscripts (one caveat: a negative ion requires that the minus sign be enclosed in brackets, as in the example).
The charge of an ion can be circled by using \oplus and \ominus:
\chemfig{-(-[1]O^{\ominus})=[7]O}
|
Alternatively, charges can be placed above ions using \chemabove{}{}:
\chemfig{-\chemabove{N}{\scriptstyle\oplus}(=[1]O)-[7]O^{\ominus}}
|
Resonance Structures and Formal Charges
editResonance structures require a few math commands:
% see "Advanced Mathematics" for use of \left and \right
% add to preamble:
% \usepackage{mathtools} % \Longleftrightarrow
$\left\{\chemfig{O-N(=[:60]O)-[:300]O}\right\}
\Longleftrightarrow
\left\{\chemfig{O=N(-[:60]O)-[:300]O}\right\}
\Longleftrightarrow
\left\{\chemfig{O-N(-[:60]O)=[:300]O}\right\}$
Chemical Reactions
editCommands \chemrel and \chemsign were removed from chemfig package in latest versions, so in order to draw chemical reactions, one must instead use respectively \arrow and \+ commands in a block surrounded with \schemestart and \schemestop.
There are a few types of arrows that can be drawn with the \arrow command:
\schemestart A\arrow{->}B\schemestop\par % by default
\schemestart A\arrow{-/>}B \schemestop\par
\schemestart A\arrow{<-}B \schemestop\par
\schemestart A\arrow{<->}B \schemestop\par
\schemestart A\arrow{<=>}B \schemestop\par
\schemestart A\arrow{<->>}B \schemestop\par
\schemestart A\arrow{<<->}B \schemestop\par
\schemestart A\arrow{0}B \schemestop\par
\schemestart A\arrow{-U>}B \schemestop\par
\schemestart
A\arrow[,,->] B\arrow[,,-{Triangle[slant=0.5,blue,width=10pt]}]
C\arrow[,,-{CF[sharp]}] D \+ E
\schemestop
For more details on the \arrow command and chemical reactions in chemfig in general, consult the Part IV "Reaction schemes" of the chemfig documentation file.
Older versions
editChemical reactions can be created with the following commands:
\chemrel[<arg1>][<arg2>]{<arrow code>}
\chemsign+ % produces a +
In \chemrel{}, <arg1> and <arg2> represent text placed above and below the arrow, respectively.
There are four types of arrows that can be produced with \chemrel{}:
A\chemrel{->}B\par
A\chemrel{<-}B\par
A\chemrel{<->}B\par
A\chemrel{<>}B
Naming Chemical Graphics
editMolecules can be named with the command
\chemname[<dim>]{\chemfig{<code of the molecule>}}{<name>}
<dim> is inserted between the bottom of the molecule and the top of the name defined by <name>. It is 1.5ex by default.
<name> will be centered relative to the molecule it describes.
\schemestart
\chemname{\chemfig{R-C(-[:-30]OH)=[:30]O}}{Carboxylic acid}
\+
\chemname{\chemfig{R’OH}}{Alcohol}
\arrow{->}
\chemname{\chemfig{R-C(-[:-30]OR’)=[:30]O}}{Ester}
\+
\chemname{\chemfig{H_2O}}{Water}
\schemestop
In the reaction above, \chemname{} inserts 1.5ex plus the depth of the carboxylic acid molecule in between each molecule and their respective names. This is because the graphic for the first molecule in the reaction (carboxylic acid) extends deeper than the rest of the molecules. A different result is produced by putting the alcohol first:
\schemestart
\chemname{\chemfig{R’OH}}{Alcohol}
\+
\chemname{\chemfig{R-C(-[:-30]OH)=[:30]O}}{Carboxylic acid}
\arrow{->}
\chemname{\chemfig{R-C(-[:-30]OR’)=[:30]O}}{Ester}
\+
\chemname{\chemfig{H_2O}}{Water}
\schemestop
This is fixed by adding \chemnameinit{<deepest molecule>} before the first instance of \chemname{} in a reaction and by adding \chemnameinit{} after the reaction:
\schemestart
\chemnameinit{\chemfig{R-C(-[:-30]OH)=[:30]O}}
\chemname{\chemfig{R’OH}}{Alcohol}
\+
\chemname{\chemfig{R-C(-[:-30]OH)=[:30]O}}{Carboxylic acid}
\arrow{->}
\chemname{\chemfig{R-C(-[:-30]OR’)=[:30]O}}{Ester}
\+
\chemname{\chemfig{H_2O}}{Water}
\chemnameinit{}
\schemestop
Lastly, adding \\ in <name> will produce a line-break, allowing the name to span multiple lines.
Advanced Graphics
editFor advanced commands and examples, refer to the chemfig manual, where a more thorough and complete introduction to the package can be found.
Chemical Formulae
editIf you need to typeset chemical formulae, you have the choice between two very good packages: mhchem
and chemmacros
.
Package mhchem
editmhchem is a package used to typeset chemical formulae and equations. As well as typeset basic 2D chemical structures. To use this package, add the following to your preamble:
\usepackage[version=4]{mhchem}
Chemical species are included using the \ce command. For example
\ce{3H2O} \\
\ce{1/2H2O} \\
\ce{AgCl2-} \\
\ce{H2_{(aq)}} \\
renders:
For more examples, see meta:Help:Displaying a formula#Chemistry 2.
A few things here are automatically typeset; The 2 in \ce{H2O} is automatically subscripted without requiring additional commands. The amount of the species precedes the formula. 1/2 and other fractional amounts are automatically typeset as in \ce{1/2H2O}. The charge in \ce{AgCl2-} is automatically superscripted. If the charge is neither +1 nor -1, a ^ will superscript it, as in \ce{AgCl2-}. The phase is not automatically subscripted and needs to be enclosed in parenthesis preceded with a _ as in \ce{H2_{(aq)}.
Since February 2016, the mhchem package is also available in TeX in MediaWiki sites like Wikipedia, using the tag <ce>...</ce>
.
Package chemformula
editchemformula is a package from a much bigger chemistry bundle, used to typeset chemical formulae, equations, and basic 2D chemical structures. The package uses a slightly different syntax compared to mhchem
. Package chemmacros
will be of great interest to people doing chemistry related work.
To use this package, add the following to your preamble:
\usepackage{chemformula}
Chemical species are included using the \ch command. For example
\ch{3 H2O} \\
\ch{1/2 H2O} \\
\ch{AgCl2-} \\
\ch{H2_{(aq)}} \\
renders:
As you can see, the syntax is almost the same.
XyMTeX package
editThe following code produces the image for corticosterone below.
\documentclass{letter}
\usepackage{epic,carom}
\pagestyle{empty}
\begin{document}
\begin{picture}(1000,500)
\put(0,0){\steroid[d]{3D==O;{{10}}==\lmoiety{H$_{3}$C};{{13}}==\lmoiety{H$_{3}$C};{{11}}==HO}}
\put(684,606){\sixunitv{}{2D==O;1==OH}{cdef}}
\end{picture}
\end{document}