TeeChart for PHP包含100%的PHP源代碼。它支持PHP5及更高的版本。它可作為一個(gè)調(diào)色板組件整合到針對(duì)PHP的Delphi編程環(huán)境中，從而讓其他人在運(yùn)行時(shí)以創(chuàng)建組件的方式來(lái)引用。第一個(gè)版本提供17種圖表類(lèi)型（2D和3D的多種組合），11個(gè)數(shù)學(xué)函數(shù)和一些圖表工具組件以擴(kuò)展功能。

點(diǎn)擊下載TeeChart for PHP試用版

    本教程是TeeChart for PHP教程中與系列一起工作這一節(jié)。本章節(jié)的內(nèi)容主要分為以下幾個(gè)部分：

      功能類(lèi)型

• 功能特點(diǎn)

• 功能的添加

• 定義數(shù)據(jù)源

• 功能期

• 功能期的對(duì)齊

• 派生自定義功能

功能類(lèi)型

功能特點(diǎn)

    TeeChart Pro功能是一個(gè)系列，幾乎可以是任何系列類(lèi)型，可以應(yīng)用代數(shù)函數(shù)，也可以是另一個(gè)圖表系列的數(shù)據(jù)源。所有函數(shù)都派生自函數(shù)組件并繼承函數(shù)的Period方法。

    TeeChart Pro包含以下預(yù)定義功能列表。有關(guān)所有功能類(lèi)型的完整列表，請(qǐng)參閱TeeChart Editor Gallery和Helpfile：

    多種函數(shù)類(lèi)型僅支持一個(gè)輸入系列。但是，可以鏈接鏈接函數(shù)。例如，將圖表中多個(gè)系列的平均值創(chuàng)建為平均函數(shù)系列，然后使用平均函數(shù)作為趨勢(shì)函數(shù)的輸入來(lái)標(biāo)識(shí)平均值的趨勢(shì)。

功能的添加

    每個(gè)功能都顯示為一個(gè)系列，您可以之后更改與該功能關(guān)聯(lián)的系列類(lèi)型。

    假設(shè)我們從一個(gè)完全空的Chart開(kāi)始，這里是代碼中構(gòu)建一個(gè)簡(jiǎn)單的Series-Function相關(guān)Chart的步驟。

private function Load() {
 
//Add a data Series 
$line1 = new Line($tChart1->getChart());
 
//Populate it with data (here random) 
$line1->fillSampleValues(10); 
 
//Add a series to be used for an Average Function 
$line2 = new Line($tChart1->getChart()); 
 
//Define the Function Type for the new Series 
$average1 = new Average(); 
$line2->setFunction($average1); 
 
//Define the Datasource for the new Function Series 
$line2->setDataSource($line1); 
 
//*Note - When populating your input Series manually you will need to 
//use the Checkdatasource method 
//- See the section entitled 'Defining a Datasource' 
//Change the Period of the Function so that it groups averages 
//every 2 Points 
$line2->getFunction()->setPeriod(2); 
$line2->checkDataSource();
}

    我們可以添加另一個(gè)函數(shù)來(lái)告訴我們有關(guān)前一個(gè)函數(shù)的信息。

//Let's change to 2D for visibility 
$tChart1->getAspect()->setView3D(false); 
//Add another Series to be used for a 2nd Function 
$line3 = new Line($tChart1->getChart()); 
//Define the Function Type for the new Series 
$high1 = High(); 
$line3->setFunction($high1); 
//Define the Datasource for the new Function Series 
//Use the existing Function (Series2) as input 
$line3->setDataSource($tChart1->getSeries(1)); 
//Leave the Period at default 0 (No Period set) to draw 
//A line at Highest of all points of the Average Function

定義數(shù)據(jù)源

    上面示例重點(diǎn)介紹了使用Datasource按代碼對(duì)函數(shù)進(jìn)行內(nèi)容處理。Series使用Datasource定義Function的輸入或定義Series Dataset數(shù)據(jù)源。按代碼的數(shù)據(jù)源使用Series-> Datasource屬性。

    假設(shè)我們?cè)趫D表中有2個(gè)數(shù)據(jù)系列。我們添加了一個(gè)由2系列的平均值組成的函數(shù)：

require_once "../sources/TChart.php"; $tChart1 = new TChart(600,450); 
 
