Highlights from
matlab2tikz

  • cleanfigure(varargin)
    CLEANFIGURE() removes the unnecessary objects from your MATLAB plot
  • figure2dot(filename)
  • herrorbar(x, y, l, u, sym...
    HERRORBAR Horizontal Error bar plot.
  • matlab2tikz(varargin)
    MATLAB2TIKZ Save figure in native LaTeX (TikZ/Pgfplots).
  • matlab2tikzInputParser()
    MATLAB2TIKZINPUTPARSER Input parsing for matlab2tikz..
  • matlab2tikz_acidtest(vara...
    MATLAB2TIKZ_ACIDTEST unit test driver for matlab2tikz
  • pointReductionTest()
  • testfunctions(k)
  • updater(name, fileExchang...
    UPDATER Auto-update matlab2tikz.
  • View all files

4.87209

4.9 | 96 ratings Rate this file 811 Downloads (last 30 days) File Size: 137 KB File ID: #22022
image thumbnail

matlab2tikz

by

 

07 Nov 2008 (Updated )

A script to convert MATLAB/Octave into TikZ figures for easy and consistent inclusion into LaTeX.

| Watch this File

File Information
Description

matlab2tikz supports the conversion of most MATLAB figures,
including 2D and 3D plots. For plots constructed with third-
party packages, your mileage may vary.
The workflow is as follows.
   1. Place matlab2tikz in a directory where MATLAB can find it.
      (the current directory, for example).
   2. Generate your plot in MATLAB.
   3. Invoke matlab2tikz by
              >> matlab2tikz( 'myfile.tikz' );

The resulting file can be included into any LaTeX document (by \input{myfile.tikz}). Don't forget to add

  \usepackage{pgfplots}

and optionally (as of Pgfplots 1.3)

  \pgfplotsset{compat=newest}
  \pgfplotsset{plot coordinates/math parser=false}

to the preamble of your LaTeX document.

To specify the dimension of the plot from within the LaTeX document, try

    >> matlab2tikz('myfile.tikz', 'height', '\figureheight', 'width', '\figurewidth');

and in the LaTeX source

    \newlength\figureheight
    \newlength\figurewidth
    \setlength\figureheight{4cm}
    \setlength\figurewidth{6cm}
    \input{myfile.tikz}

For decreasing the output TeX file size, try

    cleanfigure;
    matlab2tikz('myfile.tex');

and look at the parameter `floatFormat`.

If you would like to see more information, follow the development, submit a bug, or contribute in any other way, please visit matlab2tikz' web page at https://github.com/nschloe/matlab2tikz .

Acknowledgements

This file inspired Matlab2tikzext.

MATLAB release MATLAB 8.2 (R2013b)
Tags for This File   Please login to tag files.
Please login to add a comment or rating.
Comments and Ratings (152)
16 Jul 2014 Georg

I have a custom positioned colorbar, the script doesn't account for that yet. Might that be something you're looking into in the future?

01 Jul 2014 Simone

For the version 2014b it has problems. For instance the legend disappears.
Cheers

24 Jun 2014 Nico

Thanks for this excellent script!

I experienced two issues, which I tried to solve with some hacking of the code (use with caution :)
(I am running R2013a and pdflatex)

1) multi-line legend entries:
Minimal working example: in matlab, run:
----
figure; plot(1:10, 1:10); legend(sprintf('This is a \n multiline legend entry'))
matlab2tikz('filename', 'm2ttest.tex', 'width', '0.8\columnwidth', 'height', '5cm')
----
In latex:
--header--
\usepackage{pgfplots}
\pgfplotsset{compat=newest}
\pgfplotsset{plot coordinates/math parser=false}
\usetikzlibrary{plotmarks}
---after \begin{document}---
\begin{figure}
\input{m2ttest.tex}
\caption{TIKZ Test}
\end{figure}
----------------

Result: the legend entry appears in one line. There is a line break in m2ttest.tex which latex ignores.
My attempt to fix this:
a) change in function prettyPrint, line 4840 (see diff at bottom)
b) change in line 731 (see diff at bottom): add "[align=left]" to "\addlegendentry". Without this, my latex aborts with an error if a line break "\\" is used in the legend entry. I have seen that matlab2tikz sets the legend style to "legend cell align=left". Why the additional, explicit specification "align=left" is necessary is strange... maybe I am doing something wrong?

2) Positioning of the legend:
when I move the legend to, say, the bottom left of the figure (in the gui), it does not appear (exactly) at this position in latex. The problem seems to be that in matlab, the legend position is relative to the figure, while in tikzpicture, it is relative to the axis. Starting at line 3646, matlab2tikz seems to try to determine whether the matlab position is relative to figure or axis (unit = "normalized" or "pixel"). In my case, the unit is "normalized", but the position is still relative to the figure. So I just modified the script to always act as if the unit was "pixels" (copied the code from the "case 'pixels'" to the "case 'normalized'"). After that, legend positionig worked as expected.

