matplotlib-devel — matplotlib developers

Re: [matplotlib-devel] Polygon vs. Patch

[Benjamin R. <ben...@ou...>]

Since Polygon subclasses Patch, wouldn't that mean that a Polygon could be
made out of splines or Bezier curves? I fail to see the "inherent barrier"
for Polygons and Patches to be the same thing. I am not claiming that they
are identical now, I just don't see why a Polygon's functionality needs to
be in a subclass of Patch rather than in Patch itself.


On Mon, Aug 4, 2014 at 2:34 AM, Stefan H. <shm...@gm...> wrote:

> No, a Patch is not automatically a Polygon. You could make a Patch out of
> splines or Bezier curves, for example.
>
> Cheers,
> Stefan
>
>
>
> --
> View this message in context:
> http://matplotlib.1069221.n5.nabble.com/Polygon-vs-Patch-tp43743p43746.html
> Sent from the matplotlib - devel mailing list archive at Nabble.com.
>
>
> ------------------------------------------------------------------------------
> Infragistics Professional
> Build stunning WinForms apps today!
> Reboot your WinForms applications with our WinForms controls.
> Build a bridge from your legacy apps to the future.
>
> http://pubads.g.doubleclick.net/gampad/clk?id=153845071&iu=/4140/ostg.clktrk
> _______________________________________________
> Matplotlib-devel mailing list
> Mat...@li...
> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
>

Re: [matplotlib-devel] Polygon vs. Patch

[Stefan H. <shm...@gm...>]

No, a Patch is not automatically a Polygon. You could make a Patch out of
splines or Bezier curves, for example.

Cheers,
Stefan



--
View this message in context: http://matplotlib.1069221.n5.nabble.com/Polygon-vs-Patch-tp43743p43746.html
Sent from the matplotlib - devel mailing list archive at Nabble.com.

[matplotlib-devel] Polygon vs. Patch

[Benjamin R. <ben...@ou...>]

This might be a stupid question, but what is the difference between a
Polygon and  Patch? A Polygon is subclassed from a Patch. The only real
substantial difference I see is that a Polygon object has logic flagging
and ensuring that it has a closed ring, but does that really merit a whole
new class?

What makes things even more confusing is that RegularPolygon and
CirclePolygon are not even subclassed from Polygon.

I wonder if we might want to consider folding in some of Polygon's
functionality into Patch, and simply let Polygon be an alias for Patch
(after all, a polygon is usually what people think of when they really want
a patch).

Just a thought.

Cheers!
Ben Root

Re: [matplotlib-devel] AGG site down?

[Benjamin R. <ben...@ou...>]

Thanks for that information. I am putting together a PR that corrects those
links and also makes a few other small documentation changes. Hopefully,
this will be the last change needed for v1.4.0!

Cheers!
Ben Root


On Sun, Aug 3, 2014 at 1:51 AM, Nicolas P. Rougier <Nic...@in...
> wrote:

>
> This has been discussed on the agg mailing list and the new official site
> is:
>
> http://agg.sourceforge.net/antigrain.com/index.html
>
>
> (antigrain.com was down for a while then up for ~ 1 month and is now
> broken again, not sure what happened).
> And the project is still alive.
>
>
> Nicolas
>
>
> On 03 Aug 2014, at 04:30, Benjamin Root <ben...@ou...> wrote:
>
> > We link to antigrain.com from our documentation, but it seems that the
> link is down now. Is this just a temporary thing, or has it been down for a
> while?
> >
> > Is the project still active since the passing of its main developer, or
> perhaps it moved elsewhere?
> >
> > Ben Root
> >
> ------------------------------------------------------------------------------
> > Want fast and easy access to all the code in your enterprise? Index and
> > search up to 200,000 lines of code with a free copy of Black Duck
> > Code Sight - the same software that powers the world's largest code
> > search on Ohloh, the Black Duck Open Hub! Try it now.
> > http://p.sf.net/sfu/bds_______________________________________________
> > Matplotlib-devel mailing list
> > Mat...@li...
> > https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
>
>

Re: [matplotlib-devel] AGG site down?

[Nicolas P. R. <Nic...@in...>]

This has been discussed on the agg mailing list and the new official site is:

http://agg.sourceforge.net/antigrain.com/index.html


