R语言 rplotengine包 rplotengine()函数中文帮助文档(中英文对照)

loveR

rplotengine(rplotengine)
rplotengine()所属R语言包：rplotengine

                                        R as a plotting engine
                                         R为一个绘图引擎

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

Generate a set of graphs as defined in the file specified.
生成指定的文件中所定义的一组曲线图。


用法----------Usage----------


   rplotengine (args_file = "mygraph.arg")



参数----------Arguments----------

参数：args_file
A character string giving the name of the text file containing the parameters for the graph to be plotted. The format of such input file is described in detail below.
一个字符串的名称的文本文件，其中包含的参数为要绘制的图形。这样的输入的文件的格式在下面详细描述。


Details

详细信息----------Details----------

The <STRONG>input file</STRONG> name passed to rplotengine is a plain text file with a list of pairs parameter=value, one-per-line.  The meaning of each parameter is explained below:
</ STRONG> <STRONG>输入文件名传递给rplotengine对parameter=value，一个每行的列表是一个纯文本文件。每个参数的含义进行说明如下：




title        Main title that can be shown in the graph. It is required to specify show_titles=1; otherwise the value will be ignored.
标题，可以在图中所示的主标题。需要指定show_titles=1，否则该值将被忽略。




subtitle     Subtitle that can be shown in the graph. It is required to specify show_titles=1; otherwise the value will be ignored.
的字幕的字幕，可以在图中所示。需要指定show_titles=1，否则该值将被忽略。




x_axis_title Title for the X-axis.
x_axis_title题名为X-轴。




y_axis_title Title for the Y-axis.
对于Y轴y_axis_title题名。




col_x_values Column number of the values for the X-axis within the input data file (starting from 1).
col_x_values内输入的数据文件（从1开始）的X轴的值的列编号。




col_y_values List with the columns number within the input data file corresponding to the series to be plotted. In case of using confidence intervals, each column within the input data file should be followed by another column containing its correspondig confidence interval values, but that column is not specified here, and this is why a tipical value for this argument is something like: 2,4,6,8 (being 3,5,7,9 the corresponding columns for the confidence intervals).
与输入的数据文件内的列数与要绘制的一系列对应col_y_values列表。使用置信区间的情况下，每一列输入数据文件应随后由另一列包含其correspondig的置信区间值，但没有指定列在这里，这就是为什么一个tipical这个参数的值是一样的东西，：2 ，4,6,8（即3,5,7,9的置信区间的对应列）。




series_names Name for the series to be plotted as should be shown in the legend. The number of names specified should match with the number of columns speficied in the argument col_y_values. In case of showing an overall serie (argumento total_serie greater than 0), an additional name for it should be specified too.
series_names要绘制的系列名称应显示在图例中。指定的名称相匹配与数的列speficied在参数col_y_values。在总体呈现意甲联赛（大于0 argumento total_serie），应该指定一个额外的名称。




x_factor     Value which the X-axis values will be multiplied by (usually 1).
x_factor实惠的X轴的值将被乘以（通常为1）。




y_factor     Value which the Y-axis values will be multiplied by (usually 1).
y_factor实惠将被乘以（通常为1），Y轴的值。




total_serie  Value ranged from 0 to 4, to indicate if an additional summary serie should be shown. The values mean: 0-none; 1-sum of all the series; 2-average of all the series; 3-constant value (specified by total_value); 4-proportional to the x value (proportion specified by total_value). In case of a total serie be shown (argument total_serie greater than 0), an additional name need to be specified in the list of names (argumento series_names).
total_serie值范围从0到4，以指示应显示出如果一个额外的简要意甲。值的含义：0  - 无的所有系列1和2的所有系列; 3恒定值（指定total_value）; 4比例的X值（指定的比例平均total_value“）。在显示的总意甲（参数total_serie大于0），需要指定一个额外的名称，在列表中的的的名称（argumento series_names）。




total_value  Value used for the argument total_serie in certain cases (3 and 4); otherwise, it is ignored.
total_value使用的值的参数total_serie（3和4）在某些情况下，否则，它会被忽略。




x_min        Minimum value for the X-axis (usually 0).
x_min最小的X轴的值（通常为0）。




x_max        Maximum value for the X-axis (usually -1). It is recommended to start with the -1 value, in order to the graph be shown automatically adjusted.
x_max最大的X轴的值（通常为-1）。建议-1值，以图显示自动调整。




y_min        Minimum value for the Y-axis (usually 0).
y_min最小的Y轴的值（通常为0）。




y_max        Maximum value for the Y-axis (usually -1). It is recommended to start with the -1 value, in order to the graph be shown automatically adjusted.
y_max最大的Y轴的值（通常为-1）。建议-1值，以图显示自动调整。




y_log        Value 0/1 to indicate if the Y-axis should be shown in logarithm scale (usually 0).
y_log值0/1，以指示是否应的Y轴示出在对数标度（通常为0）。




show_titles   Value 0/1 to indicate if title and subtitle are shown.
show_titles值0/1来表示，如果标题和副标题所示。




show_grid     Value 0/1 to indicate if a grid are shown in the background.
show_grid值0/1，以指示是否一个网格中示出在背景中。