What I modified in matlab2tikz.m:
diff matlab2tikz.m.orig matlab2tikz.m
713c713
< sprintf('\\addlegendentry{%s};\n\n', join(m2t, c, '\\'))]; %#ok
---
> sprintf('\\addlegendentry[align=left]{%s};\n\n', join(m2t, c, '\\'))]; %#ok
3646c3646,3651
< position = legendPos(1:2);
---
> %position = legendPos(1:2);
> % Calculate where the legend is located w.r.t. the axes.
> axesPos = get(m2t.currentHandles.gca, 'Position');
> % By default, the axes position is given w.r.t. to the figure,
> % and so is the legend.
> position = (legendPos(1:2)-axesPos(1:2)) ./ axesPos(3:4);
4840c4845,4848
<
---
> %now that all the character arrays in strings are 1-dimensional, we additionally need to split strings at newline characters
> strings = cellfun(@(x)strsplit(x, sprintf('\n')), strings, 'UniformOutput', false);
> strings = [strings{:}];
>

22 Jun 2014 Saliou

@Kine
Add these lines at the end of your script before running. It did work for me

axoptions={'scaled x ticks = false',...
'x tick label style={/pgf/number format/.cd, fixed, fixed zerofill,precision=3}'};

matlab2tikz('mypicture.tex','extraAxisOptions',axoptions);

15 Jun 2014 NGUYEN

Dear author,
while testing your package, it find it really interesting. However, i met this error sometimes:

"Attempted to access CData(:,1); index out of bounds because size(CData)=[0,0].
".

Could you tell me what happened please!

15 Jun 2014 NGUYEN

thanks so much, it is really useful

13 Jun 2014 Luuk  
13 Jun 2014 Ulrik Nielsen

Very useful, thank you!

30 May 2014 Fariborz  
27 May 2014 Martin

Excellent package. Thank you for your work.

21 May 2014 HA  
14 May 2014 mikemodanoxxx

Hi!

Really nice tool. I just tried to convert a figure which uses scatter(X,Y,[],C) to draw circles with different colors.

There seems to be a bug in your code (or the feature is just not implemented yet) in the getColor(m2t, handle, color, mode) function. It doesn't seem to be able to handle multiple colors.

A simple example would be this:
scatter([1 2], [1 2], [], [0 0 0; 0 1 0]);
matlab2tikz('test.tikz');

Which results in an error. Do you think you can fix this? Would be absolutely great ;)

12 May 2014 Kine

Hi!
Love the way te figures look! But I have one question, is there any way I can force the limits for the axis ? For example I am making a figure that has the values 0.005, 0.006... on the x-axis, and when I put the figure in to Latex I get 0.5 * 10^{-2}, is there anyway I can force it to be as it originally was? And Is there anyway to force the y-limits to be spesific values?

07 May 2014 Jan  
20 Apr 2014 William Warriner

Instant five stars for you because not only is it quite powerful, as noted, but also extremely easy to use. Thank you!

14 Mar 2014 Fabian Abarca

An essential tool from now onward when working in Matlab/LaTeX. There is, though, some trouble in the legends of the plots when TeX symbols or code is introduced (say P_e) and the tikz file takes it as plain text, but I guess it can be fixed (I do it manually in the generated file). Excellent file, thanks.

13 Mar 2014 Aaron Jackson

A very useful little tool to have in your MATLAB path. :)

28 Feb 2014 steffen

first of all, really nice tool! it produces the most beautiful plots in combination with TeX by far!

Just a little question, in order to match german typography I replace all the point seperators by comma seperators -before- using matlab2tikz.
That works pretty well for axis labels, the title and the tick labels. But there seems to be a problem concerning the legend entries:

Some of my legendentries contain numbers which are seperated by points since they are created dynamically using num2str(). They are written in combination with some descriptive text. So one legendentry could be:

$\lambda = 1.5$, $Delta = 3.4$

after replacing the points by commas it could be
$\lambda = 1,5$, $Delta = 3,4$
or
$\lambda = 1{,}5$, $Delta = 3{,}4$ (I tried both types).

After using matlab2tikz on the figure, the "original" comma in the legendentry is kept, while the seperator commas are replaced by point seperators again...

I hope you understand what I mean and maybe you've also got some hints on solving that problem

greetings

07 Feb 2014 Nico Schlömer

Setting externalData to true by default was a mistake; a new release will be out shortly, fixing this.

05 Feb 2014 Daniel

@Felix
'ExternalData', false
Or rtfm

04 Feb 2014 Vincent Nadon

I think the compiler is complaining about the missing "\\" in the .tsv file

04 Feb 2014 Felix  
04 Feb 2014 Felix

Hey there,

I updated today to version 0.4.5 and there are several .tsv-files created instead of one large .tikz-file.

that may be advantageous for many of you, but I'd rather have one large .tikz-file.

Is there any way to change it back?

29 Jan 2014 Tina

I figured out the problem:
The texlive version for Ubuntu still uses pgfplots 1.8 but for the newest matlab2tikz file pgfplots 1.9 is necessary (for plots with errorbars).
It's somewhat a pain to install pgfplots 1.9 in ubuntu but after doing so it works fine again.

Maybe with the next update there could be a hint that another pgfplots version is needed.