(antigrain.com was down for a while then up for ~ 1 month and is now broken again, not sure what happened).
And the project is still alive.


Nicolas


On 03 Aug 2014, at 04:30, Benjamin Root <ben...@ou...> wrote:

> We link to antigrain.com from our documentation, but it seems that the link is down now. Is this just a temporary thing, or has it been down for a while?
> 
> Is the project still active since the passing of its main developer, or perhaps it moved elsewhere?
> 
> Ben Root
> ------------------------------------------------------------------------------
> Want fast and easy access to all the code in your enterprise? Index and
> search up to 200,000 lines of code with a free copy of Black Duck
> Code Sight - the same software that powers the world's largest code
> search on Ohloh, the Black Duck Open Hub! Try it now.
> http://p.sf.net/sfu/bds_______________________________________________
> Matplotlib-devel mailing list
> Mat...@li...
> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

[matplotlib-devel] AGG site down?

[Benjamin R. <ben...@ou...>]

We link to antigrain.com from our documentation, but it seems that the link
is down now. Is this just a temporary thing, or has it been down for a
while?

Is the project still active since the passing of its main developer, or
perhaps it moved elsewhere?

Ben Root

[matplotlib-devel] Missing images for mathtext.html

[Gary S. <gar...@ya...>]

Hi,
If this is an inappropriate place to make this comment please tell me.
I found that the images were missing from the mathtext.html page. The source of the problem was the <img> elements, the src attributes. On this page and only this page both forward and backward slashes are used. If you change the slashes to forward slashes, the html help compiler can find the images.
Gary Setter

Re: [matplotlib-devel] Thanks for the HtmlHelp file

[Christoph G. <cg...@uc...>]

On 8/1/2014 10:53 AM, Gary Setter wrote:
> Thank you for the HtmlHelp version of MatPlotLib help. Todays build from
> http://www.lfd.uci.edu/~gohlke/pythonlibs/#matplotlib
> <http://www.lfd.uci.edu/%7Egohlke/pythonlibs/#matplotlib> does not have
> a problem with blocked content. It does have missing images in User's
> Guide \ Beginner's Guide \ Working with Text \ Symbols. I may be able to
> fix that up and rebuild it.
> Thank you all
> Gary Setter
>

Thank you for reporting the issue. Should be fixed by 
<https://github.com/matplotlib/matplotlib/pull/3339>

Christoph

[matplotlib-devel] Thanks for the HtmlHelp file

[Gary S. <gar...@ya...>]

Thank you for the HtmlHelp version of MatPlotLib help. Todays build from http://www.lfd.uci.edu/~gohlke/pythonlibs/#matplotlib does not have a problem with blocked content. It does have missing images in User's Guide \ Beginner's Guide \ Working with Text \ Symbols. I may be able to fix that up and rebuild it.
Thank you all
Gary Setter

Re: [matplotlib-devel] MEP13 - python containers

[Todd <tod...@gm...>]

I would suggest create a new branch, though.  You can create a new branch
from the old one, then make your changes there.  That way if you mess up
something you still have the original to fall back on.


On Thu, Jul 31, 2014 at 5:15 PM, Thomas Caswell <tca...@gm...> wrote:

