Draws a graph of the aggregated answers for a given question. More...

Static Public Member Functions
static	drawSelectGraph ($question, $resultsManager, $answers)
	Draws an interactive graphical view of answers to one question. More...

static	drawChecklistGraph ($question, $resultsManager, $answers)
	Draws an interactive graphical view of answers to one question. More...

static	drawRatingsGraph ($question, $resultsManager, $answers)
	Draws an interactive graphical view of answers to one question. More...

static	drawSelectResults ($surveyField, $qField, $survey_id, $question_id)
	Deprecated - call drawGraph from question renderer. More...

static	drawChecklistResults ($surveyField, $qField, $survey_id, $question_id)
	Deprecated - call drawGraph from question renderer. More...

static	drawRatingResults ($surveyField, $qField, $survey_id, $question_id)
	Deprecated - call drawGraph from question renderer. More...

Static Public Attributes
static	$surveyManager

Detailed Description

Draws a graph of the aggregated answers for a given question.

Uses either the default SurveyCreateManager class or a custom manager class set in the calling code using the syntax

 QuestionnaireResultsGraph::$surveyManager = MyCustomSurveyManager;

The custom survey manager must contain the following functions in order to use this graphing function:

static function getSurvey($survey_id) static function getQuestion($question_id)

Parameters

