sculpt3d(sculpt3d)
sculpt3d()所属R语言包：sculpt3d
The sculpt3d GUI for interactive 3d plot brushing and editing
sculpt3d GUI互动的3D绘图刷牙和编辑
译者：生物统计家园网 机器人LoveR
描述----------Description----------
Provides a simple toolbar GUI for interacting with 3D rgl plots. The data to be plotted is provided to sculpt3d(), which calls relevant rgl plot3d() functions by proxy. A subset of the plot3d() arguments is accommodated. See below for the list of acceptable parameters.
提供了一个简单的工具栏的图形用户界面与3D RGL图。要绘制的数据提供给sculpt3d（），它调用相关的RGL PLOT3D（）函数的代理。容纳PLOT3D（）参数的一个子集。请参阅下面的列表中可接受的参数。
用法----------Usage----------
sculpt3d(x, y = NULL, z = NULL, col = 'black', labels = NULL, radius = NULL, type = 'p', alpha = NULL, callback = NULL, size = NULL)
参数----------Arguments----------
参数：x, y, z
coordinates. Any reasonable way of defining the coordinates is acceptable. See the function xyz.coords for details.
坐标系。任何合理的方式定义的坐标是可以接受的。见的功能xyz.coords的详细信息。
参数：col
the color to be used for plotted items.
的颜色要用于绘制项目。
参数：labels
the labels to be used for plotted items.
标签要用于绘制项目。
参数：radius
the radius to be used if type='s': see Details below.
半径时，将使用type='s'：看下面的详细信息。
参数：type
the type of plot to generate. Currently supported types include 'p' for points, and 's' for spheres.
图生成的类型。目前支持的类型包括'p'点，和's'领域。
参数：alpha
the alpha transparency to use.
使用的Alpha透明度。
参数：size
the size for plotted points
绘制点的大小
参数：callback
the callback function to use.
使用的回调函数。
Details
详细信息----------Details----------
The above arguments are passed on to plot3d for plotting. However, rgl currently does not have a method of determining which data points are currently being represented in a given rgl device. Therefore, it is necessary to first pass this data to sculpt3d to generate both the toolbar and the rgl plot.
以上参数传递给plot3d进行打印。然而，RGL目前并没有确定哪些数据点，目前正在表示在一个给定的RGL的移动设备的方法。因此，它是必要的，首先将此数据传递到sculpt3d来生成工具栏和RGL图。
Through the course of interaction with the toolbar, the data points become filtered by the select3d function. This type of filtering is not easily applicable for certain rgl plot methods (such as lines, meshes, quads, etc.), so only plots comprised of individual datapoints such as points and spheres are allowed for sculpt3d.
通过互动的工具栏的过程中，数据点成为过滤，由select3d功能。这种类型的过滤是不容易适用于一定RGL图的方法（如线条，网格，四边形等），所以只图由点和领域，如个别数据点所允许的sculpt3d。
The toolbar provides the following functionality:
工具栏提供了以下功能：
Selecting data points : Clicking the <STRONG>Select3d</STRONG> button will activate the select3d mode in rgl. Once clicked, it is possible to select data points in the current rgl plot. These points will be colored by the current color indicated by the <STRONG>Color</STRONG> button.
选择数据点：点击的<STRONG> Select3d </ STRONG>“按钮，将激活select3d模式，RGL。一旦点击，它是可以选择的数据点RGL图。这些积分将被着色的颜色表示的<STRONG>颜色</ STRONG>按钮。
Changing color of selected data points : Clicking the <STRONG>Color</STRONG> button will change the highlight color of the selection mode.
更改颜色选定的数据点：点击<STRONG>颜色</ STRONG>按钮将更改高亮颜色的选择模式。
Labeling data points : This attaches text labels to each datapoint in the plot. By default these are a simple enumeration of the datapoints, but it's possible to override this by passing a label argument.
每一个数据点在图中标注数据点：这华武官的文本标签。默认情况下这是一个简单的列举的数据点，但它是通过标签参数可以覆盖这个。
Cropping data points : Once data points are selected with <STRONG>Select3d</STRONG>, it is possible to crop or delete them with the <STRONG>Crop</STRONG> button. The data is not actually deleted, it is just filtered from the current plot view.
裁剪数据点：一旦数据点的选择与<STRONG> Select3d </ STRONG>，可以用于裁切或删除的<STRONG>作物</ STRONG>按钮。的数据实际上并未删除，只是从目前的图形视图过滤。
Deleting data points : The <STRONG>Delete</STRONG> works similarly to the Crop Data Points button, except it deletes the currently selected points.
删除数据点：<STRONG>删除</ STRONG>的作品，但同样的作物数据点“按钮，删除当前选定的点。
Resetting plot : The <STRONG>Reset</STRONG> button will reset the plot back to its original state.
复位图：<STRONG>重置</ STRONG>“按钮将复位到其原始状态的图。
Changing the mouse mode : The three combo box controls at the bottom can change the mouseMode settings in par3d. See Warning section below.
更改鼠标模式：三个组合框控件的底部可以改变mouseMode的的设置par3d。见警告一节。
During interaction with the toolbar and plot, it is possible to retrieve a logic vector of the selected or visible items by calling sculpt3d.selected or sculpt3d.current resepectively. Other rgl commands are still available, such as the rgl.snapshot for saving plots as images.
在互动工具栏和图，它是可能的检索逻辑向量选择的或可见的项目通过调用sculpt3d.selected或sculpt3d.currentresepectively，。其他RGL命令仍然可用的，如rgl.snapshot图保存为图像。
If the rgl plot window is closed, the toolbar will throw an error and close the next time a button is clicked.
如果“RGL图”窗口已关闭，则工具栏将抛出一个错误，并关闭时，按下一个按钮。
值----------Value----------
sculpt3d is called for the side effect of drawing the RGL plot and generating the GUI. No value is returned.
sculpt3d被称为绘画的的RGL图和生成GUI的副作用。无返回值。
警告----------Warning----------
It is strongly recommended to not call additional rgl plot functions on sculpt3d's current rgl device. This can cause confuse the plotting, selection, and editing routines, and can even crash the toolbar.
这是强烈建议不要调用其他RGL绘图功能sculpt3d RGL设备。这可能会导致混淆的绘图，选择和编辑例程，甚至可以崩溃的工具栏。
The toolbar itself is generated from a GTK builder file, and is created as a window in GTK+'s toolbar window-hint mode. This allows the toolbar to float on top of the OpenGL window on some platforms, and remain immediately active without the need to switch between applications in the window manager. However, this has the unfortunate side effect of obscuring the combo box drop down list on some platforms. Currently, the workaround is to select the combo box, and change the values with the up/down arrows until it shows the correct value.
工具栏本身所产生的GTK生成器文件，并创建一个窗口，在GTK +的工具栏窗口提示模式。这使得在某些平台上的OpenGL窗口顶部的工具栏浮动，并立即开始工作，而需要在窗口管理器的应用程序之间切换。然而，这种模糊组合框的下拉列表中某些平台上有不幸的副作用。目前，解决办法是选择组合框，并更改值的向上/向下箭头，直到它显示正确的值。
In addition, the OSX version will throw several "invalid context" errors when sculpt3d is initialized for the first time. This is a known issue with the RGTK2 bundle, and these errors do not affect the performance of the interface.
此外，OSX版本时，将抛出一些“无效的上下文”的错误sculpt3d初始化为第一次。这是一个已知的问题的RGTK2束，这些错误不影响性能的接口。
（作者）----------Author(s)----------
Justin Donaldson jdonaldson@gmail.com
参见----------See Also----------
select3d, plot3d
select3d, plot3d
实例----------Examples----------
#run this directly with demo(sculpt3d)[直接运行这个与演示（sculpt3d的）]
x <- sort(rnorm(1000))
y <- rnorm(1000)
z <- rnorm(1000) + atan2(x,y)
sculpt3d(x, y, z, labels=1:1000, col=rainbow(1000), type='s', radius=runif(1000)/5, alpha = .5)
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-9-29 23:11:43