> Git lets you re-write history pretty extensively.  If you use a tool
> on top of git (I use magit in emacs) you can selectively commit hunks
> one or two at a time.   At a minimum split it up by file.  You are
> going to have to do some force-pushing anyway.
>
> Making the PRs as small as reasonable makes reviewing much easier.  It
> makes it possible to go through the entire PR in one sitting and it
> allows the un-controversial stuff to be merged as quickly as possible
> without being held up by other parts.  The longer large PRs hang
> around the greater the chance they will accumulate conflicts with
> other PRs and require a re-base (re-basing a 500+ line diff is
> _incredibly_ painful).
>
> Tom
>
> On Thu, Jul 31, 2014 at 11:09 AM, jamesramm <jam...@gm...> wrote:
> > Thomas Caswell wrote
> >> I only took a brief look at that branch, but two comments
> >>
> >> 1) can you clean up your git history, you are adding 20k new lines (of
> >> mostly freetype and random files that should not be tracked)
> >> 2) can you split the propertify work up into chunks that are easier to
> >> review?
> >
> > Yes. This is mostly my inability to use git (I've not particular used it
> > before). I'll have to look up how to clean the history and 'unversion'
> the
> > unneeded freetype stuff.
> >
> > As it is already committed to my branch, im not sure the existing stuff
> can
> > be split into chunks? But I will make issues and split up the next lumps
> of
> > work.
> >
> > I'll post back when it is (hopefully) cleaner
> >
> >
> >
> > --
> > View this message in context:
> http://matplotlib.1069221.n5.nabble.com/MEP13-python-containers-tp40248p43732.html
> > Sent from the matplotlib - devel mailing list archive at Nabble.com.
> >
> >
> ------------------------------------------------------------------------------
> > Infragistics Professional
> > Build stunning WinForms apps today!
> > Reboot your WinForms applications with our WinForms controls.
> > Build a bridge from your legacy apps to the future.
> >
> http://pubads.g.doubleclick.net/gampad/clk?id=153845071&iu=/4140/ostg.clktrk
> > _______________________________________________
> > Matplotlib-devel mailing list
> > Mat...@li...
> > https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
>
>
>
> --
> Thomas Caswell
> tca...@gm...
>
>
> ------------------------------------------------------------------------------
> Infragistics Professional
> Build stunning WinForms apps today!
> Reboot your WinForms applications with our WinForms controls.
> Build a bridge from your legacy apps to the future.
>
> http://pubads.g.doubleclick.net/gampad/clk?id=153845071&iu=/4140/ostg.clktrk
> _______________________________________________
> Matplotlib-devel mailing list
> Mat...@li...
> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
>

Re: [matplotlib-devel] MEP13 - python containers

[Thomas C. <tca...@gm...>]

Git lets you re-write history pretty extensively.  If you use a tool
on top of git (I use magit in emacs) you can selectively commit hunks
one or two at a time.   At a minimum split it up by file.  You are
going to have to do some force-pushing anyway.

Making the PRs as small as reasonable makes reviewing much easier.  It
makes it possible to go through the entire PR in one sitting and it
allows the un-controversial stuff to be merged as quickly as possible
without being held up by other parts.  The longer large PRs hang
around the greater the chance they will accumulate conflicts with
other PRs and require a re-base (re-basing a 500+ line diff is
_incredibly_ painful).

Tom

On Thu, Jul 31, 2014 at 11:09 AM, jamesramm <jam...@gm...> wrote:
> Thomas Caswell wrote
>> I only took a brief look at that branch, but two comments
>>
>> 1) can you clean up your git history, you are adding 20k new lines (of
>> mostly freetype and random files that should not be tracked)
>> 2) can you split the propertify work up into chunks that are easier to
>> review?
>
> Yes. This is mostly my inability to use git (I've not particular used it
> before). I'll have to look up how to clean the history and 'unversion' the
> unneeded freetype stuff.
>
> As it is already committed to my branch, im not sure the existing stuff can
> be split into chunks? But I will make issues and split up the next lumps of
> work.
>
> I'll post back when it is (hopefully) cleaner
>
>
>
> --
> View this message in context: http://matplotlib.1069221.n5.nabble.com/MEP13-python-containers-tp40248p43732.html
> Sent from the matplotlib - devel mailing list archive at Nabble.com.
>
> ------------------------------------------------------------------------------
> Infragistics Professional
> Build stunning WinForms apps today!
> Reboot your WinForms applications with our WinForms controls.
> Build a bridge from your legacy apps to the future.
> http://pubads.g.doubleclick.net/gampad/clk?id=153845071&iu=/4140/ostg.clktrk
> _______________________________________________
> Matplotlib-devel mailing list
> Mat...@li...
> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel



-- 
Thomas Caswell
tca...@gm...

Re: [matplotlib-devel] MEP13 - python containers

[jamesramm <jam...@gm...>]

Thomas Caswell wrote
> I only took a brief look at that branch, but two comments
> 
> 1) can you clean up your git history, you are adding 20k new lines (of
> mostly freetype and random files that should not be tracked)
> 2) can you split the propertify work up into chunks that are easier to
> review?

Yes. This is mostly my inability to use git (I've not particular used it
before). I'll have to look up how to clean the history and 'unversion' the
unneeded freetype stuff. 

As it is already committed to my branch, im not sure the existing stuff can
be split into chunks? But I will make issues and split up the next lumps of
work.

