Permalink
Browse files

initial checkin of library and demo source code and dependencies

  • Loading branch information...
hoffmanns committed Mar 28, 2013
1 parent a802d2e commit 1eb6e656033c7a26e8698b9c18e72bfd031eb74e
Showing with 6,469 additions and 4 deletions.
  1. +26 −0 LICENSE
  2. +53 −4 README.md
  3. BIN lib/ieg-common.jar
  4. +59 −0 src/evaluation/evalBench/EvaluationDelegate.java
  5. +358 −0 src/evaluation/evalBench/EvaluationManager.java
  6. +26 −0 src/evaluation/evalBench/EvaluationResources.java
  7. +120 −0 src/evaluation/evalBench/evaluationGui.properties
  8. +122 −0 src/evaluation/evalBench/evaluationGui_de.properties
  9. +232 −0 src/evaluation/evalBench/io/CsvJournal.java
  10. +16 −0 src/evaluation/evalBench/io/CsvJournalFactory.java
  11. +34 −0 src/evaluation/evalBench/io/EvaluationSessionJournal.java
  12. +80 −0 src/evaluation/evalBench/io/JaxbJournal.java
  13. +15 −0 src/evaluation/evalBench/io/JournalFactory.java
  14. +177 −0 src/evaluation/evalBench/io/OutputManager.java
  15. +21 −0 src/evaluation/evalBench/io/TaskListCreator.java
  16. +209 −0 src/evaluation/evalBench/io/XMLInsightJournal.java
  17. +137 −0 src/evaluation/evalBench/io/XMLJournal.java
  18. +17 −0 src/evaluation/evalBench/io/XMLJournalFactory.java
  19. +96 −0 src/evaluation/evalBench/io/XMLTaskListCreator.java
  20. +170 −0 src/evaluation/evalBench/panel/ChoiceSelectionQuestionPanelStrategy.java
  21. +55 −0 src/evaluation/evalBench/panel/DateQuestionPanelStrategy.java
  22. +89 −0 src/evaluation/evalBench/panel/DefaultEvaluationPanelFactory.java
  23. +39 −0 src/evaluation/evalBench/panel/DefaultQuestionPanelStrategy.java
  24. +200 −0 src/evaluation/evalBench/panel/InsightTaskPanelStrategy.java
  25. +141 −0 src/evaluation/evalBench/panel/ItemSelectionQuestionPanelStrategy.java
  26. +102 −0 src/evaluation/evalBench/panel/LikertskalaQuestionPanelStrategy.java
  27. +35 −0 src/evaluation/evalBench/panel/PanelFactory.java
  28. +223 −0 src/evaluation/evalBench/panel/QuantitativeQuestionPanelStrategy.java
  29. +60 −0 src/evaluation/evalBench/panel/QuestionPanelStrategy.java
  30. +193 −0 src/evaluation/evalBench/panel/TaskDialog.java
  31. +268 −0 src/evaluation/evalBench/panel/TaskPanel.java
  32. +92 −0 src/evaluation/evalBench/panel/TextInputQuestionPanelStrategy.java
  33. +70 −0 src/evaluation/evalBench/panel/YesNoQuestionPanelStrategy.java
  34. BIN src/evaluation/evalBench/resources/java-logo.jpg
  35. +273 −0 src/evaluation/evalBench/session/EvaluationSession.java
  36. +85 −0 src/evaluation/evalBench/session/EvaluationSessionGroup.java
  37. +248 −0 src/evaluation/evalBench/task/ChoiceSelectionQuestion.java
  38. +43 −0 src/evaluation/evalBench/task/DateQuestion.java
  39. +33 −0 src/evaluation/evalBench/task/EmptyQuestion.java
  40. +72 −0 src/evaluation/evalBench/task/Insight.java
  41. +102 −0 src/evaluation/evalBench/task/InsightTask.java
  42. +152 −0 src/evaluation/evalBench/task/IntervalSelectionQuestion.java
  43. +60 −0 src/evaluation/evalBench/task/ItemSelectionQuestion.java
  44. +107 −0 src/evaluation/evalBench/task/LikertskalaQuestion.java
  45. +294 −0 src/evaluation/evalBench/task/QuantitativeQuestion.java
  46. +133 −0 src/evaluation/evalBench/task/Question.java
  47. +291 −0 src/evaluation/evalBench/task/Task.java
  48. +24 −0 src/evaluation/evalBench/task/TaskList.java
  49. +96 −0 src/evaluation/evalBench/task/TextInputQuestion.java
  50. +55 −0 src/evaluation/evalBench/task/YesNoQuestion.java
  51. +142 −0 src/evaluation/evalBench/util/DateHelper.java
  52. +7 −0 src/log4j.properties
  53. +61 −0 src_demo/EvalAction.java
  54. +84 −0 src_demo/EvalBenchSample.java
  55. +231 −0 src_demo/EvalBenchSampleFrame.java
  56. +145 −0 xml/demotasks.xml
  57. +196 −0 xml/tasklist.xsd