27 Jan 2014 Tina

Hey there,
I just love matlab2tikz, thanks for the file!

Unfortunately I have a problem with the errorbars now:
In the older version v0.4.2 points and bars were defined as (x,y)+-(xerr,yerr)... .
Now in version v0.4.4 it is (x,y) += (xerrup,yerrup) -= (xerrdown,yerrdown). It doesn't work for me to compile that file in texmaker. Did anybody have the same problem and/ or knows how to solve this?

Thank's for your help.

16 Jan 2014 piyush kant

great work for LaTex.
thanx

15 Jan 2014 Thor Andreas  
09 Jan 2014 Karl  
09 Jan 2014 Karl  
09 Jan 2014 Karl  
07 Jan 2014 Erik

This is such a great addition for anyone using both MATLAB and LaTeX! Five stars for the awesomeness. *****

On minor problem I encountered today:
I get a warning when using cleanfigure.
---Warning: Ignoring unknown argument "minimumPointsDistance"---
That is the exact argument copied from the help of function cleanfigure(). I don't get the error when using 'minimumPointDistance' ("Point" instead of "Points"). Just thought I'd let you know!

12 Nov 2013 Nikolai  
12 Nov 2013 AP  
08 Nov 2013 Jørgen

I think there is a problem when exporting bar plots while using the 'figurewidth' variable to enable setting the figure size in Latex. The width of the bars are set to the same value as 'figurewidth'. This makes the bars way to wide.

02 Nov 2013 Nico Schlömer

@Anfänger Sounds like a bug. If you want it fixed, file a report at <https://github.com/nschloe/matlab2tikz/issues?state=open> with a minimal MATLAB example that highlights the misbehavior.

31 Oct 2013 Anfänger

Just a small correction for my question: by labels, I mean , when I put contour labels withing box, the box is ignored by matlab2tikz. If for example I swich axis position (x-axis in the top), the label is still written at the bottom by matlab2tikz

31 Oct 2013 Anfänger

@Nico Schömer , many thanks for the great job. If you allow me, I would like to ask Why is the m2t ignoring for example labels, added texts...etc?

28 Oct 2013 Nico Schlömer

@lyxicon

1. There is the option 'extraAxisOptions'. If that doesn't work for you, you could file a bug at <https://github.com/nschloe/matlab2tikz/issues?state=open>.

2. There's cleanfigure() to help you out.

3. That's possible, you're probably the first to use step/impulse plots with m2t. It'd be great if you could file a bug and provide minimal failing examples.

26 Oct 2013 Matthias

How do I use the cleanfigure() function? I need to reduce the number of datapoints in my plot. I run cleanfigure() but nothing changes. Can someone help me?

23 Oct 2013 Thomas Bosse

So cool! Thank you!

23 Oct 2013 lyxicon

Pretty amazing submission. I have only had a few minor issues with it:

1. There is no way to provide extra axis options (e.g height and width) for each subplot. This is especially needed when you have a few vertically stacked subplots with a common x-axis and you want to remove the x-axis labels from all subplots but the bottom one, or you want different heights from each subplot.

2. It needs a better (smarter) downsampling algorithm. Currently, it is very easy to hit TeX memory limits when you have a large number of points (see http://tex.stackexchange.com/questions/59562/matlab2tikz-tex-out-of-memory/66831#66831)

3. It cannot properly convert time graphs that are automatically generated by step(), impulse() functions and the like (from control system toolbox)

07 Oct 2013 Andrey Ivanov

This is very cool thing, the result looks really great than png images.

01 Oct 2013 Anfänger

Excellent!It did in fact save a lot of time and work. I am new to tikz, and would like to ask, is there a way to generate both the .*tikz and *.pdf files? without the need to open the .*tikz file in an external editor and generate the pdf version.

25 Sep 2013 José Goulart

Very practical, and the result looks really great.

29 Aug 2013 Svenja Woicke

is it possible to change the code such that the "point meta min" and "point meta max" values are always saved so in case i choose for adding a colorbar later on it will show the right scale?

14 Aug 2013 Nico Schlömer

@Maria Filing your problems at https://github.com/nschloe/matlab2tikz/issues?state=open with some minimal example code that highlights what goes wrong would make it much easier to fix the issues.

14 Aug 2013 Marco  
24 Jul 2013 Dominique Zosso

Absolutely great tool!

The whitespace issues (cf Christoph, March 25, 2013) have not entirely been fixed, though (v.0.4.0):

Around the "definecolor" lines, some more '%' should be placed:

line 555: put an extra %% in front

m2t.content.colors = sprintf('%%\n%% defining custom colors\n');

line 562, too:

m2t.content.colors = [m2t.content.colors sprintf('%%\n')];

Thanks for adding this in future updates! Great work!

19 Jul 2013 Robert

Love this tool but what happened to the minimumPointsDistance option? I can't find it anywhere... Has it been removed in the current versions? Does anybody know a tool that could reduce data points in figures before matlab2tikz takes over?

Thanks

10 Jul 2013 Maria

Really nice package! Many thanks!

I am facing some problems though related to subfigures.

1) The error - bars in the subfigures are not printed.I receive the following warning:
"Warning: Error bars discarded (to be implemented)."

