Survey metric evaluation. More...

Inheritance diagram for SurveyMetricQuestionEvaluation:

Collaboration diagram for SurveyMetricQuestionEvaluation:

Public Member Functions
	getGrid ($a_results, $a_abs=true, $a_perc=true)

	getChart ($a_results)

	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)

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
	)

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

References SurveyQuestionEvaluation\getSkippedValue().

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

Here is the call graph for this function:

◆ getChart()

SurveyMetricQuestionEvaluation::getChart ( $a_results )

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

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

     {
         $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();
         }
     }

Here is the call graph for this function:

◆ getExportGrid()

SurveyMetricQuestionEvaluation::getExportGrid ( $a_results )

Get grid data.

Parameters

ilSurveyEvaluationResults | array $a_results

Returns: array

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

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

     {
         $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;
     }

◆ getGrid()

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

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

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

     {
         $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;
     }

◆ parseResults()

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

protected

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

References $total, and ilSurveyEvaluationResults\setMean().

     {
         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);
         }
     }

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

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ addUserSpecificResults()

◆ getChart()

◆ getExportGrid()

◆ getGrid()

◆ parseResults()