Graph: ezcGraphChartElementNumericAxis
[ ]
[ ]
[ ]
[ ]
[ ]
Class: ezcGraphChartElementNumericAxis
|
Class to represent a numeric axis. The axis tries to calculate "nice" start and end values for the axis scale. The used interval is considered as nice, if it is equal to [1,2,5] * 10^x with x in [.., -1, 0, 1, ..]. [
source]
The start and end value are the next bigger / smaller multiple of the intervall compared to the maximum / minimum axis value.
Parents
ezcBaseOptions
|
--ezcGraphChartElement
|
--ezcGraphChartElementAxis
|
--ezcGraphChartElementNumericAxis
Constants
MIN_MAJOR_COUNT
= 5
|
Constant used for calculation of automatic definition of major scaling steps |
MIN_MINOR_COUNT
= 8
|
Constant used for automatic calculation of minor steps from given major steps |
Properties
|
float |
read/write
|
$max
Maximum value of displayed scale on axis. |
|
float |
read
|
$maxValue
Maximum value to display on this axis. |
|
float |
read/write
|
$min
Minimum value of displayed scale on axis. |
|
float |
read
|
$minValue
Minimum Value to display on this axis. |
Inherited Member Variables
From
ezcGraphChartElementAxis:
From
ezcBaseOptions:
Method Summary
|
public void |
addData(
$values )
Add data for this axis |
|
public abstract void |
calculateAxisBoundings(
)
Calculate axis bounding values on base of the assigned values |
|
protected void |
calculateMajorStep(
$min, $max )
Calculate size of major step based on the span to be displayed and the defined MIN_MAJOR_COUNT constant. |
|
protected void |
calculateMaximum(
$min, $max )
Calculate maximum value for displayed axe basing on real maximum and major step size |
|
protected void |
calculateMinimum(
$min, $max )
Calculate minimum value for displayed axe basing on real minimum and major step size |
|
protected void |
calculateMinorStep(
$min, $max )
Calculate size of minor steps based on the size of the major step size |
|
public float |
getCoordinate(
$value )
Get coordinate for a dedicated value on the chart |
|
public string |
getLabel(
$step )
Get label for a dedicated step on the axis |
|
public integer |
getMajorStepCount(
)
Return count of major steps |
|
public integer |
getMinorStepCount(
)
Return count of minor steps |
|
protected float |
getNiceNumber(
$float )
Returns a "nice" number for a given floating point number. |
|
public bool |
isZeroStep(
$step )
Is zero step |
Inherited Methods
From
ezcGraphChartElementAxis :
From
ezcGraphChartElement :
From
ezcBaseOptions :
Methods
addData
void addData(
$values )
Add data for this axis
Parameters
| Name |
Type |
Description |
$values |
array |
Value which will be displayed on this axis |
Redefinition of
calculateAxisBoundings
void calculateAxisBoundings(
)
Calculate axis bounding values on base of the assigned values
Redefinition of
calculateMajorStep
void calculateMajorStep(
float
$min, float
$max )
Calculate size of major step based on the span to be displayed and the defined MIN_MAJOR_COUNT constant.
Parameters
| Name |
Type |
Description |
$min |
float |
Real data minimum |
$max |
float |
Real data maximum |
calculateMaximum
void calculateMaximum(
float
$min, float
$max )
Calculate maximum value for displayed axe basing on real maximum and major step size
Parameters
| Name |
Type |
Description |
$min |
float |
Real data minimum |
$max |
float |
Real data maximum |
calculateMinimum
void calculateMinimum(
float
$min, float
$max )
Calculate minimum value for displayed axe basing on real minimum and major step size
Parameters
| Name |
Type |
Description |
$min |
float |
Real data minimum |
$max |
float |
Real data maximum |
calculateMinorStep
void calculateMinorStep(
float
$min, float
$max )
Calculate size of minor steps based on the size of the major step size
Parameters
| Name |
Type |
Description |
$min |
float |
Real data minimum |
$max |
float |
Real data maximum |
getCoordinate
float getCoordinate(
float
$value )
Get coordinate for a dedicated value on the chart
Parameters
| Name |
Type |
Description |
$value |
float |
Value to determine position for |
Redefinition of
getLabel
string getLabel(
integer
$step )
Get label for a dedicated step on the axis
Parameters
| Name |
Type |
Description |
$step |
integer |
Number of step |
Redefinition of
getMajorStepCount
integer getMajorStepCount(
)
Return count of major steps
Redefinition of
getMinorStepCount
integer getMinorStepCount(
)
Return count of minor steps
Redefinition of
getNiceNumber
float getNiceNumber(
float
$float )
Returns a "nice" number for a given floating point number.
Nice numbers are steps on a scale which are easily recognized by humans like 0.5, 25, 1000 etc.
Parameters
| Name |
Type |
Description |
$float |
float |
Number to be altered |
isZeroStep
bool isZeroStep(
int
$step )
Is zero step
Returns true if the given step is the one on the initial axis position
Parameters
| Name |
Type |
Description |
$step |
int |
Number of step |
Redefinition of
Last updated: Wed, 18 Jun 2008