Subversion Repositories eFlore/Applications.cel

<?php

/**

 * PHPExcel

 *

 * Copyright (c) 2006 - 2013 PHPExcel

 *

 * This library is free software; you can redistribute it and/or

 * modify it under the terms of the GNU Lesser General Public

 * License as published by the Free Software Foundation; either

 * version 2.1 of the License, or (at your option) any later version.

 *

 * This library is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU

 * Lesser General Public License for more details.

 *

 * You should have received a copy of the GNU Lesser General Public

 * License along with this library; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

 *

 * @category	PHPExcel

 * @package		PHPExcel_Calculation

 * @copyright	Copyright (c) 2006 - 2013 PHPExcel (http://www.codeplex.com/PHPExcel)

 * @license		http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt	LGPL

 * @version		##VERSION##, ##DATE##

 */

/** PHPExcel root directory */

if (!defined('PHPEXCEL_ROOT')) {

	/**

	 * @ignore

	 */

	define('PHPEXCEL_ROOT', dirname(__FILE__) . '/../../');

	require(PHPEXCEL_ROOT . 'PHPExcel/Autoloader.php');

}

/**

 * PHPExcel_Calculation_Database

 *

 * @category	PHPExcel

 * @package		PHPExcel_Calculation

 * @copyright	Copyright (c) 2006 - 2013 PHPExcel (http://www.codeplex.com/PHPExcel)

 */

class PHPExcel_Calculation_Database {

	/**

	 * __fieldExtract

	 *

	 * Extracts the column ID to use for the data field.

	 *

	 * @access	private

	 * @param	mixed[]		$database		The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	mixed		$field			Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @return	string|NULL

	 *

	 */

	private static function __fieldExtract($database,$field) {

		$field = strtoupper(PHPExcel_Calculation_Functions::flattenSingleValue($field));

		$fieldNames = array_map('strtoupper',array_shift($database));

		if (is_numeric($field)) {

			$keys = array_keys($fieldNames);

			return $keys[$field-1];

		}

		$key = array_search($field,$fieldNames);

		return ($key) ? $key : NULL;

	}

	/**

	 * __filter

	 *

	 * Parses the selection criteria, extracts the database rows that match those criteria, and

	 * returns that subset of rows.

	 *

	 * @access	private

	 * @param	mixed[]		$database		The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	mixed[]		$criteria		The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	array of mixed

	 *

	 */

	private static function __filter($database,$criteria) {

		$fieldNames = array_shift($database);

		$criteriaNames = array_shift($criteria);

		//	Convert the criteria into a set of AND/OR conditions with [:placeholders]

		$testConditions = $testValues = array();

		$testConditionsCount = 0;

		foreach($criteriaNames as $key => $criteriaName) {

			$testCondition = array();

			$testConditionCount = 0;

			foreach($criteria as $row => $criterion) {

				if ($criterion[$key] > '') {

					$testCondition[] = '[:'.$criteriaName.']'.PHPExcel_Calculation_Functions::_ifCondition($criterion[$key]);

					$testConditionCount++;

				}

			}

			if ($testConditionCount > 1) {

				$testConditions[] = 'OR('.implode(',',$testCondition).')';

				$testConditionsCount++;

			} elseif($testConditionCount == 1) {

				$testConditions[] = $testCondition[0];

				$testConditionsCount++;

			}

		}

		if ($testConditionsCount > 1) {

			$testConditionSet = 'AND('.implode(',',$testConditions).')';

		} elseif($testConditionsCount == 1) {

			$testConditionSet = $testConditions[0];

		}

		//	Loop through each row of the database

		foreach($database as $dataRow => $dataValues) {

			//	Substitute actual values from the database row for our [:placeholders]

			$testConditionList = $testConditionSet;

			foreach($criteriaNames as $key => $criteriaName) {

				$k = array_search($criteriaName,$fieldNames);

				if (isset($dataValues[$k])) {

					$dataValue = $dataValues[$k];

					$dataValue = (is_string($dataValue)) ? PHPExcel_Calculation::_wrapResult(strtoupper($dataValue)) : $dataValue;

					$testConditionList = str_replace('[:'.$criteriaName.']',$dataValue,$testConditionList);

				}

			}

			//	evaluate the criteria against the row data

			$result = PHPExcel_Calculation::getInstance()->_calculateFormulaValue('='.$testConditionList);

			//	If the row failed to meet the criteria, remove it from the database

			if (!$result) {

				unset($database[$dataRow]);

			}

		}

		return $database;

	}

	/**

	 * DAVERAGE

	 *

	 * Averages the values in a column of a list or database that match conditions you specify.

	 *

	 * Excel Function:

	 *		DAVERAGE(database,field,criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	float

	 *

	 */

	public static function DAVERAGE($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		return PHPExcel_Calculation_Statistical::AVERAGE($colData);

	}	//	function DAVERAGE()

	/**

	 * DCOUNT

	 *

	 * Counts the cells that contain numbers in a column of a list or database that match conditions

	 * that you specify.

	 *

	 * Excel Function:

	 *		DCOUNT(database,[field],criteria)

	 *

	 * Excel Function:

	 *		DAVERAGE(database,field,criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	integer

	 *

	 * @TODO	The field argument is optional. If field is omitted, DCOUNT counts all records in the

	 *			database that match the criteria.

	 *

	 */