I'll post back when it is (hopefully) cleaner



--
View this message in context: http://matplotlib.1069221.n5.nabble.com/MEP13-python-containers-tp40248p43732.html
Sent from the matplotlib - devel mailing list archive at Nabble.com.

Re: [matplotlib-devel] MEP13 - python containers

[Thomas C. <tca...@gm...>]

I only took a brief look at that branch, but two comments

1) can you clean up your git history, you are adding 20k new lines (of
mostly freetype and random files that should not be tracked)
2) can you split the propertify work up into chunks that are easier to review?



On Thu, Jul 31, 2014 at 7:16 AM, jamesramm <jam...@gm...> wrote:
> It seens that discussion of properties has died off, but I see it as a very
> important implementation for 2 reasons:
>
> 1. It will help with the implementation of stylsheets and a DOM-type model
> as proposed in MEP25 and MEP26
>
> 2. The act of working through the code to add properties exposes any
> inconsistencies and vulnerabilities.
>
> I have been adding properties to my fork of MPL as part of the development
> of a visualisation tool.
> https://github.com/JamesRamm/matplotlib/tree/master/lib/matplotlib
>
> text.py and font-manager.py are completely 'propertyfied' and I have done a
> fair amount of work on artist.py, _axes.py, _base.py and axis.py
>
> Axis.py in particular is a sticking point, which has been difficult to add
> properties to. In any case, the fact that the Ticker() class exists points
> to some problems with this part of the code in particular. Ticker holds
> references too (or rather, the locator and formatter properties of Ticker)
> the axis object, yet is initialised within the initialisation of the axis
> class...
> This can be a problem.
>
> Looking through ticker.py, it seems that in most places, the need for a
> reference to axis is not necessary.
>
> Functions such as zoom and pan, which are within the Locator class in
> ticker, should actually be implemented in axis.py (as I have in my fork) as
> they have no dependency on Locator.
>
> Anyway, adding properties is a large job. I will probably implement them
> completely as part of my work, but:
>
> - Backwards compatibility will be broken
> - The resulting library will probably look a whole lot different to MPL.
>
> For those reasons, I doubt I will ever make a pull request for my fork and I
> will neglect areas such as the pyplot/pylab interfaces. IMO, have a nice
> simple, object oriented API negates the need for such interfaces and I am
> not concerned with keeping a 'matlab-user' community happy...
>
> I don't see the API of MPL changing this much anytime soon (or anytime
> really), but in order to keep up with newer libraries it probably should,
> and should not be concerned about backwards compatibility when it does...
>
>
>
> --
> View this message in context: http://matplotlib.1069221.n5.nabble.com/MEP13-python-containers-tp40248p43730.html
> Sent from the matplotlib - devel mailing list archive at Nabble.com.
>
> ------------------------------------------------------------------------------
> Infragistics Professional
> Build stunning WinForms apps today!
> Reboot your WinForms applications with our WinForms controls.
> Build a bridge from your legacy apps to the future.
> http://pubads.g.doubleclick.net/gampad/clk?id=153845071&iu=/4140/ostg.clktrk
> _______________________________________________
> Matplotlib-devel mailing list
> Mat...@li...
> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel



-- 
Thomas Caswell
tca...@gm...

Re: [matplotlib-devel] MEP13 - python containers

[jamesramm <jam...@gm...>]

It seens that discussion of properties has died off, but I see it as a very
important implementation for 2 reasons:

1. It will help with the implementation of stylsheets and a DOM-type model
as proposed in MEP25 and MEP26

2. The act of working through the code to add properties exposes any
inconsistencies and vulnerabilities.

I have been adding properties to my fork of MPL as part of the development
of a visualisation tool.
https://github.com/JamesRamm/matplotlib/tree/master/lib/matplotlib

text.py and font-manager.py are completely 'propertyfied' and I have done a
fair amount of work on artist.py, _axes.py, _base.py and axis.py

Axis.py in particular is a sticking point, which has been difficult to add
properties to. In any case, the fact that the Ticker() class exists points
to some problems with this part of the code in particular. Ticker holds
references too (or rather, the locator and formatter properties of Ticker)
the axis object, yet is initialised within the initialisation of the axis
class...
This can be a problem.

Looking through ticker.py, it seems that in most places, the need for a
reference to axis is not necessary.