private function Load() {
  $tChart1->getAspect()->setView3D(false); 
  $bar1->fillSampleValues(10); 
  $bar2->fillSampleValues(10); 
 }
 
public function button1_click() {
  $line1 = new Line($tChart1->getChart()); 
  $average3 = new Average(); 
  $tmpDataSource = Array($bar1,$bar2);
  $line1->setFunction($tmpDataSource); 
  $line1->setDataSource($bar1); 
 
  $line1->getMarks()->setVisible(true);
}

    我們?yōu)?系列添加點(diǎn)數(shù)：

public function button1_click() {
 
    for($i = 0; $i < 10; ++$i) 
     $bar1->add(rand(0,500)); 
     $bar2->add(rand(0,500)); 
   }
}

    注意：該功能不會(huì)顯示，您需要使用checkDataSource方法讀入Function的值。

$tChart1->getSeries(2)->checkDataSource();

    可以在運(yùn)行時(shí)更改函數(shù)定義，只需通過(guò)重新定義Series.DataSource方法將新函數(shù)分配給Series：

public function button3_click() {
      $cumulative1 = Cumulative(); 
      $tChart1->getSeries(2)->setFunction($cumulative1);

功能期

    Period是使用函數(shù)的重要方法，因?yàn)镻eriod定義了循環(huán)應(yīng)用Function的點(diǎn)的范圍。

    假如：我們有6個(gè)數(shù)據(jù)點(diǎn)（例如Bar系列的條形圖），其值為：3，8，6，2，9和12，我們定義一個(gè)具有周期0的函數(shù)系列（默認(rèn)），繪制的平均值為：6.667，將Period設(shè)置為2，我們得到3個(gè)平均值作為函數(shù)的輸出：5.5，4和10.5。這些值將在其周期范圍內(nèi)集中繪制，即輸入系列的第1和第2欄之間的第1個(gè)值，第3和第4欄之間的第2個(gè)值等。

    您可以使用FunctionType在運(yùn)行時(shí)定義Period。

    例如，系列2是功能系列：

$line1->getFunction()->setPeriod(2);

以下是2張圖表，能夠突出顯示應(yīng)用期間的效果。

功能期的對(duì)齊

    期間可以定義為范圍。這在使用DateTime系列時(shí)非常有用，我們希望將函數(shù)的Period表示為T(mén)imeStep。屬性PeriodStyle控制如何表達(dá)Period。

    例如，您現(xiàn)在可以使用日期時(shí)間源系列上的正常平均功能繪制月平均銷(xiāo)售額功能，并將功能周期設(shè)置為一個(gè)月：

require_once "../sources/TChart.php"; $tChart1 = new TChart(600,450); 
 
//Add in a Bar Series and Average Function . 
$bar = new Bar($tChart1->getChart());
 //Populate it with data (here random)  $bar->fillSampleValues(10); //Add a series to be used for an Average Function  $line2 = new Line($tChart1->getChart());  $average1 = new Average();
$line2->setFunction($average1); 
 
private function Load() {
        $tChart1->getAspect()->setView3D(false);   
 
        $today = date_time(‘U’);
    
        $bar1->getMarks()->setVisible(false); 
        $bar1->getXValues()->setDateTime(true); 
        $tChart1->getAxes()->getBottom()->getLabels()->setAngle(90); 
    
        for($i = 0; $i < 60; ++$i)  
            $days7 = 7 * 86400; 
            $today = $today + $days7; 
            $bar1->add($today, rand(0,100),"",Color::RED()); 
    
     $average1->setPeriodAlign(PeriodAligns::$FIRST); 
        $average1->setPeriodStyle(PeriodStyles::$RANGE); 
        $average1->setPeriod(30); 
        $line1->setDataSource($bar1); 
        $line1->checkDataSource();
}

    這將產(chǎn)生幾個(gè)點(diǎn)，每個(gè)點(diǎn)顯示Bar系列中每個(gè)月數(shù)據(jù)的平均值。在計(jì)算日期時(shí)間段的函數(shù)時(shí)，源系列中的點(diǎn)應(yīng)按日期排序。該范圍也可用于非日期時(shí)間序列：

     for($i = 0; $i < 60; ++$i)  
        $bar1->add($i, rand(0,100),"",Color::RED()); 
        
        $average1->setPeriodAlign(PeriodAligns::$FIRST); 
        $average1->setPeriodStyle(PeriodStyles::$RANGE); 
        $average1->setPeriod(6);

    這將計(jì)算每個(gè)6區(qū)間內(nèi)每組點(diǎn)的平均值。（X> = 6，X

    使用周期對(duì)齊屬性可以對(duì)齊系”范圍內(nèi)的功能點(diǎn)。以下將繪制月度期末的功能點(diǎn)：

