New documentation online
173 views
Skip to first unread message
Winston Chang
Sep 21, 2012, 2:18:55 PM9/21/12
to ggplot2
Hi everyone -
The new documentation website for ggplot2 is now online, at
http://docs.ggplot2.org/0.9.2.1/
It's automatically generated from the help files using Hadley's
staticdocs package (which is presently in development).
Enjoy!
-Winston
The new documentation website for ggplot2 is now online, at
http://docs.ggplot2.org/0.9.2.1/
It's automatically generated from the help files using Hadley's
staticdocs package (which is presently in development).
Enjoy!
-Winston
Winston Chang
Sep 21, 2012, 3:19:26 PM9/21/12
to ggplot2
Also, the old documentation URLs, under http://had.co.nz/ggplot2/, now
forward to the new site, http://docs.ggplot2.org/.
forward to the new site, http://docs.ggplot2.org/.
Hadley Wickham
Sep 21, 2012, 3:34:02 PM9/21/12
to Winston Chang, ggplot2
Also, the ggplot2 website has a new home at http://ggplot2.org/ - it's
pretty bare at the moment, so let us know what you think is missing.
Hadley
> --
> You received this message because you are subscribed to the ggplot2 mailing list.
> Please provide a reproducible example: https://github.com/hadley/devtools/wiki/Reproducibility
>
> To post: email ggp...@googlegroups.com
> To unsubscribe: email ggplot2+u...@googlegroups.com
> More options: http://groups.google.com/group/ggplot2
--
RStudio / Rice University
http://had.co.nz/
pretty bare at the moment, so let us know what you think is missing.
Hadley
> You received this message because you are subscribed to the ggplot2 mailing list.
> Please provide a reproducible example: https://github.com/hadley/devtools/wiki/Reproducibility
>
> To post: email ggp...@googlegroups.com
> To unsubscribe: email ggplot2+u...@googlegroups.com
> More options: http://groups.google.com/group/ggplot2
--
RStudio / Rice University
http://had.co.nz/
Roman Luštrik
Sep 21, 2012, 4:10:00 PM9/21/12
to Winston Chang, ggplot2
For me it's somewhat difficult to read the "bold" aesthetics as indicated on every page. Perhaps a different font color, or a slightly different font background color?
color <- colour
--
In God we trust, all others bring data.
color <- colour
The docs look nice, waiting for the staticdocs package to be rolled out.
Cheers,
Roman
-Winston
--
You received this message because you are subscribed to the ggplot2 mailing list.
Please provide a reproducible example: https://github.com/hadley/devtools/wiki/Reproducibility
To post: email ggp...@googlegroups.com
To unsubscribe: email ggplot2+u...@googlegroups.com
More options: http://groups.google.com/group/ggplot2
In God we trust, all others bring data.
Frans Slothouber
Sep 22, 2012, 10:58:44 AM9/22/12
to Hadley Wickham, Winston Chang, ggplot2
On 21 September 2012 21:34, Hadley Wickham <h.wi...@gmail.com> wrote:
> Also, the ggplot2 website has a new home at http://ggplot2.org/ - it's
> pretty bare at the moment, so let us know what you think is missing.
The link to the documentation ( http://docs.ggplot2.org/current/ )
> Also, the ggplot2 website has a new home at http://ggplot2.org/ - it's
> pretty bare at the moment, so let us know what you think is missing.
dives immediately into the finer details.
First some more higher level information, for instance what is a geom,
statistics, facet, etc and how are they connected would really help
beginning users I think.
Frans.
Joshua Wiley
Sep 22, 2012, 1:33:10 PM9/22/12
to Hadley Wickham, Winston Chang, ggplot2
A few suggestions:
1) Include a link on how to install R or get R. I say this because I
think that ggplot2 has grown large enough people may find it before
they find R---that is they may see a cool graphic, see that it was
made in ggplot2 and then want to learn more.
2) I think it would be great to have a list of resources for learning
ggplot2 up on the main website. Off the top of my head, Dennis'
transition guide and the theme guide either as webpages or PDFs would
be good. What I would really love is something like Hadley's ggplot2
book, but available all online (and updated for the most recent
version of ggplot2). Perhaps this could be something on github that
the community could help with the maintenance of and then is just
periodically checked and built for the website.
I work at a university statistical consulting center that has
traditionally focused primarily on supporting Stata, SAS, and SPSS. I
have been putting a lot of work into expanding the resources we have
available for R in person and on our (freely available) website and I
make heavy use of ggplot2 for data exploration and presentation of
model results (e.g., http://www.ats.ucla.edu/stat/R/dae/ztnb.htm).
However, I do not really have good resources to _introduce_ ggplot2.
If I could say, "There are a couple great guides and introductions to
ggplot2 as well as all the documentation on its website, ggplot2.org"
that would be fantastic. I think a lot of the clients I see are
impressed with the graphs, but feel overwhelmed to do it themselves.
Final products are great for display, but poor for teaching.
I have to say overall I am so impressed with Hadley and this
community. In addition to his own amazing work, Hadley has managed to
engage and catalyze others to make ggplot2, the website, the
documentation, and the community an exemplar for any software project.
The graphics and features are par none.
Cheers,
Josh
Joshua Wiley
Ph.D. Student, Health Psychology
Programmer Analyst II, Statistical Consulting Group
University of California, Los Angeles
https://joshuawiley.com/
1) Include a link on how to install R or get R. I say this because I
think that ggplot2 has grown large enough people may find it before
they find R---that is they may see a cool graphic, see that it was
made in ggplot2 and then want to learn more.
2) I think it would be great to have a list of resources for learning
ggplot2 up on the main website. Off the top of my head, Dennis'
transition guide and the theme guide either as webpages or PDFs would
be good. What I would really love is something like Hadley's ggplot2
book, but available all online (and updated for the most recent
version of ggplot2). Perhaps this could be something on github that
the community could help with the maintenance of and then is just
periodically checked and built for the website.
I work at a university statistical consulting center that has
traditionally focused primarily on supporting Stata, SAS, and SPSS. I
have been putting a lot of work into expanding the resources we have
available for R in person and on our (freely available) website and I
make heavy use of ggplot2 for data exploration and presentation of
model results (e.g., http://www.ats.ucla.edu/stat/R/dae/ztnb.htm).
However, I do not really have good resources to _introduce_ ggplot2.
If I could say, "There are a couple great guides and introductions to
ggplot2 as well as all the documentation on its website, ggplot2.org"
that would be fantastic. I think a lot of the clients I see are
impressed with the graphs, but feel overwhelmed to do it themselves.
Final products are great for display, but poor for teaching.
I have to say overall I am so impressed with Hadley and this
community. In addition to his own amazing work, Hadley has managed to
engage and catalyze others to make ggplot2, the website, the
documentation, and the community an exemplar for any software project.
The graphics and features are par none.
Cheers,
Josh
Ph.D. Student, Health Psychology
Programmer Analyst II, Statistical Consulting Group
University of California, Los Angeles
https://joshuawiley.com/
Lavih Abraham
Sep 22, 2012, 2:13:24 PM9/22/12
to ggp...@googlegroups.com
In the 'other resources' section, I would also add a link to the web
interface at
http://www.yeroon.net/ggplot2/ or some other mirror websites
which I found very useful for introduce the conceptions and use of
ggplot2 and also a very intutitive tool.
El 22/09/2012 02:33 p.m., Joshua Wiley escribi�:
interface at
http://www.yeroon.net/ggplot2/ or some other mirror websites
which I found very useful for introduce the conceptions and use of
ggplot2 and also a very intutitive tool.
El 22/09/2012 02:33 p.m., Joshua Wiley escribi�:
Timothy Bates
Sep 22, 2012, 11:36:41 AM9/22/12
to ggplot2
+1
On 22 Sep 2012, at 15:58, Frans Slothouber <frans.sl...@gmail.com> wrote:
> docs.ggplot2.org/current dives immediately into the finer details.
On 22 Sep 2012, at 15:58, Frans Slothouber <frans.sl...@gmail.com> wrote:
> docs.ggplot2.org/current dives immediately into the finer details.
Dennis Murphy
Oct 6, 2012, 8:46:41 PM10/6/12
to Joshua Wiley, Hadley Wickham, Winston Chang, ggplot2
Hi:
Sorry for the late reply on this - I've spent the past two weeks packing and moving and am finally starting to get some energy back.
There is an e-book project afoot whose purpose is to replace and update Hadley's 2009 book with more examples, but to avoid copyright issues, it has to be rewritten more or less from scratch. The new theme system tome is to be the first major contribution to that project, the next being all the changes around scales and the gtable package, the latter of which I have to admit is rather opaque to me at the moment. Fortunately, some folks have been posting code recently so I have a chance to see how it works by example. It'll be a few months before all of this has a definite shape.
At the same time, the other features of the package, from philosophy to implementation, need to be addressed as well in order to achieve a complete reference. For example, I'm thinking about a chapter that would more or less be a walkthrough of what is going on underneath the hood when a ggplot is constructed with two layers and then several layers.
Winston's forthcoming book (R Graphics Cookbook) covers a number of practical problems in a clear, organized way, but it's somewhere between a tutorial and the e-book in progress. It has its own important niche in the documentation stream.
You've done a great job incorporating R into those lovely practical examples (thanks!!). Here are a few simple ggplot2 tutorials that I scared up with a Google search:
http://www.ceb-institute.org/bbs/wp-content/uploads/2011/09/handout_ggplot2.pdf
https://github.com/echen/ggplot2-tutorial
http://www.columbia.edu/~cjd11/charles_dimaggio/DIRE/resources/R/ggplotTutorial.pdf
...and the very well done tutorial from Penn for which I had to search a little harder...
http://www.ling.upenn.edu/~joseff/rstudy/summer2010_ggplot2_intro.html
I didn't read over these tutorials in any great depth so I don't know how up to date they are. From skimming them, it appears that the Penn page is probably the closest to what I would consider a comprehensive tutorial on ggplot2, but it's missing a few things, too.
It would be nice to have an 'official' ggplot2 tutorial, I suppose, although I tend to think of the qplot chapter in Hadley's book as the canonical introduction to the package. It might be worthwhile to brainstorm on the ggplot2-dev group (and perhaps here, where more novices are likely to tune in) as to what such an animal might look like. I don't mind organizing the effort until it takes shape and others can take over, but I probably won't have the time to do most of the writing as I need to be focused elsewhere.
I would suggest that the ggplot2 chapter in Paul Murrell's R Graphics 2e be a guidepost of sorts, as he nailed the central principles of the package. The concepts are to be discussed more fully in the e-book, but examples that illustrate the core principles would be very useful to beginners IMO.
Dennis
Sorry for the late reply on this - I've spent the past two weeks packing and moving and am finally starting to get some energy back.
On Sat, Sep 22, 2012 at 10:33 AM, Joshua Wiley <jwiley...@gmail.com> wrote:
A few suggestions:
1) Include a link on how to install R or get R. I say this because I
think that ggplot2 has grown large enough people may find it before
they find R---that is they may see a cool graphic, see that it was
made in ggplot2 and then want to learn more.
2) I think it would be great to have a list of resources for learning
ggplot2 up on the main website. Off the top of my head, Dennis'
transition guide and the theme guide either as webpages or PDFs would
be good. What I would really love is something like Hadley's ggplot2
book, but available all online (and updated for the most recent
version of ggplot2). Perhaps this could be something on github that
the community could help with the maintenance of and then is just
periodically checked and built for the website.
There is an e-book project afoot whose purpose is to replace and update Hadley's 2009 book with more examples, but to avoid copyright issues, it has to be rewritten more or less from scratch. The new theme system tome is to be the first major contribution to that project, the next being all the changes around scales and the gtable package, the latter of which I have to admit is rather opaque to me at the moment. Fortunately, some folks have been posting code recently so I have a chance to see how it works by example. It'll be a few months before all of this has a definite shape.
At the same time, the other features of the package, from philosophy to implementation, need to be addressed as well in order to achieve a complete reference. For example, I'm thinking about a chapter that would more or less be a walkthrough of what is going on underneath the hood when a ggplot is constructed with two layers and then several layers.
Winston's forthcoming book (R Graphics Cookbook) covers a number of practical problems in a clear, organized way, but it's somewhere between a tutorial and the e-book in progress. It has its own important niche in the documentation stream.
I work at a university statistical consulting center that has
traditionally focused primarily on supporting Stata, SAS, and SPSS. I
have been putting a lot of work into expanding the resources we have
available for R in person and on our (freely available) website and I
make heavy use of ggplot2 for data exploration and presentation of
model results (e.g., http://www.ats.ucla.edu/stat/R/dae/ztnb.htm).
However, I do not really have good resources to _introduce_ ggplot2.
If I could say, "There are a couple great guides and introductions to
ggplot2 as well as all the documentation on its website, ggplot2.org"
that would be fantastic. I think a lot of the clients I see are
impressed with the graphs, but feel overwhelmed to do it themselves.
Final products are great for display, but poor for teaching.
You've done a great job incorporating R into those lovely practical examples (thanks!!). Here are a few simple ggplot2 tutorials that I scared up with a Google search:
http://www.ceb-institute.org/bbs/wp-content/uploads/2011/09/handout_ggplot2.pdf
https://github.com/echen/ggplot2-tutorial
http://www.columbia.edu/~cjd11/charles_dimaggio/DIRE/resources/R/ggplotTutorial.pdf
...and the very well done tutorial from Penn for which I had to search a little harder...
http://www.ling.upenn.edu/~joseff/rstudy/summer2010_ggplot2_intro.html
I didn't read over these tutorials in any great depth so I don't know how up to date they are. From skimming them, it appears that the Penn page is probably the closest to what I would consider a comprehensive tutorial on ggplot2, but it's missing a few things, too.
It would be nice to have an 'official' ggplot2 tutorial, I suppose, although I tend to think of the qplot chapter in Hadley's book as the canonical introduction to the package. It might be worthwhile to brainstorm on the ggplot2-dev group (and perhaps here, where more novices are likely to tune in) as to what such an animal might look like. I don't mind organizing the effort until it takes shape and others can take over, but I probably won't have the time to do most of the writing as I need to be focused elsewhere.
I would suggest that the ggplot2 chapter in Paul Murrell's R Graphics 2e be a guidepost of sorts, as he nailed the central principles of the package. The concepts are to be discussed more fully in the e-book, but examples that illustrate the core principles would be very useful to beginners IMO.
Dennis
Reply all
Reply to author
Forward
0 new messages