2) I am using the suplabel.m to produce super - x/y - labels for the subfigures.
Is there any way to keep the suplabels in the figure when using matlab2tikz? Right now when I insert the figures in latex the suplabels are missing.

3) A final problem I have is with keeping the legend at given position. Any suggestions?

Many thanks for any help!

05 Jul 2013 Pepijn

First I really want to thank you for this wonderful package. Although I found a small error.
When I use:

a = randn(10000,1);
b = a+2;

figure; hold all;
hist(a,100);
hist(b,100);

h = findobj('-property','FaceColor');
set(h(1),'FaceColor',[1 0 0],'EdgeColor',[0.5 0 0]);
set(h(2),'FaceColor',[0 0 1],'EdgeColor',[0 0 0.5]);

uistack(h(2),'top')

legend('Normal','Cascading');
matlab2tikz('test.tex','width','0.7\textwidth','showInfo', false);

If I render test.tex, the legend of Normal and Cascading will be dark red. They actually should be blue and red.

05 Jul 2013 Nico Schlömer

@Gregor You'll have to specify a proper format. Try '%.3g'.

03 Jul 2013 Gregor

Awesome package, but I have a problem with the 'floatFormat' parameter.
If I don't set this parameter all data points get written in the resulting *.tex file - but then it is to big.
So I set the precision like that:
matlab2tikz('myfile.tex', 'floatFormat', '3' );

In the output no data points will get written, only '3's in this example.

Is this a problem or do a use this parameter in a wrong way? Thank you!
I hope you can help me.

24 May 2013 Andreas

Very great package, thanks a lot! But I have a small problem I can't fix. I need to add "mark repeat=25" as an extra parameter in the "\addplot" option list. But I cannot figure out how to do it. 'extraTikzpictureSettings' puts it before the \addplot environment. Is there a change to add an input variable fixing this problem? Thanks again!

24 May 2013 Marianne

Hello,
first of all: Very Good Tutorial! Thanks for it.
I have a problem with the tikz-file and i don’t know how to fix it.
The label of my y-axis overlapes with the scale on the y-axis. The reason is that the values ​​of the scale are very small and are multiplied by 10^-3. Instead of 10^-3 is on the top (as in the x-axis), all values of the scale are multiplied with it seperately, e.g.
1 * 10^-3
8 * 10^-4
6 * 10^-4

and so the label overlapes with the first column of values. I don’t understand why is in the right form in the x-axis but not in the y-axis. In my Matlab-figure there is everything ok.
I hope i explained it understandably and somebody has a solution for this problem.

24 May 2013 Tina

ok, after a day searching I think I found the problem.... I've got an old version of pgfplots...

24 May 2013 Tina

I think I have the same problem as Arne...

For some reason I get errors including the tikz-file created with matlab2tikz to LateX (but other tikfiles). I use MATLAB R2012a, texmaker and ubuntu.

The problem seems to be within the table from the tikz file.

Some of the errors I get: (line with }; at the end of the table)
!Missing \endcsname inserted <to be read again>\protect}
!Extra \endcsname.\pgfutil@ifundefind..\ifx\csname#1\endcsname\relax \expandafter \pgfut...}
!use of newline doesn't match it's definition
!Argument of \@firstoftwo has an extra}

I'd be really thankful for help!

18 May 2013 Axel Lødemel Holene  
16 May 2013 Miche  
12 May 2013 kevin

Error using matlab2tikz>patchcolor2xcolor (line 3523)
matlab2tikz:anycolor2rgbDon't know how to handle the color model 'interp'.

Error in matlab2tikz>getColor (line 3472)
[m2t, xcolor] = patchcolor2xcolor(m2t, color, handle);

Error in matlab2tikz>drawPatch (line 1982)
[m2t, xFaceColor] = getColor(m2t, handle, faceColor, 'patch');

Error in matlab2tikz>handleAllChildren (line 640)
[m2t, str] = drawPatch(m2t, child);

Error in matlab2tikz>drawAxes (line 829)
[m2t, childrenEnvs] = handleAllChildren(m2t, handle);

Error in matlab2tikz>saveToFile (line 487)
m2t = drawAxes(m2t, relevantAxesHandles(ix), alignmentOptions(ix));

Error in matlab2tikz (line 396)
saveToFile(m2t, fid, fileWasOpen);

12 May 2013 kevin

Error using matlab2tikz>handleAllChildren (line 674)
I don't know how to handle this object: light

Error in matlab2tikz>drawAxes (line 829)
[m2t, childrenEnvs] = handleAllChildren(m2t, handle);

Error in matlab2tikz>saveToFile (line 487)
m2t = drawAxes(m2t, relevantAxesHandles(ix), alignmentOptions(ix));

Error in matlab2tikz (line 396)
saveToFile(m2t, fid, fileWasOpen);

29 Apr 2013 Pedro

Nico, thanks for this submission, I'm sure many people benefit from it.
I have the same problem as Etienne, below: the ordering of Matlab patches in 3D plots is not correct, and has to be fixed manually, which may not be possible for large figures.