Functions such as zoom and pan, which are within the Locator class in
ticker, should actually be implemented in axis.py (as I have in my fork) as
they have no dependency on Locator.

Anyway, adding properties is a large job. I will probably implement them
completely as part of my work, but:

- Backwards compatibility will be broken
- The resulting library will probably look a whole lot different to MPL.

For those reasons, I doubt I will ever make a pull request for my fork and I
will neglect areas such as the pyplot/pylab interfaces. IMO, have a nice
simple, object oriented API negates the need for such interfaces and I am
not concerned with keeping a 'matlab-user' community happy...

I don't see the API of MPL changing this much anytime soon (or anytime
really), but in order to keep up with newer libraries it probably should,
and should not be concerned about backwards compatibility when it does...



--
View this message in context: http://matplotlib.1069221.n5.nabble.com/MEP13-python-containers-tp40248p43730.html
Sent from the matplotlib - devel mailing list archive at Nabble.com.

Re: [matplotlib-devel] Please Build the doc as HtmlHelp

[Chris B. <chr...@no...>]

On Wed, Jul 30, 2014 at 11:20 AM, Gary Setter <gar...@ya...> wrote:

>  Thank you for all the responds concerning Html Help. If someone would
> build using *class *sphinx.builders.htmlhelp.HTMLHelpBuilder  and upload
> the outputs were I can get them,
>

It would probably be easier to clone the repo, install sphinx, and do that
step yourself...

But thanks for offering, this would be nice for some folks.

-Chris





>  I have a HTML Help workshop installed on my desktop. I would gladly
> setup the project and build the dot chm file. I'll send the results were
> ever you wish.
> Best regards,
> Gary Setter
>
>
>
> ------------------------------------------------------------------------------
> Infragistics Professional
> Build stunning WinForms apps today!
> Reboot your WinForms applications with our WinForms controls.
> Build a bridge from your legacy apps to the future.
>
> http://pubads.g.doubleclick.net/gampad/clk?id=153845071&iu=/4140/ostg.clktrk
> _______________________________________________
> Matplotlib-devel mailing list
> Mat...@li...
> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
>
>


-- 

Christopher Barker, Ph.D.
Oceanographer

Emergency Response Division
NOAA/NOS/OR&R            (206) 526-6959   voice
7600 Sand Point Way NE   (206) 526-6329   fax
Seattle, WA  98115       (206) 526-6317   main reception

Chr...@no...

Re: [matplotlib-devel] Please Build the doc as HtmlHelp

[Christoph G. <cg...@uc...>]

On 7/30/2014 11:20 AM, Gary Setter wrote:
> Thank you for all the responds concerning Html Help. If someone would
> build using /class /sphinx.builders.htmlhelp.HTMLHelpBuilder  and upload
> the outputs were I can get them, I have a HTML Help workshop installed
> on my desktop. I would gladly setup the project and build the dot chm
> file. I'll send the results were ever you wish.
> Best regards,
> Gary Setter
>

Try Matplotlib-1.4.x.chm from 
<http://www.lfd.uci.edu/~gohlke/pythonlibs/#matplotlib>.

If the content appears empty, "unblock" the file in Windows Explorer 
before viewing.

Please post issues at <https://github.com/matplotlib/matplotlib/pull/3325>

Christoph

[matplotlib-devel] Please Build the doc as HtmlHelp

[Gary S. <gar...@ya...>]

Thank you for all the responds concerning Html Help. If someone would build using class sphinx.builders.htmlhelp.HTMLHelpBuilder  and upload the outputs were I can get them, I have a HTML Help workshop installed on my desktop. I would gladly setup the project and build the dot chm file. I'll send the results were ever you wish.
Best regards,
Gary Setter

Re: [matplotlib-devel] Please consider Html Help

[Christoph G. <cg...@uc...>]