show_hotspots         Value 0/1 to indicate if points are shown on each value over the lines plotted.
show_hotspots值0/1，以指示如果绘制的线的值超过上每个点示。




show_confint  Value 0/1 to indicate if confidence interval are shown.
show_confint值0/1来表示，如果置信。




confint_as_percentage Value 0/1 to indicate if the values for the confidence interval within the input data file are expressed as absolute values (0) or as a % value (1, the margin need to be calculated).
confint_as_percentage值0/1，以指示被表示为绝对的值（0），或为％值（1，保证金需要计算），如果输入的数据文件内的值的置信区间。




text_size_title       Font size for the title. The value specified will be a proportion to the normal text (1.0): for a greater font size specify values > 1.0; for smaller font size specify values < 1.0.
text_size_title标题的字体大小。指定的值将是一个更大的字体大小比例的普通文本（1.0）：指定值> 1.0;较小的字体大小指定值<1.0。




text_size_subtitle    Font size for the subtitle. The value specified will be a proportion to the normal text (1.0), as explained before.
text_size_subtitle的字幕的字体大小。指定的值将是正常的文本（1.0）的比例，如前面所解释。




text_size_axis_ticks  Font size for the X-axis and Y-axis numbers. The value specified will be a proportion to the normal text (1.0), as explained before.
text_size_axis_ticks字体大小为X-轴和Y-轴号码。指定的值将是正常的文本（1.0）的比例，如前面所解释。




text_size_axis_titles Font size for the X-axis and Y-axis titles. The value specified will be a proportion to the normal text (1.0), as explained before.
text_size_axis_titles字体大小为X-轴和Y-轴的标题。指定的值将是正常的文本（1.0）的比例，如前面所解释。




text_size_legend      Font size for the series names in the legend. The value specified will be a proportion to the normal text (1.0), as explained before.
text_size_legend的系列名称，在传说中的字体大小。指定的值将是正常的文本（1.0）的比例，如前面所解释。




pos_legend    Place for the legend in the graph, within a 3x3 grid with cells numbered from 1 to 9: 1-top left corner, 2-top middle; 3-top right corner; ... ; 9-bottom right corner. Specify a 0 value if a legend is not required.
传说中的图形，在一个3x3的网格，编号从1到9的单元：1左上角，2  - 顶部中间; 3右上角pos_legend的地方; 9  - 右下角。指定一个0值，如果一个传说是不需要的。




graph_type    Type of graph to generate (0:lines; 1:stacked bars).
图形生成graph_type类型（0：线路1：堆叠条）。




width_factor  Graph width. The value specified will be a proportion to the normal size (1.0): for a greater font size specify values > 1.0; for smaller font size specify values < 1.0.
width_factor图的宽度。指定的值将是一个更大的字体大小到正常大小的比例（1.0）：指定值> 1.0;较小的字体大小为指定值<1.0。




height_factor         Graph height. The value specified will be a proportion to the normal size (1.0): for a greater font size specify values > 1.0; for smaller font size specify values < 1.0.
height_factor图的高度。指定的值将是一个更大的字体大小到正常大小的比例（1.0）：指定值> 1.0;较小的字体大小为指定值<1.0。




data_filename         Path and name for the input data file. Path may be absolute or relative to the current directory.
data_filename输入数据文件的路径和名称。路径可以是绝对或相对于当前目录。




graph_filename        Path and name for the graphs to be generated (without suffix). Path may be absolute or relative to the current directory.
graph_filename的路径和名称要生成的图表（不包括后缀）。路径可以是绝对或相对于当前目录。




graph_fileext_seq     List of suffixes for each output format to generate. For example: png,eps. The final graph file names generated will be the specified with graph_filename joined to each of these suffixes.
graph_fileext_seq的后缀列表为每个输出格式生成。例如：PNG，EPS。最后的图形生成的文件名，将指定与graph_filename连接到每个这些后缀。

The following is an <STRONG>example of input file</STRONG> called "mygraph.arg".
下面是一个<STRONG>的例子的输入文件</ STRONG>所谓的mygraph.arg。


值----------Value----------

This function return a logical value indicating if the operation has succeeded (TRUE) or not (FALSE).
这个函数返回一个逻辑值，表示如果操作成功（TRUE）或（FALSE）。


（作者）----------Author(s)----------



<a href="http://atc.umh.es/pgarrido/">P. Pablo Garrido Abenza</a> (<a href="mailto:pgarrido@umh.es">pgarrido@umh.es</a>) <br>
<a href="http://atc.umh.es/gatcom/">Grupo de Arquitectura y Tecnologia de COMputadores (GATCOM)</a> <br>
<a href="http://www.umh.es">Miguel Hernandez University</a> (Elche, Spain)




实例----------Examples----------


## Generate the graphs as defined in the 'mygraph.arg' file.[＃的mygraph.arg文件中所定义的生成的曲线图。]
rplotengine ()
## Generate the graphs as defined in the 'mygraph.arg' file.[＃的mygraph.arg文件中所定义的生成的曲线图。]
rplotengine ("mygraph.arg")

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。