$average1->setPeriodAlign(PeriodAligns::$FIRST); 
      $average1->setPeriodStyle(PeriodStyles::$RANGE); 
      $average1->setPeriod(DateTime::getDaysInMonth(year,month));

Period = Month.TotalDays和PeriodAligns.First

從下圖中可以看出，平均值是在月底繪制的：

Period = Month.TotalDays和PeriodAligns.Last

在這種情況下，平均值在月初繪制：

派生自定義功能

    創(chuàng)建一個(gè)新的Function組件只是創(chuàng)建一個(gè)派生自Functions類(lèi)的新組件（它也可以從現(xiàn)有函數(shù)派生）。在TTeeFunction中有兩個(gè)重要的虛擬方法可以被覆蓋以創(chuàng)建新的Function類(lèi)型。

• Function.Calculate：public virtual double Calculate（（Series）Source，（int）First，（int）Last）
  

• Function.CalculateMany：public virtual double CalculateMany（（ArrayList）SourceSeries，（int）ValueIndex）
  

    如果只有一個(gè)系列是數(shù)據(jù)源，則Calculate方法用于計(jì)算函數(shù)結(jié)果。如果多個(gè)系列可以是數(shù)據(jù)源，則CalculateMany用于計(jì)算函數(shù)結(jié)果。

    示例：創(chuàng)建新的SquareSum功能。

    假設(shè)我們需要一個(gè)SquareSum函數(shù)來(lái)返回平方和，此函數(shù)只能有一個(gè)數(shù)據(jù)源或多個(gè)數(shù)據(jù)源，因此我們將覆蓋Calculate和CalculateMany方法。

public class quareSum extends Functions {
 
    public function quareSum($c=null) {
      parent::__constructor($c);
    } 
 
    public calculate($sourceSeries, $firstIndex, $lastIndex) {
        $v = $this->valueList($sourceSeries);
        if ($firstIndex == -1) {
            return $v->getTotal();
        } else {
            result = 0;
            for ($t = $firstIndex; $t getValue($t));
            }
            return (Double)$result;
        }
    }
 
  
    public function calculateMany($sourceSeriesList, $valueIndex) {
        $result = 0;
 
        for ($t = 0; $t < sizeof($sourceSeriesList); $t++) {
            $v = $this->valueList($sourceSeriesList[$t]);
            if ($v->count > $valueIndex) {
                $result+=sqrt($v->getValue($valueIndex));
            }
        }
        return $result;
    }

    FirstIndex和EndIndex變量用于循環(huán)所有SourceSeries點(diǎn)以計(jì)算平方和。

    ValueList方法用于提取必需的Steema.TeeChart.ValueList，以使該類(lèi)適用于像HorizBarSeries這樣的Series類(lèi)型，其中是XValues保存點(diǎn)值而不是YValues。

    當(dāng)Series只有一個(gè)Series作為DataSource時(shí)，使用Calculate方法。當(dāng)Series有多個(gè)Series作為數(shù)據(jù)源時(shí)，將調(diào)用CalculateMany方法。

    對(duì)于源系列中的每個(gè)點(diǎn)，CalculateMany將被調(diào)用一次，從零開(kāi)始，以所有數(shù)據(jù)源的最小點(diǎn)數(shù)結(jié)束。

    理解Calculate和CalculateMany之間的區(qū)別非常重要。當(dāng)Series只有一個(gè)Series作為DataSource時(shí)，使用Calculate方法。當(dāng)Series有多個(gè)Series作為數(shù)據(jù)源時(shí)，將調(diào)用CalculateMany方法（每個(gè)點(diǎn)一個(gè)）。

    這一章節(jié)教程就是這樣了，下一節(jié)將會(huì)介紹TeeChart for PHP的縮放與滾動(dòng)。

關(guān)注慧聚IT微信公眾號(hào) ???，了解產(chǎn)品的最新動(dòng)態(tài)及最新資訊。