[R] help with cube3d cube size

Duncan Murdoch murdoch at stats.uwo.ca
Thu Jun 26 13:02:40 CEST 2008

Mark Kimpel wrote:
> Thanks for the pointers. I think the package is great, just want to
> use it to its full potential without driving the list crazy with
> questions.  Below is my output to help and sessionInfo(). I don't see
> the scaling functions, although I now see that they can be retrieved
> with ?matrices. You guys are the experts as to what should go where,
> but for someone unfamiliar with how rgl works, having them print out
> with help(package = "rgl") would make some of these functions more
> obvious to the newbie.  Mark

The issue here is that several of those are documented on the same page, 
and that index lists the names of help pages, not all of the aliases 
that point there.  The index in the HTML help version (or the CHM help 
in Windows) repeats each alias, so you'll see things like

scale3d    Work with homogeneous coordinates
scaleMatrix    Work with homogeneous coordinates

as well as the entry for matrices as below.  I can see arguments for 
both:  repetition is bad, full coverage is good.  The index in the pdf 
document is another approach:  it lists all the aliases, and tells you 
which topic documents them.

All of this is common to all R packages; rgl isn't doing anything 
special to produce these lists.

Duncan Murdoch
> aspect3d                Set the aspect ratios of the current plot
> axes3d                  Draw boxes, axes and other text outside the
>                         data
> ellipse3d               Make an ellipsoid
> grid3d                  Add a grid to a 3D plot
> matrices                Work with homogeneous coordinates
> par3d                   Set or Query RGL Parameters
> par3dinterp             Interpolator for par3d parameters
> persp3d                 Surface plots
> play3d                  Play animation of rgl scene
> plot3d                  3D Scatterplot
> points3d                add primitive set shape
> qmesh3d                 3D Quadrangle Mesh objects
> r3d                     Generic 3D interface
> rgl-package             3D visualization device system
> rgl.bbox                Set up Bounding Box decoration
> rgl.bg                  Set up Background
> rgl.bringtotop          Assign focus to an RGL window
> rgl.clear               scene management
> rgl.light               add light source
> rgl.material            Generic Appearance setup
> rgl.postscript          export screenshot
> rgl.primitive           add primitive set shape
> rgl.setMouseCallbacks   User callbacks on mouse events
> rgl.snapshot            export screenshot
> rgl.spheres             add sphere set shape
> rgl.surface             add height-field surface shape
> rgl.texts               add text
> rgl.user2window         Convert between rgl user and window coordinates
> rgl.viewpoint           Set up viewpoint
> select3d                Select a rectangle in an RGL scene
> spin3d                  Create a function to spin a scene at a fixed
>                         rate
> sprites3d               add sprite set shape
> subdivision3d           generic subdivision surface method
> surface3d               add height-field surface shape
>> sessionInfo()
> R version 2.7.1 (2008-06-23)
> i686-pc-linux-gnu
> locale:
> attached base packages:
> [1] stats     graphics  grDevices utils     datasets  methods   base
> other attached packages:
> [1] rgl_0.79     graph_1.18.1
> loaded via a namespace (and not attached):
> [1] cluster_1.11.11 tools_2.7.1
> On Wed, Jun 25, 2008 at 5:25 PM, Duncan Murdoch <murdoch at stats.uwo.ca> wrote:
>> Mark Kimpel wrote:
>>> Ben and Duncan,
>>> Thanks for your helpful suggestions. I"m having some difficulty
>>> navigating this really good package using my normal learning
>>> techniques. When I do 'help(package = "rgl") it seems only a very
>>> small subset of functions available show up.
>> I think the full list shows up there, if you're using a current version.
>>  What specific function is missing?
>>>  Perusing the rgl.pdf
>>> downloaded from CRAN demonstrates the same lack of documentation.
>> All of the functions intended for users are documented, and they show up in
>> rgl.pdf.
>>> There is no vignette. In addition, I have found at least one other
>>> package with 3d functions (emdbook::curve3d()).
>> A vignette would be nice, but there isn't one.  Our paper from useR 2007 is
>> the most recent reference (see
>> http://www.r-project.org/conferences/useR-2007/program/presentations/murdoch.pdf);
>> it cites Daniel's 2003 thesis and the 2003 paper about the package.
>> After those, the NEWS file lists some recent additions.
>> emdbook makes use of rgl and some other 3d engines, as does misc3d.
>>  scatterplot3d does it's own drawing.  rggobi is a completely different
>> interactive package.
>>> What is the best resource for learning about all the foo3d() and lower
>>> level functionality that rgl and its dependents provide? I saw a book
>>> at B&N just last week on openGL. Would that be helpful?
>> It might, but probably not.  rgl is intended to be a higher level R-style
>> interface to the things described in a book like that.  So if you have a
>> particular question about how to do something, you'd never find it there.
>>  On the other hand, if you want to know if something is possible, then that
>> might be a place to look for ideas.
>> Duncan Murdoch
>>> Mark
>>> On Tue, Jun 24, 2008 at 10:54 PM, Ben Bolker <bolker at ufl.edu> wrote:
>>>> Mark Kimpel <mwkimpel <at> gmail.com> writes:
>>>>> I'm using the command below on an open3d() object to create a shaded
>>>>> cube. Changes to myScalingFactor do not effect changes in the size of
>>>>> the cube. What is the correct approach? Mark
>>>>  how about scale3d() ?
>>>> shade3d(translate3d(scale3d(cube3d(),5,5,5),-6,1,-1),col="blue", alpha =
>>>> 0.2)
>>>> shade3d(translate3d(cube3d(),-6,1,-1),col="green", alpha = 0.2)
>>>> shade3d(translate3d(scale3d(cube3d(),10,10,10),-6,1,-1),col="red", alpha
>>>> = 0.2)
>>>> ______________________________________________
>>>> R-help at r-project.org mailing list
>>>> https://stat.ethz.ch/mailman/listinfo/r-help
>>>> PLEASE do read the posting guide
>>>> http://www.R-project.org/posting-guide.html
>>>> and provide commented, minimal, self-contained, reproducible code.

More information about the R-help mailing list