28 Apr 2013 kevin

Very useful. But how to keep the font name/color/size axis or title of figures?

26 Apr 2013 Arne

I would love to use this nice script but for some reason I cannot make it work. I am using Matlab R2009b under ubuntu with Kile. Even with basic code, it does not work.

I get the following error:
[PDFLaTeX] finished with exit code 1

./testpic.tex:1005 Missing \endcsname inserted};

./testpic.tex:Extra \endcsname};

Can anyone help?

16 Apr 2013 bersan.riccardo  
02 Apr 2013 Grzegorz Knor  
25 Mar 2013 Christoph

Matlab2Tikz is a great tool! Thanks a lot for sharing!
@ Nico: You did a fantastic work which helps me a lot. However, there is a minor thing you might want to change in a future release (currently unsing 0.3.2): If one is trying to convert a contour(f) plot and include the result in a tex file, one gets in trouble with the alignment. This is caused by the preamble of the resulting file, with some blank lines and the \definecolor command. In my latex distribution (miktex) every linebreak causes a small shift to the right (propably a 'blank' is interpreted) and as more colors are defined as further the figure is shifted. To avoid this behavior I added %% where the \defincolor is set up, and thus it reads: sprintf('\\definecolor{%s}{rgb}{%.15g,%.15g,%.15g}%%\n'
To get a really tight boundary box, some other lines in the preamble might need %-sign, too.
If you want me to, I can send you a simple example showing the problem.

Best regards,
Christoph.

24 Mar 2013 Otto Debals  
22 Mar 2013 Nico Schlömer

@Georg I could certainly make this an option. If you could file a bug at <https://github.com/nschloe/matlab2tikz/issues> and explain a little bit more about what format is needed, that'd be great.

20 Mar 2013 Georg

Works fantastic - I have just one little suggestion: Could you convert the RGB values of the plots to CMYK when defining the custom colors? This has proven to be necessary for correct color disply in the Adobe Reader when using pdflatex and seems to be a widely known problem

19 Mar 2013 Nico Schlömer

@Karthick You can use the resulting file with `latex` (generating a PS-document) as well as `pdflatex`, fonts come out just as they are in the LaTeX document, you can customize your plot after it's been generated, and probably a bunch of other reasons. All in all, when you compare MATLAB's generated PDF with the compiled output of matlab2tikz, you'll notice a distinct difference in quality.

19 Mar 2013 Karthick

its indeed a good package. But what advantage it has from "print as pdf" option in matlab?

18 Mar 2013 Etienne Coetzee

Dear Niko

I am trying to convert a 3d plot with many patches, but the ordering is incorrect. Some patches that should appear behind others, appear in front. I am not sure if this is a tikz problem, but was wondering if you have encountered this as well. Any help would be appreciated.

13 Mar 2013 Israel Vaughn  
04 Mar 2013 Nico Schlömer

@H VH Ayala: Try matlab2tikz('strict', true). That should put the ticks exactly where MATLAB has them.

24 Feb 2013 H VHA

Hi,

How to set only pre-defined xticks on m2t?

Using the stem(.) command in MATLAB, one would only be interested to have only the values which there is data associated in the xticks.

regards

07 Feb 2013 Nico Schlömer

@Anke This is currently not possible with m2t alone, and I wouldn't even recommend it for line plots -- after all, m2t cannot tell which data is important for you and which can be stripped. I'd recommend for you to manually reduce the number of data points in your 3D plots until the TeX compilation time becomes bearable.

06 Feb 2013 Anke

Great tool, thanks! Only one question: how do I use the option 'minimumPointsDistance' correctly for surf plots? For normal plots, it works fine, but with surf, nothing happens...

06 Feb 2013 AP

Works flawlessly! Good job!

17 Jan 2013 Caio  
09 Jan 2013 Martijn

perfect

08 Jan 2013 Sylvain Chev

A must-have for scientific publications. Thank you very much for your effort.

12 Dec 2012 Nico Schlömer

@Georg If you file a bug at https://github.com/nschloe/matlab2tikz/issues giving a few more details (like providing the PNGs that failed along with the MATLAB code), I can try to fix this.

12 Dec 2012 Georg

Works like a charm! Makes figures in latex look superb.

One little flaw though: When I overlay to axes, one containing an imge with transparency, the output is two PNGs which are all black.

05 Dec 2012 AP

Just amazing!

05 Dec 2012 AP  
04 Dec 2012 nnunes  
02 Dec 2012 Juan

This is the best piece of matlab/latex code I have ever seen!!.

20 Nov 2012 Nico Schlömer

@H VH Ayala:
Do those styles allow for \usepackage{pgfplots}? That would be the only condition.
Also, by using Pgfplots' 'externalize' feature, you can convert those plots into PDFs which should be natively supported by any journal. (You may want to check out the 'standalone' option for matlab2tikz as well.)

19 Nov 2012 H VHA

Is the TikZ file included in the tex file generated by the script compliant to journal submissions like Elsevier and IEEE?

16 Nov 2012 Alessandro Magnani  
06 Nov 2012 gbernardi

Armin Schoisswohl's solution did the trick! ;)

06 Nov 2012 gbernardi  
25 Oct 2012 Frederik Schrader

Dear Nico,

is there a way to manipulate the order of the plot elements? It doesn't seem respect it as soon as I plot data points and lines, e.g. plot(x,data,'k.',x,fit,'r-') plots the black points in the foreground, regardless of Matlab's plot order, rendering the red line practically invisible for large datasets. The same problem occurs with 'ko', while 'k-', i.e. lines for both elements, works like charm and places them in the correct order.

Thanks in advance

18 Oct 2012 Armin Schoisswohl

@gbernardi:
\text is defined in the amsmath package. Try to include '\usepackage{amsmath}' in the preamble, this should solve your problems.

18 Oct 2012 H VHA

@gbernardi
Did you try the following?

plot(x,y)
legend({'your text here'},'Interpreter','latex')

17 Oct 2012 Nico Schlömer

@gbernardi
matlab2tikz tries to be smart about how tags and labels look like, but may fail sometimes. Try setting 'parseStrings' to false.
If that doesn't help, a bug report with a small example code on https://github.com/nschloe/matlab2tikz/issues would be appreciated.

17 Oct 2012 gbernardi

Great tool, but I'm experiencing problems with the legends.
What I write in the legend command in matlab is enclosed in a $\text{}$ environment and the \text{} part gives an error when compiling... Do you know why?

19 Sep 2012 leo nidas

Seriously I just saw my previous rating to your file in 2010 and I assure you that that was done by accident! I usually do not rate files, let alone give one star with no reason!This is a great tool so I hope my current rating somehow correct things. Is there a way to delete my previous rating or something?Thanx for sharing!

14 Sep 2012 Asif ARAIN

Guys, I am not able to convert an errorbar with uneven min and max values. It says that currently this code can convert only even min and max values. Any one found a solution? Thanks in advance.
Asif

13 Sep 2012 Miche  
15 Aug 2012 Chris

Excellent script, makes professional looking plots with ease. Thanks!

15 Aug 2012 Chris  
14 Aug 2012 John Boissard

Hi,
I had the same problem as Nicholaus Halecky. You can insert \pgfplotsset{scaled ticks=base 10:0} at the preamble of your document and it should do the trick (at least if you are using datetick).

Cheers

14 Aug 2012 John Boissard  
06 Aug 2012 Alp  
15 Jun 2012 Carlos  
24 May 2012 JoseMauricio  
30 Apr 2012 Ricardo Santiago Mozos

A great tool.

23 Apr 2012 Tor Inge  
10 Apr 2012 Andreas

Hi everybody,

I figured out another problem:

Somehow, matlab2tikz is not able to process >>plot3(xvector,yvector,zvector)<< files.

Even the most simple example does not work:

% ###################################################################

x = rand(100,1)*4-2;
y = rand(100,1)*4-2;
z = x.*exp(-x.^2-y.^2);

% Construct the interpolant
% F = TriScatteredInterp(x,y,z,'nearest');
% F = TriScatteredInterp(x,y,z,'natural');
F = TriScatteredInterp(x,y,z,'linear');

% Evaluate the interpolant at the locations (qx, qy), qz
% is the corresponding value at these locations.
ti = -2:.25:2;
[qx,qy] = meshgrid(ti,ti);
qz = F(qx,qy);

hold on
surf(qx,qy,qz)
plot3(x,y,z,'o')
view(gca,[-69 14]);
hold off

matlab2tikz( 'testplot3D.tikz', 'height', '\plothoehe', 'width', '\plotbreite', 'parseStrings', false);

% ###################################################################

14 Mar 2012 Truong  
24 Feb 2012 Rhymer Yang

Compare with matlabfrag, I like matlab2tikz better. The quality of tikz output is superb! Great work! Thanks!

18 Feb 2012 Nico Schlömer

It does exist and is called 'minimumPointsDistance'.

18 Feb 2012 K Prakasam

matfig2pgf code has an option to reduce the number of data points. Can u include same algorithm in ur code also!...

17 Feb 2012 Nico Schlömer

Yeah I'd need the MATLAB code (e.g. by mail). That said, the warning seems to be clear: "Color bar sizes will likely need tweaking." It probably says that for a reason. ;)

17 Feb 2012 3d plots

i have the open plot and input:

matlab2tikz( 'myfile.tikz', 'height', '10cm', 'width', '5mm' );

...works fine with 2D-plots.

...or is it the plot-code you're asking for?

17 Feb 2012 Nico Schlömer

Example code?

16 Feb 2012 3d plots

hi.

thanks. very useful script...generally. but i have a problem with my 3d-plots when the colorbar is displayed...i get the error message:

"Warning: Physical units of x- and y-axis do not coincide (x: mm; y: cm).Color bar sizes will
likely need tweaking."

"Error in ==> matlab2tikz>getAxisTicks at 3852
s = str2double( tickLabel{k} );"

is there any solution to this? thanks in advance.

25 Jan 2012 Dimitris K

Great work! Thanks

16 Jan 2012 Nico Schlömer

Tim: Easy. Just use

>> matlab2tikz( 'myfile.tikz', 'height', '\figureheight', 'width', '\figurewidth' );

for all of your figures and set \figureheight and \figurewidth once in your LaTeX document.
See the README.

16 Jan 2012 Tim Sønderby

Can you make so that the size of the figure always is the same, that would make it easier to control it for consistency in a report.

Thanks - great work!

27 Dec 2011 Nico Schlömer

There's always interest in patches to matlab2tikz! You could send a pull request on GitHub, or send the patch through by mail (use git format-patch to get properly credited) or create a pull request on GitHub. I don't mind either way.

27 Dec 2011 Eike

Three things:
1.: Awesome piece of code. Really saves a lot of time and work.
2.: I set the width an the hight via "\pgfplotset{}" in my preamble and just change it for a few plots. Matlab2tikz always outputs width and heigh parameters which in this case isn't very usefull.
(just found the Wiki which provides a good work around for that https://github.com/nschloe/matlab2tikz/wiki - "\newlength and \setlength")
3.: I added support vor the "Legend.Orientation" parameter as well as for "Loaction=SouthOutside" and "Location=NorthOutside", are you interested in the code? Where to should I send it?

29 Nov 2011 Nico Schlömer

Hi Sebastien,

the #-issue should be fixed now; thanks for the report.
At the moment, I don't think pgfplots has a way of controlling the legend box aspect ratio in any way, but you may want to skim through its manual. Let me know in case you find something!

29 Nov 2011 Sebastien PARIS

Sounds great in a first try.

One thing, if my xlabel is xlabel('# K') in matlab, the produced file is buggy (manually changed xlabel={# K} to xlabel={\# K}) in the tikz file).

How to keep the aspect ratio for legend ?

14 Nov 2011 Francesco Montorsi

very nice script!! I've been using MATLAB EPS export and then editing with Inkscape and saving as PDF+LaTex solution so far, but this one is simpler and better as it solves in an elegant way the label positioning problems of my former solution!
Thanks!

03 Oct 2011 THB  
08 Sep 2011 Igor

Hi Nico,
Thanks again for the great work.

Few requests:
1. Is it possible to have a command line switch to put all Matlab legend entries just in {}, instead of $$ + \text{}? My legends are mostly non-formula, so I can format them much easier if they come through matlab2tikz in this shape.

2. I propose to put "defining custom colors" section before \begin{tikzpicture} because if you make legends in the fig. caption (by using \label{} and \ref{}), LaTeX will report an error without this, since \definecolor is only scoped to tikzpicture.

3. Related to 2: Any chance of automatic labeling of plots? For example \label{filename-p1}, \label{filename-p2},....

Thanks,
Igor

02 Sep 2011 Michael Melzer

Hi Nico,
it might be better to use filename an path of uiputfile (line 206, 212, 218, ...), so files can be stored elsewhere than the current folder.

Thank you.

02 Sep 2011 Michael Melzer  
17 Jun 2011 Mukhtar Ullah

I have emailed you my modification to the nested function drawText in order to deal with problems in text objects created using Matlab TEXT command. If you agree with that, you could update your code accordingly and save me from modifying everytime there is a new version. Thanks.
Mukhtar

07 Jun 2011 Nico Schlömer

@Alexander Klein: I implemented one or two things, you may wanna check out the latest release.
For future changes, it's best to submit a bug report at https://github.com/nschloe/matlab2tikz/.

19 May 2011 Nico Schlömer

Well, the documentation may not be up-to-date all the time.
In general it's always worthwhile to take a peek at https://github.com/nicki/matlab2tikz/.
All the options are also listed in the source file itself of course, so you can always look at lines 125 ff. Should be pretty self-explainatory.

1) Not sure I understand what you mean.
2) You mean the image width? There are 'width' and 'height' arguments.
3) Option 'mathmode'.

Generally, if you found a bug or similar, it's easier for me to follow it up on GitHub.

19 May 2011 Nicholaus Halecky

Thank you, Nico, the script is a work of art. I am an experienced LaTeX user (what I used to write my dissertation), and very comfortable in MatLab (minus any major plot generation). Thus, when I found your code, you can imagine how thrilled I was as I am building scripts for report generation at this time. This would be, easily, the best script I have ever encountered on this file exchange if I could find how to:
1) Remove the 10^5 in the x-axis label (I also use datetick and have added the suggestion by Mukhtar to the LaTeX preamble to no avail).
2) Predefine line width, image aspect ratio, and some sort of a scaling parameter, so that the output width and height parameters in the tikz, e.g.,

