Need help with mathpix?

Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

211 Stars 21 Forks 45 Commits 1 Opened issues

Query the mathpix API to convert math images to LaTeX

Readme

mathpixis now on CRAN, so you can install using

install.packages("mathpix")

If you’re after newer development features (if there are any); you can install from GitHub using

devtools::install_github("jonocarroll/mathpix")

The free API key has been removed due to overuse. Please sign up at https://dashboard.mathpix.com/ then save your ID and key in your

.Renvironfile as

MATHPIX_APP_ID='yourid' MATHPIX_APP_KEY='yourkey'

Note that this requires you to accept Mathpix’s terms and conditions and sign up for any relevant pricing scheme.

You can check that your credentials are loaded correctly with

credentials().

If you have an image you would rather properly encode in LaTeX, for example

then simply calling

mathpix("./integral.jpg")

(with the appropriate path to the file) will insert a LaTeX block into your document which will render what the image represents

$$ \int \frac { 4 x } { \sqrt { x ^ { 2 } + 1 } } d x $$

which renders to

Even complicated, hand-drawn figures work

mathpix("matrix_3x3.jpg")

$$ A = \left( \begin{array} { l l l } { 2 } & { 7 } & { 3 } \\ { 3 } & { 5 } & { 2 } \\ { 9 } & { 4 } & { 1 } \\ \end{array} \right) $$

If your image only result in warnings and no LaTeX, use

retry = TRUEto attempt some pre-processing of the image into a more amenable form. Unfortunately, there are still images which fail.

To *not* insert the resulting equation directly into your document, but
rather store it in a variable, use

insert = FALSE.

If you also wish to generate the images (although

rmarkdownwill gladly do this for you) this can be achieved using

render_latex(latex, fileDir)

where

latexis the LaTeX generated by

mathpix()(or any other escaped LaTeX) and

fileDiris the (optional) directory where you wish to save the image (by default, a temp file). This requires that you have

pdflatexset up correctly and available on your machine.

Refer to http://docs.mathpix.com/