SurveyMetricQuestionEvaluation Class Reference

Survey metric evaluation. More...

Inheritance diagram for SurveyMetricQuestionEvaluation:

Collaboration diagram for SurveyMetricQuestionEvaluation:

Public Member Functions
	getGrid ($a_results, $a_abs=true, $a_perc=true)
	Get grid data. More...
	getChart ($a_results)
	Get chart. More...
	getExportGrid ($a_results)
	Get grid data. More...
	addUserSpecificResults (array &$a_row, $a_user_id, $a_results)
Public Member Functions inherited from SurveyQuestionEvaluation
	__construct (SurveyQuestion $a_question, array $a_finished_ids=null)
	Constructor. More...
	getResults ()
	Get results. More...
	parseUserSpecificResults ($a_qres, $a_user_id)
	getGrid ($a_results, $a_abs=true, $a_perc=true)
	Get grid data. More...
	getTextAnswers ($a_results)
	Get text answers. More...
	getChart ($a_results)
	Get chart. More...
	getSkippedValue ()
	Get caption for skipped value. More...
	exportResults ($a_results, $a_do_title, $a_do_label)
	getExportGrid ($a_results)
	Get grid data. More...
	getUserSpecificVariableTitles (array &$a_title_row, array &$a_title_row2, $a_do_title, $a_do_label)
	Get title columns for user-specific export. More...
	addUserSpecificResults (array &$a_row, $a_user_id, $a_results)

Protected Member Functions
	parseResults (ilSurveyEvaluationResults $a_results, array $a_answers, SurveyCategories $a_categories=null)
	Parse answer data into results instance. More...
Protected Member Functions inherited from SurveyQuestionEvaluation
	parseResults (ilSurveyEvaluationResults $a_results, array $a_answers, SurveyCategories $a_categories=null)
	Parse answer data into results instance. More...
	getChartColors ()
	getSurveyId ()
	getNrOfParticipants ()
	Returns the number of participants for a survey. More...
	getAnswerData ()

Additional Inherited Members
Protected Attributes inherited from SurveyQuestionEvaluation
	$lng
	$db
	$question
	$finished_ids
	$chart_width = 400
	$chart_height = 300

Detailed Description

Survey metric evaluation.

Author

Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 12 of file class.SurveyMetricQuestionEvaluation.php.

Member Function Documentation

addUserSpecificResults()

SurveyMetricQuestionEvaluation::addUserSpecificResults	(	array &	$a_row,
			$a_user_id,
			$a_results
	)

Parameters

array	$a_row
int	$a_user_id
ilSurveyEvaluationResults | array	$a_results

Reimplemented from SurveyQuestionEvaluation.

Definition at line 181 of file class.SurveyMetricQuestionEvaluation.php.

    {
        $answer = $a_results->getUserResults($a_user_id);
        if ($answer === null) {
            $a_row[] = $this->getSkippedValue();
        } else {
            $a_row[] = $answer[0][0];
        }
    }

References SurveyQuestionEvaluation\getSkippedValue().

Here is the call graph for this function:

getChart()

SurveyMetricQuestionEvaluation::getChart

(

$a_results

)

Get chart.

Parameters

ilSurveyEvaluationResults | array

$a_results

Returns

array

Reimplemented from SurveyQuestionEvaluation.

Definition at line 99 of file class.SurveyMetricQuestionEvaluation.php.

    {
        $lng = $this->lng;
        
        include_once "Services/Chart/classes/class.ilChart.php";
        $chart = ilChart::getInstanceByType(ilChart::TYPE_GRID, $a_results->getQuestion()->getId());
        $chart->setYAxisToInteger(true);
        
        $colors = $this->getChartColors();
        $chart->setColors($colors);
 
        // :TODO:
        $chart->setsize($this->chart_width, $this->chart_height);
                        
        $data = $chart->getDataInstance(ilChartGrid::DATA_BARS);
        $data->setLabel($lng->txt("category_nr_selected"));
        $data->setBarOptions(0.5, "center");
        $data->setFill(1);
        
        $total = sizeof($a_results->getAnswers());
        if ($total > 0) {
            $cumulated = array();
            foreach ($a_results->getAnswers() as $answer) {
                $cumulated[$answer->value]++;
            }
            
            $labels = array();
            foreach ($cumulated as $value => $count) {
                $data->addPoint($value, $count);
                $labels[$value] = $value;
            }
            $chart->addData($data);
 
            $chart->setTicks($labels, false, true);
        
            return $chart->getHTML();
        }
    }

