SetDataType — Indicate the format of the data array
$plot->SetDataType($dt
)
SetDataType
tells PHPlot how to interpret the data
array set with SetDataValues.
More information on data types can be found in Section 3.3, “PHPlot Data Types”.
$dt
The data array format type, which must be one of the following values:
Data Type | Description |
---|---|
text-data |
Plot with implied X: (Label, Y1, [Y2, ...])
|
data-data |
Plot with explicit X: (Label, X, Y1, [Y2, ...])
|
data-data-error |
Error plot: (Label, X, Y1, Y1err+, Y1err-, [Y2, ...])
|
text-data-single |
Simple pie chart data: (Label, Value)
|
text-data-yx |
Horizontal plot with implied Y: (Label, X1, [X2, ...])
|
data-data-yx |
Horizontal plot with explicit Y: (Label, Y, X1, [X2, ...])
|
data-data-yx-error |
Horizontal error plot: (Label, Y, X1, X1err+, X1err-, [X2, ...])
|
data-data-xyz |
Plot with X, Y, Z data: (Label, X, Y1, Z1, [Y2, Z2, ...])
|
Note: The descriptions above show one row of the data array.
The default data type is text-data
.
An example of a text-data
data array is:
$data = array( array('Jan', 100, 150, 200), array('Feb', 110, 140, 210), array('Mar', 120, 145, 200), array('Apr', 110, 160, 220) );
This defines the data for 3 data sets with 4 points on each, and a month name
as label for each point.
This is also a valid data array for data type text-data-yx
.
An example of a data-data
data array is:
$data = array( array('', 2, 15), array('', 4, 14), array('', 6, 10), array('', 8, 20) );
Here the labels are empty strings, next are the X values, then a single
set of Y values (1 data set, 1 plot line).
This is also a valid data array for data type data-data-yx
,
with each row containing a Y value, followed by a single X value.
An example of a data-data-error
data array is:
$data = array( array('1999', 1, 23.5, 5, 3), array('2000', 2, 20.1, 4, 4), array('2001', 3, 19.1, 3, 4), array('2002', 4, 16.8, 4, 3) );
Here the labels are years, next are the X values 1-4, then a single set of Y values with error ranges between 3 and 5 for each point.
An example of a text-data-single
data array,
used only for pie charts, is:
$data = array( array('', 10), array('', 40), array('', 50) );
Here the labels are empty, and 3 segments with relative weights of 10, 40, and 50 are defined.
Data type alias data-data-error-yx
can be used in place
of data-data-yx-error
. There are other data type aliases,
such as text-linear
, which exist for compatibility with very
old versions of PHPlot, but they are not documented.
Data type data-data-yx-error
was added in PHPlot-6.1.0
for horizontal error plots.
Data type data-data-xyz
was added in PHPlot-5.5.0 for
the bubbles plot type.
Data type data-data-yx
for horizontal plots was added
in PHPlot-5.1.3.
Data type text-data-yx
for horizontal bar charts was added
in PHPlot-5.1.2.
This version of the manual was produced for the
PHPlot Sourceforge project web service site, which requires the logo on each
page.
To download a logo-free copy of the manual, see the
PHPlot project downloads
area.