	public static function DCOUNT($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		return PHPExcel_Calculation_Statistical::COUNT($colData);

	}	//	function DCOUNT()

	/**

	 * DCOUNTA

	 *

	 * Counts the nonblank cells in a column of a list or database that match conditions that you specify.

	 *

	 * Excel Function:

	 *		DCOUNTA(database,[field],criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	integer

	 *

	 * @TODO	The field argument is optional. If field is omitted, DCOUNTA counts all records in the

	 *			database that match the criteria.

	 *

	 */

	public static function DCOUNTA($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		return PHPExcel_Calculation_Statistical::COUNTA($colData);

	}	//	function DCOUNTA()

	/**

	 * DGET

	 *

	 * Extracts a single value from a column of a list or database that matches conditions that you

	 * specify.

	 *

	 * Excel Function:

	 *		DGET(database,field,criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	mixed

	 *

	 */

	public static function DGET($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		if (count($colData) > 1) {

			return PHPExcel_Calculation_Functions::NaN();

		}

		return $colData[0];

	}	//	function DGET()

	/**

	 * DMAX

	 *

	 * Returns the largest number in a column of a list or database that matches conditions you that

	 * specify.

	 *

	 * Excel Function:

	 *		DMAX(database,field,criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	float

	 *

	 */

	public static function DMAX($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		return PHPExcel_Calculation_Statistical::MAX($colData);

	}	//	function DMAX()

	/**

	 * DMIN

	 *

	 * Returns the smallest number in a column of a list or database that matches conditions you that

	 * specify.

	 *

	 * Excel Function:

	 *		DMIN(database,field,criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	float

	 *

	 */

	public static function DMIN($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		return PHPExcel_Calculation_Statistical::MIN($colData);

	}	//	function DMIN()

	/**

	 * DPRODUCT

	 *

	 * Multiplies the values in a column of a list or database that match conditions that you specify.

	 *

	 * Excel Function:

	 *		DPRODUCT(database,field,criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	float

	 *

	 */

	public static function DPRODUCT($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		return PHPExcel_Calculation_MathTrig::PRODUCT($colData);

	}	//	function DPRODUCT()

	/**

	 * DSTDEV

	 *

	 * Estimates the standard deviation of a population based on a sample by using the numbers in a

	 * column of a list or database that match conditions that you specify.

	 *

	 * Excel Function:

	 *		DSTDEV(database,field,criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	float

	 *

	 */

	public static function DSTDEV($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		return PHPExcel_Calculation_Statistical::STDEV($colData);

	}	//	function DSTDEV()

	/**

	 * DSTDEVP

	 *

	 * Calculates the standard deviation of a population based on the entire population by using the

	 * numbers in a column of a list or database that match conditions that you specify.

	 *

	 * Excel Function:

	 *		DSTDEVP(database,field,criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	float

	 *

	 */

	public static function DSTDEVP($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		return PHPExcel_Calculation_Statistical::STDEVP($colData);

	}	//	function DSTDEVP()

	/**

	 * DSUM

	 *

	 * Adds the numbers in a column of a list or database that match conditions that you specify.

	 *

	 * Excel Function:

	 *		DSUM(database,field,criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	float

	 *

	 */

	public static function DSUM($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		return PHPExcel_Calculation_MathTrig::SUM($colData);

	}	//	function DSUM()

	/**

	 * DVAR

	 *

	 * Estimates the variance of a population based on a sample by using the numbers in a column

	 * of a list or database that match conditions that you specify.

	 *

	 * Excel Function:

	 *		DVAR(database,field,criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	float

	 *

	 */

	public static function DVAR($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		return PHPExcel_Calculation_Statistical::VARFunc($colData);

	}	//	function DVAR()

	/**

	 * DVARP

	 *

	 * Calculates the variance of a population based on the entire population by using the numbers

	 * in a column of a list or database that match conditions that you specify.

	 *

	 * Excel Function:

	 *		DVARP(database,field,criteria)

	 *

	 * @access	public

	 * @category Database Functions

	 * @param	mixed[]			$database	The range of cells that makes up the list or database.

	 *										A database is a list of related data in which rows of related

	 *										information are records, and columns of data are fields. The

	 *										first row of the list contains labels for each column.

	 * @param	string|integer	$field		Indicates which column is used in the function. Enter the

	 *										column label enclosed between double quotation marks, such as

	 *										"Age" or "Yield," or a number (without quotation marks) that

	 *										represents the position of the column within the list: 1 for

	 *										the first column, 2 for the second column, and so on.

	 * @param	mixed[]			$criteria	The range of cells that contains the conditions you specify.

	 *										You can use any range for the criteria argument, as long as it

	 *										includes at least one column label and at least one cell below

	 *										the column label in which you specify a condition for the

	 *										column.

	 * @return	float

	 *

	 */

	public static function DVARP($database,$field,$criteria) {

		$field = self::__fieldExtract($database,$field);

		if (is_null($field)) {

			return NULL;

		}

		//	reduce the database to a set of rows that match all the criteria

		$database = self::__filter($database,$criteria);

		//	extract an array of values for the requested column

		$colData = array();

		foreach($database as $row) {

			$colData[] = $row[$field];

		}

		// Return

		return PHPExcel_Calculation_Statistical::VARP($colData);

	}	//	function DVARP()

}	//	class PHPExcel_Calculation_Database