On 7/28/2014 11:32 AM, Thomas Kluyver wrote:
> On 28 July 2014 11:27, Benjamin Root <ben...@ou...
> <mailto:ben...@ou...>> wrote:
>
>     Going to the sourceforge page you have, I see that you mean "HTML
>     Help" as in ".chm" files. That is something different that I am not
>     familiar with. All of our documentation is generated from sphinx, so
>     whatever sphinx supports, we can generate.
>
>
> Sphinx does support CHM as the 'htmlhelp' target, though the docs seem
> to say that you need another application ("Microsoft HTML Help
> Workshop") to finish compiling it.
>
> http://sphinx-doc.org/builders.html#sphinx.builders.htmlhelp.HTMLHelpBuilder
>
> Thomas
>

I created a PR at <https://github.com/matplotlib/matplotlib/pull/3325>

The resulting document, Matplotlibdoc.chm, is currently 124 MB, probably 
because of the many hires gallery images. In general the document looks 
usable.

Christoph

[matplotlib-devel] OSX wheels for 1.4.0rc2 available for testing

[Matthew B. <mat...@gm...>]

Hi,

Sorry for the repost - just in case OSX users out there missed it...

We have automatically built OSX wheels for the upcoming release here:

http://wheels.scikit-image.org/

Wheels built via travis-ci from
https://github.com/matthew-brett/matplotlib-wheels.

Usual procedure:

pip install -f http://wheels.scikit-image.org --pre matplotlib

Please do send feedback.

Cheers,

Matthew

Re: [matplotlib-devel] Please consider Html Help

[Pierre H. <pie...@cr...>]

Just as a side note, it is indeed possible to view the html docs offline by having a copy of the directory Ben mentioned, and depending on which Unix system you are using, it is possible that this doc is already packaged. I'm thinking of Debian : https://packages.debian.org/jessie/python-matplotlib-doc (python and bumpy docs are also packaged the same way and I use them a lot.)


Best,
Pierre


On 28 juillet 2014 18:11:18 UTC, Gary Setter <gar...@ya...> wrote:
>Monday, July 28,
>2014 08:16 AM
>Dear Sirs,
>Please consider
>including Html Help as a third format for MatPlotLib documentation. I
>was first
>introduced to MatPlotLib at an online class in programming which used
>Python
>and MatPlotLib. I was impressed by MatPlotLib but believed that the
>help system
>could be better for someone like me.
> 
>At the time, only
>PDF was available, which has these problems:
>- The index page
>is difficult to navigate
>- You cannot move
>backwards and forwards as you follow hyperlinks
>- Being page
>oriented, text that spans pages has a distracting page break
>- In some places,
>text spills off the page and is not visible.
> 
>You added Html
>support online, which is was a great improvement. However it has a
>fatal flaw
>for someone like me:
>- It is
>unavailable to people without an internet connection when then they are
>working.
> 
>Of the help
>documents that I used or written, (plain text, UNIX man pages, LaTex,
>WinHelp
>and Html Help), Html Help is by far the best system. Html help is:
>- Self contained
>- Available off
>line
>- Easy to
>navigate
>- Easy to use
>index
>- Easy to use
>table of contents
> 
>There is only one
>problem that I know of concerning using Html Help for MatPlotLib
>documentation,
>support for it on UNIX systems. Rather than rejecting Html Help, why
>not work
>on supporting it on UNIX systems?
> 
>To see what I'm
>talking about, please take a look at the Html Help version of
>MatPlotLib 1.3.0
>which I converted from the PDF file. It is a sourceforge project which
>you can
>access here:
>https://sourceforge.net/projects/matplotlibashtmlhelp/?source=directory
>
> 
>What do you
>think? Is Html Help a format for offline documentation that you are
>willing to
>support or at least accept? Please reply here or to
>gar...@ya....
> 
>Gary Setter
>
>
>------------------------------------------------------------------------
>
>------------------------------------------------------------------------------
>Infragistics Professional
>Build stunning WinForms apps today!
>Reboot your WinForms applications with our WinForms controls. 
>Build a bridge from your legacy apps to the future.
>http://pubads.g.doubleclick.net/gampad/clk?id=153845071&iu=/4140/ostg.clktrk
>
>------------------------------------------------------------------------
>
>_______________________________________________
>Matplotlib-devel mailing list
>Mat...@li...
>https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

-- 
Pierre Haessig

Re: [matplotlib-devel] Please consider Html Help

[Thomas K. <th...@kl...>]

On 28 July 2014 11:27, Benjamin Root <ben...@ou...> wrote:

> Going to the sourceforge page you have, I see that you mean "HTML Help" as
> in ".chm" files. That is something different that I am not familiar with.
> All of our documentation is generated from sphinx, so whatever sphinx
> supports, we can generate.


Sphinx does support CHM as the 'htmlhelp' target, though the docs seem to
say that you need another application ("Microsoft HTML Help Workshop") to
finish compiling it.

http://sphinx-doc.org/builders.html#sphinx.builders.htmlhelp.HTMLHelpBuilder

Thomas

Re: [matplotlib-devel] Please consider Html Help

[Benjamin R. <ben...@ou...>]

Going to the sourceforge page you have, I see that you mean "HTML Help" as
in ".chm" files. That is something different that I am not familiar with.
All of our documentation is generated from sphinx, so whatever sphinx
supports, we can generate.


On Mon, Jul 28, 2014 at 2:25 PM, Benjamin Root <ben...@ou...> wrote:

> Technically speaking, we do support HTML Help, as that is the format of
> our online documentation. So, I think what you are really asking for is a
> packaged version of the HTML documentation that you find online that one
> can just simply download for themselves?
>
> As a quick solution for the moment, you can go to the following link:
> https://github.com/matplotlib/matplotlib.github.com
> and click on the "Download .zip" button on the right side. That will get
> you the online documentation that should work off-line.
>
> Ben Root
>
>
> On Mon, Jul 28, 2014 at 2:11 PM, Gary Setter <gar...@ya...> wrote:
>
>> Monday, July 28, 2014 08:16 AM
>> Dear Sirs,
>> Please consider including Html Help as a third format for MatPlotLib
>> documentation. I was first introduced to MatPlotLib at an online class in
>> programming which used Python and MatPlotLib. I was impressed by MatPlotLib
>> but believed that the help system could be better for someone like me.
>>
>> At the time, only PDF was available, which has these problems:
>> - The index page is difficult to navigate
>> - You cannot move backwards and forwards as you follow hyperlinks
>> - Being page oriented, text that spans pages has a distracting page break
>> - In some places, text spills off the page and is not visible.
>>
>> You added Html support online, which is was a great improvement. However
>> it has a fatal flaw for someone like me:
>> - It is unavailable to people without an internet connection when then
>> they are working.
>>
>> Of the help documents that I used or written, (plain text, UNIX man
>> pages, LaTex, WinHelp and Html Help), Html Help is by far the best system.
>> Html help is:
>> - Self contained
>> - Available off line
>> - Easy to navigate
>> - Easy to use index
>> - Easy to use table of contents
>>
>> There is only one problem that I know of concerning using Html Help for
>> MatPlotLib documentation, support for it on UNIX systems. Rather than
>> rejecting Html Help, why not work on supporting it on UNIX systems?
>>
>> To see what I'm talking about, please take a look at the Html Help
>> version of MatPlotLib 1.3.0 which I converted from the PDF file. It is a
>> sourceforge project which you can access here:
>> https://sourceforge.net/projects/matplotlibashtmlhelp/?source=directory
>>
>> What do you think? Is Html Help a format for offline documentation that
>> you are willing to support or at least accept? Please reply here or to
>> gar...@ya....
>>
>> Gary Setter
>>
>>
>>
>> ------------------------------------------------------------------------------
>> Infragistics Professional
>> Build stunning WinForms apps today!
>> Reboot your WinForms applications with our WinForms controls.
>> Build a bridge from your legacy apps to the future.
>>
>> http://pubads.g.doubleclick.net/gampad/clk?id=153845071&iu=/4140/ostg.clktrk
>> _______________________________________________
>> Matplotlib-devel mailing list
>> Mat...@li...
>> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
>>
>>
>

Re: [matplotlib-devel] Please consider Html Help

[Benjamin R. <ben...@ou...>]

Technically speaking, we do support HTML Help, as that is the format of our
online documentation. So, I think what you are really asking for is a
packaged version of the HTML documentation that you find online that one
can just simply download for themselves?

As a quick solution for the moment, you can go to the following link:
https://github.com/matplotlib/matplotlib.github.com
and click on the "Download .zip" button on the right side. That will get
you the online documentation that should work off-line.

Ben Root


On Mon, Jul 28, 2014 at 2:11 PM, Gary Setter <gar...@ya...> wrote:

> Monday, July 28, 2014 08:16 AM
> Dear Sirs,
> Please consider including Html Help as a third format for MatPlotLib
> documentation. I was first introduced to MatPlotLib at an online class in
> programming which used Python and MatPlotLib. I was impressed by MatPlotLib
> but believed that the help system could be better for someone like me.
>
> At the time, only PDF was available, which has these problems:
> - The index page is difficult to navigate
> - You cannot move backwards and forwards as you follow hyperlinks
> - Being page oriented, text that spans pages has a distracting page break
> - In some places, text spills off the page and is not visible.
>
> You added Html support online, which is was a great improvement. However
> it has a fatal flaw for someone like me:
> - It is unavailable to people without an internet connection when then
> they are working.
>
> Of the help documents that I used or written, (plain text, UNIX man pages,
> LaTex, WinHelp and Html Help), Html Help is by far the best system. Html
> help is:
> - Self contained
> - Available off line
> - Easy to navigate
> - Easy to use index
> - Easy to use table of contents
>
> There is only one problem that I know of concerning using Html Help for
> MatPlotLib documentation, support for it on UNIX systems. Rather than
> rejecting Html Help, why not work on supporting it on UNIX systems?
>
> To see what I'm talking about, please take a look at the Html Help version
> of MatPlotLib 1.3.0 which I converted from the PDF file. It is a
> sourceforge project which you can access here:
> https://sourceforge.net/projects/matplotlibashtmlhelp/?source=directory
>
> What do you think? Is Html Help a format for offline documentation that
> you are willing to support or at least accept? Please reply here or to
> gar...@ya....
>
> Gary Setter
>
>
>
> ------------------------------------------------------------------------------
> Infragistics Professional
> Build stunning WinForms apps today!
> Reboot your WinForms applications with our WinForms controls.
> Build a bridge from your legacy apps to the future.
>
> http://pubads.g.doubleclick.net/gampad/clk?id=153845071&iu=/4140/ostg.clktrk
> _______________________________________________
> Matplotlib-devel mailing list
> Mat...@li...
> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
>
>

[matplotlib-devel] Please consider Html Help

[Gary S. <gar...@ya...>]

Monday, July 28,
2014 08:16 AM
Dear Sirs,
Please consider
including Html Help as a third format for MatPlotLib documentation. I was first
introduced to MatPlotLib at an online class in programming which used Python
and MatPlotLib. I was impressed by MatPlotLib but believed that the help system
could be better for someone like me.
 
At the time, only
PDF was available, which has these problems:
- The index page
is difficult to navigate
- You cannot move
backwards and forwards as you follow hyperlinks
- Being page
oriented, text that spans pages has a distracting page break
- In some places,
text spills off the page and is not visible.
 
You added Html
support online, which is was a great improvement. However it has a fatal flaw
for someone like me:
- It is
unavailable to people without an internet connection when then they are
working.
 
Of the help
documents that I used or written, (plain text, UNIX man pages, LaTex, WinHelp
and Html Help), Html Help is by far the best system. Html help is:
- Self contained
- Available off
line
- Easy to
navigate
- Easy to use
index
- Easy to use
table of contents
 
There is only one
problem that I know of concerning using Html Help for MatPlotLib documentation,
support for it on UNIX systems. Rather than rejecting Html Help, why not work
on supporting it on UNIX systems?
 
To see what I'm
talking about, please take a look at the Html Help version of MatPlotLib 1.3.0
which I converted from the PDF file. It is a sourceforge project which you can
access here:
https://sourceforge.net/projects/matplotlibashtmlhelp/?source=directory 
 
What do you
think? Is Html Help a format for offline documentation that you are willing to
support or at least accept? Please reply here or to gar...@ya....
 
Gary Setter

Re: [matplotlib-devel] windows binaries for 1.4.0rc2 are available

[Matthew B. <mat...@gm...>]

Hi,

On Sun, Jul 27, 2014 at 7:52 PM, Thomas Caswell <tca...@gm...> wrote:
> https://sourceforge.net/projects/matplotlib/files/matplotlib/matplotlib-1.4.0rc2/
>
> Thanks to Christoph Gohlike the widows binaries now posted on sourceforge.
>

Also automatically built OSX wheels here:

http://wheels.scikit-image.org/

Wheels built via travis-ci from
https://github.com/matthew-brett/matplotlib-wheels.

Usual procedure:

pip install -f http://wheels.scikit-image.org --pre matplotlib

Please do send feedback.

Cheers,

Matthew