References $chart, $data, SurveyQuestionEvaluation\$lng, $total, ilChartGrid\DATA_BARS, SurveyQuestionEvaluation\getChartColors(), ilChart\getInstanceByType(), and ilChart\TYPE_GRID.

Here is the call graph for this function:

getExportGrid()

SurveyMetricQuestionEvaluation::getExportGrid

(

$a_results

)

Get grid data.

Parameters

ilSurveyEvaluationResults | array

$a_results

Returns

array

Reimplemented from SurveyQuestionEvaluation.

Definition at line 149 of file class.SurveyMetricQuestionEvaluation.php.

    {
        $lng = $this->lng;
        
        $res = array(
            "cols" => array(
                $lng->txt("value"),
                $lng->txt("category_nr_selected"),
                $lng->txt("svy_fraction_of_selections")
            ),
            "rows" => array()
        );
        
        // as we have no variables build rows from answers directly
        $total = sizeof($a_results->getAnswers());
        if ($total > 0) {
            $cumulated = array();
            foreach ($a_results->getAnswers() as $answer) {
                $cumulated[$answer->value]++;
            }
            foreach ($cumulated as $value => $count) {
                $res["rows"][] = array(
                    $value,
                    $count,
                    sprintf("%.2f", $count/$total*100) . "%"
                );
            }
        }
                
        return $res;
    }

References SurveyQuestionEvaluation\$lng, $res, $total, and sprintf.

getGrid()

SurveyMetricQuestionEvaluation::getGrid	(		$a_results,
			$a_abs = true,
			$a_perc = true
	)

Get grid data.

Parameters

ilSurveyEvaluationResults | array	$a_results
bool	$a_abs
bool	$a_perc

Returns

array

Reimplemented from SurveyQuestionEvaluation.

Definition at line 40 of file class.SurveyMetricQuestionEvaluation.php.

    {
        $lng = $this->lng;
        
        if ((bool) $a_abs && (bool) $a_perc) {
            $cols = array(
                $lng->txt("category_nr_selected"),
                $lng->txt("svy_fraction_of_selections")
            );
        } elseif ((bool) $a_abs) {
            $cols = array(
                $lng->txt("category_nr_selected")
            );
        } else {
            $cols = array(
                $lng->txt("svy_fraction_of_selections")
            );
        }
        
        $res = array(
            "cols" => $cols,
            "rows" => array()
        );
        
        // as we have no variables build rows from answers directly
        $answ = $a_results->getAnswers();
        if (is_array($answ)) {
            $total = sizeof($a_results->getAnswers());
            if ($total > 0) {
                $cumulated = array();
                foreach ($a_results->getAnswers() as $answer) {
                    $cumulated[$answer->value]++;
                }
                foreach ($cumulated as $value => $count) {
                    $perc = sprintf("%.2f", $count / $total * 100) . "%";
                    if ((bool) $a_abs && (bool) $a_perc) {
                        $res["rows"][] = array(
                            $value,
                            $count,
                            $perc
                        );
                    } elseif ((bool) $a_abs) {
                        $res["rows"][] = array(
                            $value,
                            $count
                        );
                    } else {
                        $res["rows"][] = array(
                            $value,
                            $perc
                        );
                    }
                }
            }
        }
        
        return $res;
    }

References $cols, SurveyQuestionEvaluation\$lng, $res, $total, and sprintf.

parseResults()

SurveyMetricQuestionEvaluation::parseResults ( ilSurveyEvaluationResults  $a_results, array  $a_answers, SurveyCategories  $a_categories = null  )

protected

Parse answer data into results instance.

Parameters

ilSurveyEvaluationResults	$a_results
array	$a_answers
SurveyCategories	$a_categories

Reimplemented from SurveyQuestionEvaluation.

Definition at line 18 of file class.SurveyMetricQuestionEvaluation.php.

    {
        parent::parseResults($a_results, $a_answers);
        
        // add arithmetic mean
        $total = $sum = 0;
        foreach ($a_answers as $answers) {
            foreach ($answers as $answer) {
                $total++;
                $sum += $answer["value"];
            }
        }
        if ($total > 0) {
            $a_results->setMean($sum/$total);
        }
    }

References $total, and ilSurveyEvaluationResults\setMean().

Here is the call graph for this function:

---

The documentation for this class was generated from the following file:

• Modules/SurveyQuestionPool/classes/class.SurveyMetricQuestionEvaluation.php