View
26 LICENSE
@@ -0,0 +1,26 @@
Copyright (c) 2012, XXX
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in
the documentation and/or other materials provided with the
distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
View
57 README.md 100644 → 100755
@@ -1,4 +1,53 @@
EvalBench
=========
EvalBench
EvalBench
================================
EvalBench, an easy-to-use, flexible, and reusable software library written in
Java that reliefs much of the burden of evaluation feature implementation from
visualization developers and makes conducting user studies much easier. It can
be used and integrated with third-party visualization prototypes that need to
be evaluated via loose coupling. Further advantages are better reproducibility
as well as the increased reliability and precision of built-in and automated
evaluation features compared to external methods for measurement. EvalBench
supports both, quantitative and qualitative evaluation methods such as
controlled experiments, interaction logging, questionnaires, usability
inspections, and insight diaries.
EvalBench is licensed under the terms of a BSD 2-clause license, and can be
freely used for both commercial and non-commercial purposes. (see LICENSE)
DEMO
----
The source of a demo application showing the library in use is included.
To start the evaluation, select the "Evaluation" menu in the menu bar and
select "Start evaluation".
STRUCTURE
---------
The library distribution uses the following organization:
+ EvalBench
|-- lib Third-party libraries useful with EvalBench and their licenses
|-- out Output files that arise during an evaluation
|-- src The source code for the EvalBench library
|-- src_demo The source code of demo applications showing the library in use
|-- xml Example task lists and other data files
REQUIREMENTS
------------
EvalBench is written in Java 1.6. To compile the EvalBench code, and to build
and run evaluation systems, you'll need a copy of the Java Development Kit
(JDK) for version 1.6 or greater.
The library depends on the following packages:
- Apache Commons Lang 3 classes (http://commons.apache.org/proper/commons-lang/)
- Apache logging library log4j 1.2 (http://logging.apache.org/log4j/1.2/)
- JCalendar 1.4 by Kai Toedter (http://www.toedter.com/en/jcalendar/)
We also recommended (though by no means is it required) that you use an
Integrated Development Environment such as Eclipse (http://eclipse.org).
Especially if you are a Java novice, it will likely make your life much easier.
View
Binary file not shown.
@@ -0,0 +1,59 @@
package evaluation.evalBench;
import evaluation.evalBench.session.EvaluationSession;
import evaluation.evalBench.session.EvaluationSessionGroup;
import evaluation.evalBench.task.Task;
/**
* The delegate of the evaluation framework must be implemented on the visualization tool side.
* The methods of this interface make it possible to react on different events within an evaluation process.
* These events include the start of an {@link EvaluationSessionGroup}, the start and end of an
* {@link EvaluationSession} and the start and end of a {@link Task} execution.
*
*
*/
public interface EvaluationDelegate {
// TODO shorter method name easier to keep overview??
/**
* This method will be called when an {@link EvaluationSessionGroup} was set in the
* {@link EvaluationManager} to prepare the gui for a distinct {@link EvaluationSessionGroup}
* @param aSessionGroup
*/
public void prepareForEvaluationSessionGroup(EvaluationSessionGroup aSessionGroup);
/**
* This method will be called before an evaluation session will be started to prepare the GUI and
* vis tool for this session
* @param aSession
*/
public void prepareForEvaluationSession(EvaluationSession aSession);
/**
* This method will be called after a session was finished
* @param aSession
*/
public void evaluationSessionDidFinish(EvaluationSession aSession);
/**
* This method will be called if the test person wants to reset the current GUI
* to it's initial state
* @param evaluationSession
*/
public void resetGUIForEvaluationSession(EvaluationSession evaluationSession);
/**
* This method will be called before a task will be started to prepare the GUI and
* vis tool for this task
* @param aTask
*/
public void prepareForEvaluationTask(Task aTask);
/**
* This method will be called after the task was answered.
* @param aTask
*/
public void evaluationTaskWasAnswered(Task aTask);
}
Oops, something went wrong.

0 comments on commit 1eb6e65

Please sign in to comment.