width=0.90\textwidth,
height=0.35\textheight

3) Some sort of understanding of how I can specify whether or not the title, axis labels, legends not be interpreted in LaTeX math mode (or do you suggest that I hard code this)?

Perhaps such features are supported (as mentioned by Petter), however a quick browse through the m file didn't give me much of a starting point.

@Alexander Klein, I am interested to know if your improvements were ever implemented by the author?

Thanks all for everything,
Cheers!

02 Feb 2011 Matt Bauman  
02 Jan 2011 Petter

It was because matlab2tikz wrapped my x and ylabels with $..$. I removed that piece of code and got my expected results.

29 Dec 2010 dm

@Petter: You have an example-code for which the spaces in xlabel doesn't work? In all my figures it works perfectly, so I assume it's something with your code.

Otherwise you don't use \includegraphics with TikZ figures (unless you pre-compile to PDF or something), but using the width/height commands already available will set the dimensions of the figure (these commands are also documented in the description here on FEX).

D.

28 Dec 2010 Petter

Spaces in xlabel doesn't seem to work

27 Dec 2010 Petter

Seems it was already supported, but not documented.

27 Dec 2010 Petter

Looks good, but I am missing the functionality to keep the aspect ratio and change the width. E.g., \includegraphics[width=3cm]{image}