String	$surveyField	- name of the field that has relation "Answers" so that it can retrieve an array of answer DataItem objects with field "value" using the constraint $qField=$question_id
String	$qField	- the name of the question_id field (e.g., question_id or survey_question_id
Number	$survey_id	- the key value of the survey or other object that can instantiate the DataItem object that has relation "Answers"
Number	$question_id	- the key value of the questionnaire or survey question that can instantiate the question DataItem object.

Definition at line 68 of file results_graphs.inc.

Member Function Documentation

◆ drawChecklistGraph()

static QuestionnaireResultsGraph::drawChecklistGraph	(	$question,
		$resultsManager,
		$answers
	)

static

Draws an interactive graphical view of answers to one question.

Parameters

obj	$question	- object of class Question, SurveyQuestion or other question DataItem class
obj	$resultsManager	- object of the Survey/Questionnaire Results manager class; this class is currently not being used but may be used in the future to specify customization options for graphing
Array	$answers	- all survey or questionnaire answers to this question

Definition at line 148 of file results_graphs.inc.

      {
           $pk = $question->getPrimaryKey();
           $question_id = $question->$pk;
           $counts = QuestionnaireDataView::getCheckListAnswerCounts($answers);
           
           $datay = array();
           
           $optionAnswers = array();
           $count = array();
           $optionText = QuestionnaireResultsGraph::getOptionText($question->options);
           $steps = count($optionText);
           
           for($idx = 1; $idx <= $steps; ++$idx)
           {
                //echo "idx is $idx<br/>";
                // store for calculating mean and median
                $totalValue += $idx * $counts[$idx];
                $totalCount += $counts[$idx];
                $datay[] = $counts[$idx] ? $counts[$idx] : 0;
                $datax[] = $optionText[$idx];
           }
           
           // Setup the graph.
           $graph = new Histogram(650,300);
           $graph = new Histogram("histogram_$question_id", count($datax) * 80 + 100, 400, 50, 10, count($datax) * 80, 300, "standard");
           $graph->setLabels($datax);
           $graph->ticks = 10;
           $graph->columnMargin = 0.4;
           
           $series = new HistogramSeries("block", "Answers", $datay);
           $graph->addSeries($series);
           $graph->draw();
      }

◆ drawChecklistResults()

static QuestionnaireResultsGraph::drawChecklistResults	(	$surveyField,
		$qField,
		$survey_id,
		$question_id
	)

static

Deprecated - call drawGraph from question renderer.

Parameters

String	$surveyField
String	$qField
Number	$survey_id
Number	$question_id

Definition at line 267 of file results_graphs.inc.

      {
           if (!QuestionnaireResultsGraph::$surveyManager)
           {
                echo "<p><em>Survey Graphs are not available</em></p>";
                return;
           }
           
           $surveyManager = new QuestionnaireResultsGraph::$surveyManager();
           
           $question = $surveyManager->getQuestion($question_id);
           $survey = $surveyManager->getSurvey($survey_id);
                     
           $answers = $survey->Answers("WHERE $qField=$question_id");
           
           QuestionnaireResultsGraph::drawChecklistGraph($question, $surveyManager, $answers);
      }

◆ drawRatingResults()

static QuestionnaireResultsGraph::drawRatingResults	(	$surveyField,
		$qField,
		$survey_id,
		$question_id
	)

static

Deprecated - call drawGraph from question renderer.

Parameters

String	$surveyField
String	$qField
Number	$survey_id
Number	$question_id

Definition at line 294 of file results_graphs.inc.

      {
           if (!QuestionnaireResultsGraph::$surveyManager)
           {
                echo "<p><em>Survey Graphs are not available</em></p>";
                return;
           }
           
           $surveyManager = new QuestionnaireResultsGraph::$surveyManager();
           
           $question = $surveyManager->getQuestion($question_id);
           $survey = $surveyManager->getSurvey($survey_id);
                     
           $answers = $survey->Answers("WHERE $qField=$question_id");
           
           QuestionnaireResultsGraph::drawRatingsGraph($question, $surveyManager, $answers);
           
      }

◆ drawRatingsGraph()

static QuestionnaireResultsGraph::drawRatingsGraph	(	$question,
		$resultsManager,
		$answers
	)

static

Draws an interactive graphical view of answers to one question.

Parameters

obj	$question	- object of class Question, SurveyQuestion or other question DataItem class
obj	$resultsManager	- object of the Survey/Questionnaire Results manager class; this class is currently not being used but may be used in the future to specify customization options for graphing
Array	$answers	- all survey or questionnaire answers to this question

Definition at line 194 of file results_graphs.inc.

      {
           $pk = $question->getPrimaryKey();
           $question_id = $question->$pk;
           $answerValues = regroupList($answers, "value");
           
           $datay = array();
           
           $optionAnswers = array();
           $count = array();
           $optionText = QuestionnaireResultsGraph::getRatingsOptionText($question->options);
           $steps = count($optionText);
           
           for($idx = 1; $idx <= $steps; ++$idx)
           {
                //echo "idx is $idx<br/>";
                // store for calculating mean and median
                $counts[$idx] = count($answerValues[$idx]);
                $totalValue += $idx * $counts[$idx];
                $totalCount += $counts[$idx];
                $datay[] = $counts[$idx];
                $datax[] = $optionText[$idx];
           }
           
           $mean = "Average: ".number_format($totalValue / $totalCount, 1);
           
           // Setup the graph.
           $graph = new Histogram("histogram_$question_id", count($datax) * 80 + 100, 400, 50, 10, count($datax) * 80, 300, "standard");
           $graph->setLabels($datax);
           $graph->ticks = 10;
           $graph->columnMargin = 0.4;
           
           //$graph->setTitle($mean);
           
           $series = new HistogramSeries("block", "Ratings", $datay);
           $graph->addSeries($series);
           $graph->draw();     
      }

◆ drawSelectGraph()

static QuestionnaireResultsGraph::drawSelectGraph	(	$question,
		$resultsManager,
		$answers
	)

static

Draws an interactive graphical view of answers to one question.

Parameters

obj	$question	- object of class Question, SurveyQuestion or other question DataItem class
obj	$resultsManager	- object of the Survey/Questionnaire Results manager class; this class is currently not being used but may be used in the future to specify customization options for graphing
Array	$answers	- all survey or questionnaire answers to this question

Definition at line 83 of file results_graphs.inc.

      {
           $pk = $question->getPrimaryKey();
           $question_id = $question->$pk;
           $options = explode("\n", $question->options);
           $idx = 1;
           $optionAnswers = array();
           $legends = array();
           
           $answerValues = regroupList($answers, "value");
           
           $total = 0;
           foreach($options as $option)
           {
                $count = count($answerValues[$idx]);
  
                $total += $count;
                $idx++;
           }
  
           $idx = 1;
           if(count($options) > 0)
           {                   
                foreach($options as $option)
                {
                     $count = count($answerValues[$idx]);
                     $optionAnswers[] = $count;
                     
                     if ($total > 0)
                     {
                          $percent = number_format(100 * ($count / $total), 1);
                          $legends[] = trim($option) . " ( $percent% )";
                     }
                     else
                     {
                          $legends[] = trim($option);
                     }
                     $idx++;   
                }
           }         
           
  
  
           $pie = new PieChart("results_$question_id", 650, 400, $optionAnswers, $legends, "standard");
           $pie->setRadius(150);
           $pie->setCenter(180,180);
           $pie->setLabelSize(12);
           $pie->setStrokeWidth(2);
           $pie->showLegend(true, 375, 20);
           $pie->shadow = false;
           //$pie->emboss = true;
           $pie->draw();
      }

◆ drawSelectResults()

static QuestionnaireResultsGraph::drawSelectResults	(	$surveyField,
		$qField,
		$survey_id,
		$question_id
	)

static

Deprecated - call drawGraph from question renderer.

Parameters

String	$surveyField
String	$qField
Number	$survey_id
Number	$question_id

Definition at line 241 of file results_graphs.inc.

      {
           if (!QuestionnaireResultsGraph::$surveyManager)
           {
                echo "<p><em>Survey Graphs are not available</em></p>";
                return;
           }
           
           $surveyManager = new QuestionnaireResultsGraph::$surveyManager();
           
           $question = $surveyManager->getQuestion($question_id);
           $survey = $surveyManager->getSurvey($survey_id);
           
           $answers = $survey->Answers("WHERE $qField=$question_id");
  
           QuestionnaireResultsGraph::drawSelectGraph($question, $surveyManager, $answers);
      }

Member Data Documentation

◆ $surveyManager

QuestionnaireResultsGraph::$surveyManager

static

Definition at line 70 of file results_graphs.inc.

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

C:/code/cms.sonjara.com/cms/components/questionnaire/results_graphs.inc

Static Public Member Functions

Static Public Attributes

Detailed Description

Member Function Documentation

◆ drawChecklistGraph()

◆ drawChecklistResults()

◆ drawRatingResults()

◆ drawRatingsGraph()

◆ drawSelectGraph()

◆ drawSelectResults()

Member Data Documentation

◆ $surveyManager