The help does not cover the optional arguments.

22 Dec 2010 Alexander Ludwig Klein

Hi everybody!

first of all: Thank you Mr. Schlömer for matlab2tikz. This is a great piece of a software.

Unfortunately, I have had the following problems when using version 0.0.7 in Matlab 2009b on a 64bit Linux system:
1. Labels and titles could not be written by sprintf, since it where cells.
2. Barplots did not work, since there was a typo (e.g. m2t was missing)
3. I need to plot time signals with a very small difference. That is why the precision in the pgfplots coordinates were not sufficient.
4. When plotting data series with several thousand data points, it took minutes to write the file (due to strcat and a lopp for i=1:length(xData)

I have made changes to the file which takes care of this issues:
1. e.g:

if iscell(title)
title = title{:};
end

2. for me replacing
barplotTotalNumber = barplotTotalNumber + 1;
with
m2t.barplotTotalNumber = m2t.barplotTotalNumber + 1;
helped
3. I added an option for the script where you can add a precision of the format string that is used when writing to the pgf file
4. I replaced the for loop with a repmat construction that reduced computation time a lot.

If anybody has encounters the same issues, I can send this file to Mr. Schlömer maybe (if he likes to add the changes). Or is there a better way to take care of that?

Kind regards

Alexander

14 Dec 2010 dm  
29 Nov 2010 Igor

Works great!
Thanks!

07 Oct 2010 Mukhtar Ullah

Wondeful tool. Today, I tried it and it could be no better than that. I faced that same problem ( that annoying x10^5), as mentioned by Paul, but that has nothing to do with malab2tikz.m but the way pgfplot processes the tick labels. I found a solution, though, which I would like to share and request Nico to include it in the readme file.
Add this to your latex document preamble
\pgfplotsset{x tick label style={/pgf/number format/fixed}}
\pgfplotsset{y tick label style={/pgf/number format/fixed}}
Of course, you do not need that if you are happy with the x10^5 notation.

20 Sep 2010 Ngo Huy

Hi everybody ! My name Ngo Huy . i am studient four year of Ho Chi Minh University of industry . I have a project graduated processor image (Product Classification in (closed chain stoppers)
help me . i use PLC s7200 , matlab 7.1

23 Jul 2010 Paul

Hi,

Amazing tool !!! Thank you very much.

I have an annoying problem though. I have coordinates imported from as matlab serial dates, which I then re-label using xtick. Works fine except when pgf plots the graph there is an annoying x10^5 in the bottom right corner (which must originate from the matlab serial date values.)

i.e., the code I have is :

\begin{tikzpicture}

\begin{axis}[%
view={0}{90},
scale only axis,
width=\figurewidth,
height=\figureheight,
xmin=724642, xmax=733408,
ymin=0, ymax=3.5,
xtick={724642,725373,726103,726834,727564,728295,729025,729756,730486,731217,731947,732678,733408},
xticklabels={84,86,88,90,92,94,96,98,00,02,04,06,08},

Could somebody please help me with this?

Best regards
Paul

02 Jun 2010 dm  
09 Apr 2010 Craig

Excellent Tool, plots come out looking great!

29 Jan 2010 Jean-Baptiste Carré

A really useful package. I hope it will support every plot types soon (particularly the scatter type ;-))!

10 Mar 2009 David Haberthür

I've used this submission extensively to add plots to my LaTeX-Files and it works like intended. Thanks for that submission!

10 Nov 2008 Jody Klymak

This would be much better if you explained that one needs to upload pgf and pgfplots latex packages and call \usepackage{pgfplots} in the preamble of your LaTeX document. After that it seems to work alright.

Updates
14 Mar 2013

update to 0.3.0

14 Mar 2013

upgrade to 0.3.2 (for real this time)

14 Apr 2013

update to 0.3.3

26 Jun 2013

update to 0.4.0

14 Aug 2013

update to 0.4.1

12 Sep 2013

update to 0.4.2

13 Sep 2013

updated logo

21 Oct 2013

update to 0.4.3

02 Jan 2014

update to 0.4.4

03 Feb 2014

update to 0.4.5

07 Feb 2014

update to 0.4.6

07 Mar 2014

update to 0.4.7

21 Apr 2014

add GitHub link

Contact us