PatioWiki - User contributions [en]

Technical Documentation LogProcessor

2011-10-27T13:27:44Z

Daniel Héctor Stolfi Rosso: Proofreading

In the [[LogProcessor]] module we have implemented the analysis of the [[Log]] of the exercises and the exportation of the results to a [http://es.wikipedia.org/wiki/CSV CSV] file. Besides, you can produce graphs and pattern analyses of some type of exercises.

__TOC__

= Use Case =

In the use case diagram you can see the available actions that you can perform with this module, such as '''Analyse a log''', '''Export analysis to a CSV file''', '''Analyse patterns''' or '''Produce graphs''' using data form [[Log]] files of the exercises.

[[File:Log_UC.png|400px|Case use diagram of the processor of logs]]

= Class Diagram of the Log Reader =

In the class diagram of the log reader you can see the '''AbstractCommonLogGraph''' class which is used to produce graphs ('''CommonLogGraph''') and the pattern analyses ('''CommonLogPattern'''). The diagram also contains the '''AbstractCommonLogProcessor''' class which is used to read logs from the database ('''CommonLogProcessor''') or from a disk file ('''CommonFileLogProcessor''').

[[File:Log_reader_diagram.png|800px|Class diagram of the log reader]]

= Class Diagram of the Log Events =

In the class diagram of the log events you can see the events hierarchy that the program use. As you can see, there is a division between events of the pointing device ('''AbstractPointerEvent''') and the exercise events ('''LogEvent''').

[[File:Log_events_diagram.png|600px|Class diagram of the log events]]

= Class Diagram of the Log Processor =

In the class diagram of the log processor you can see the existing division between the processors of the [[Aprendo]] module exercises ('''AbstractAprendoProcessor''') and the [[Leo]] module exercises ('''AbstractLeoProcessor'''). Note that there is a specific class for processing logs of each type of exercises.

[[File:Log_processor_diagram.png|800px|Class diagram of the log processor]]

= Class Diagram of the Graphs of Logs =

In the class diagram of the log graphs you can see several classes ('''DirectionalGraph''', '''PointsDensityGraph''' and '''AllPointsGraph''') which can be included into the panel containing graphs called '''GraphPanel'''. Note that the '''GraphPanel''' can also be included into the panel of pattern analysis ('''PatternStudyPanel''') which contains two classes; '''PatternList''' and '''PatternUserList'''.

[[File:Log_graph_diagram.png|800px|Class diagram of the graphs of logs]]

= Class Diagram of the Results Exporter =

In the class diagram of the results exporter you can see a division between the classes of the [[Aprendo]] module exercises (they inherit from '''AbstractAprendoExporter''' class) and the [[Leo]] ones (they inherit from '''AbstractLeoExporter''').

[[File:Log_exporter_diagram.png|800px|Class diagram of the results exporter]]

= Class Diagram of the Log Player =

In the class diagram of the log player you can see a division between the classes of the [[Aprendo]] module ('''AbstractAprendoPlayer''') and the [[Leo]] module ones ('''AbstractLeoPlayer'''). There is a specific class for each exercise. These classes implement the proper engine for the player depending on the exercise to be played. Note that the class used for replaying exercise events ('''AbstractExercisePlayer''') and the class for pointing device events ('''MouseEventsGlassPane''') inherit from the '''AbstractPlayerComponent''' class.

[[File:Log_player_diagram.png|600px|Class diagrama of the log player]]

[[Category:LogProcessor]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica LogProcessor]]

Technical Documentation Edito

2011-10-27T13:04:55Z

Daniel Héctor Stolfi Rosso: Proofreading

In the [[Edito]] module we have implemented the management of concepts, multimedia resources, pupils and syllable division.

__TOC__

= Concept Management =

In the use case diagram of concept management you can see the available actions that you can perform on a concept, such as '''Add concept''', '''Modify concept''', '''Delete concept''' and '''Relate concepts'''.

[[File:Edito_concepts_UC.png|350px|Use case diagram of the concepts management]]

In the class diagram of concept management you can see the main classes used for handling concepts. There are panels for concept management ('''ConceptPropertiesPanel'''), concept association management ('''ConceptAssociationPanel''') and relation type management ('''ConceptRelationTypePanel''') included in the main panel ('''ConceptPresenterPanel'''). Furthermore, you can see the '''ConceptImagesPanel''' class which manages the relations between concepts and multimedia resources, as well as the class called '''ConceptTreePanel''' which contains a tree for selecting concepts.

[[File:Edito_concept_diagram.png|800px|Class diagram of the concepts management]]

= Multimedia Resource Management =

In the use case diagram of the multimedia resource management you can see the available actions that you can perform on a multimedia resource, such as '''Add multimedia resource''', '''Modify multimedia resource''', '''Delete multimedia resource''' y '''Add a batch'''. Note that when you add or modify a multimedia resource you can also '''associate it with a concept'''.

[[File:Edito_multimedia_resources_UC.png|600px|Use case diagram of the multimedia resources management]]

In the class diagram of multimedia resource management you can see the main classes used for handling multimedia resources. Note that tabs for editing resources ('''MultimediaEditionPanel'''), addition of resources ('''MultimediaAdditionPanel''') and addition of batches of resources ('''MultimediaBatchAdditionPanel''') are located in the main tab panel ('''MultimediaTabbedPane'''). Furthermore, you can see the class '''MultimediaTreePanel''' which contains a tree for selecting multimedia resources.

[[File:Edito_multimedia_resource_diagram.png|800px|Class diagram of the multimedia resources management]]

In the next diagram you can see classes of the available data types which can be used to insert multimedia resources into the multimedia resources tree.

[[File:Edito_multimedia_Item_diagram.png|600px|Class diagram of the multimedia items management]]

= Pupil management =

In the use case diagram of the pupil management you can see the available action that you can perform on a pupil's record, such as '''Add pupil''', '''Modify pupil''', '''Delete pupil''' (provided that she has not been included in [[Sessions]] or [[Log]]s) and '''Change of group'''.

[[File:Edito_students_UC.png|600px|Use case diagram of the students management]]

In the class diagram of pupil management you can see the main classes used for handling pupils. Note that the diagram includes a panel for editing pupils ('''StudentEditionPanel'''), a panel for the pupils tree ('''StudentsTreeEditionPanel''') and a panel that contains the data of the pupil that is being edited ('''StudentsPropertiesPanel'''). Furthermore, you can see the class hierarchy for the types of nodes which can be included in the pupils tree. Each node can be an instance of '''SchoolTreeItem''' class (for schools), '''GroupTreeItem''' class (for groups) or '''StudentTreeItem''' class (for pupils).

[[File:Edito_student_diagram.png|800px|Class diagram of the students management]]

= Syllable division management =

In the use case diagram of division management you can see the available action that you can perform on syllable division, such as '''Add syllable division''' or '''Delete syllable division'''.

[[File:Edito_syllables_UC.png|350px|Use case diagram of the syllables management]]

In the class diagram of syllable division management you can see the main classes used for handling syllable divisions. Note that there is a panel for editing called '''SyllableEditionPanel''', another one for including the concept tree ('''SyllableTreeEditionPanel'''), and also one for the syllable divisions; '''SyllablePropertiesPanel'''. You can also see the classes called '''LeoLetterSyllableTreeItem''' and '''LeoWordSyllableTreeItem''', which are both children of the '''AbstractSyllableTreeItem''' class.

[[File:Edito_syllable_diagram.png|800px|Class diagram of the syllables management]]

[[Category:Edito]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica Edito]]

Log Selection Tab

2011-10-27T09:58:13Z

Daniel Héctor Stolfi Rosso:

[[File:Log_logs_selection_en.png|right|thumb|550px|Log Selection Tab]]

The [[Log Selection Tab]], part of the [[LogProcessor]] application, is divided into a top panel and a central zone. The first contains several buttons for executing the application's processes and [[Configuration Panel|configuring]] its parameters. The latter contains a filter panel for selecting a set of [[Log]]s to work with.

__TOC__

= Filters =

To select the logs to be analysed, you can use several filters which depend on each other. The right order to filter Logs is from left to right, in other words, starting with [[Session|Sessions]] and ending with [[Log]]s.

Note that you can select a number of items from all filters, using '''Control''' ('''Command''' in Mac) plus left-click to select them individually or using '''Shift''' plus left-click to select a consecutive range of items. Also, you can use the '''Select all''' button, placed into each filter, to select all the filter items easily.

The available filters are:

; Sessions
: You can select the [[Session|Sessions]] of the tests pupils have done or the special item called [['''-- No session --''']] which filters all the logs from [[:Category:Exercises|Exercises]] not included in any session.

; Pupils
: This filter shows the list of the [[Pupil]]s which have done exercises in the sessions you have selected in the previous filter.

; Exercises
: This filter allows you to choose the [[category:Exercise|Exercise]]s done by the previously selected pupils and sessions.

; Logs
: Finally, this filter shows the [[Log]]s belonging to all the previous filters. Selecting at least one of them allows you to execute the analyses available in the top panel of this tab.

= Operations =

When the filters have been applied and the logs have been selected, you will have to choose one process option from the available ones.

== Analyse ==

This process starts the analysis of the selected logs. Depending on the [[:Category:Applications|Application]] and the type of [[:Category:Exercises|Exercise]], the analysis will obtain different information from the logs. Usually it will includes answering times, number of hits and fails, etc. The results will be shown in the [[Results Tab]].

== Preview export ==

The analysis results can be exported in [http://en.wikipedia.org/wiki/Comma-separated_values CSV] format in order to be processed by external programs. This operation can be done pressing the '''Preview Export''' button or from the [[Export Data Tab]].

== Graphs ==

For exercises of the [[Diferencias Exercise|Diferencias]] and [[Objetos Escena Exercise|Objetos Escena]] types, you can do a graphical analysis of a pupil's clicks and point density, comparing several logs for the same type of exercise. In this way you can detect where pupils concentrate their searches. You launch this analysis by pressing the '''Graph''' button; the results are shown in the [[Results Tab]].

== Patterns ==

In the same way, exercises of the [[Diferencias Exercise|Diferencias]] and [[Objetos Escena Exercise|Objetos Escena]] types can be analysed at click level. The pattern analysis is made by dividing the background picture into a grid and assigning a symbol to each cell. So, each click inside a cell will add a new symbol to the pattern. You can execute this analysis by pressing on the '''Pattern''' button; the results are shown in the [[Results Tab]].

= Load from file =

You can also read log files from the disc in order to analyse them without using the database. To do that, you have to press the '''Load from file''' button and select the desired files in the dialogue which will appear on the screen.

[[Category:LogProcessor]]
[[es: Pestaña_Selección_de_Logs]]

LogProcessor

2011-10-27T09:56:24Z

Daniel Héctor Stolfi Rosso:

[[LogProcessor]] is a tool which belongs to the [http://patio.lcc.uma.es/patio/index.php?lang=en PATIO project]. It is used to analyse the results of the exercises of the [[Aprendo]] and [[Leo]] modules.

[[LogProcessor]] has three main tabs:

* [[Log Selection Tab]]
* [[Results Tab]]
* [[Export Data Tab]]

Note that in the same way as in the other applications of the project, in order to make proper use of [[LogProcessor]], you will have to check the current configuration in the [[Configuration Panel]].

You can also check the [[Technical Documentation LogProcessor|Technical Documentation]] of the [[LogProcessor]] module.

[[File:Log_feature_schema_en.png|left|thumb|800px|LogProcessor's feature schema]]

[[Category:Aplicaciones]]
[[Category:LogProcessor]]
[[es: LogProcessor]]

Technical Documentation LogProcessor

2011-10-27T09:49:20Z

Daniel Héctor Stolfi Rosso: /* Class Diagram of the Log Player */

In the [[LogProcessor]] module we have implemented the analysis of the [[Log]] of the exercises and the exportation of the produced results to a [http://es.wikipedia.org/wiki/CSV CSV] file. Besides, you can produce graphs and pattern analyses of some type of exercises.

__TOC__

= Use Case =

In the use case diagram you can visualize the available actions that you can perform with this module, such as '''Analyse a log''', '''Export analysis to a CSV file''', '''Analyse patterns''' or '''Produce graphs''' using data form [[Log]] files of the exercises.

[[File:Log_UC.png|400px|Case use diagram of the processor of logs]]

= Class Diagram of the Log Reader =

In the class diagram of the log reader you can visualize the '''AbstractCommonLogGraph''' class which is used to produce graphs ('''CommonLogGraph''') and the pattern analyses ('''CommonLogPattern'''). The diagram also contains the '''AbstractCommonLogProcessor''' class which is used to read logs from the database ('''CommonLogProcessor''') or from a disk file ('''CommonFileLogProcessor''').

[[File:Log_reader_diagram.png|800px|Class diagram of the log reader]]

= Class Diagram of the Log Events =

In the class diagram of the log events you can visualize the events hierarchy that the program use. As you can see, there is a division between events of the pointing device ('''AbstractPointerEvent''') and the exercise events ('''LogEvent''').

[[File:Log_events_diagram.png|600px|Class diagram of the log events]]

= Class Diagram of the Log Processor =

In the class diagram of the log processor you can visualize the existing division between the processors of the exercises of the [[Aprendo]] module ('''AbstractAprendoProcessor''') and the exercises of the [[Leo]] module ('''AbstractLeoProcessor'''). Note that, there is a specific class for processing logs of each type of exercise.

[[File:Log_processor_diagram.png|800px|Class diagram of the log processor]]

= Class Diagram of the Graphs of Logs =

In the class diagram of the graphs of logs you can visualize several classes ('''DirectionalGraph''', '''PointsDensityGraph''' y '''AllPointsGraph''') which can be included into the container panel of graphs called '''GraphPanel'''. Note that the panel of graphs can also be included into the panel of pattern analysis ('''PatternStudyPanel''') which contains the pattern lists '''PatternList''' and the pattern list by user '''PatternUserList''' too.

[[File:Log_graph_diagram.png|800px|Class diagram of the graphs of logs]]

= Class Diagram of the Results Exporter =

In the class diagram of the results exporter you can visualize a division between the classes of the exercises of the [[Aprendo]] module (They inherit from '''AbstractAprendoExporter''') and the [[Leo]] ones (They inherit from '''AbstractLeoExporter''').

[[File:Log_exporter_diagram.png|800px|Class diagram of the results exporter]]

= Class Diagram of the Log Player =

In the class diagram of the log player you can visualize a division between the classes of the exercises of the [[Aprendo]] module ('''AbstractAprendoPlayer''') and the [[Leo]] module ones ('''AbstractLeoPlayer'''). There are a specific class for each exercise. These classes implement the proper engine for the player depending of the exercise to be played. Note that the class used for replaying exercise events ('''AbstractExercisePlayer''') and for pointing device events ('''MouseEventsGlassPane''') inherit from the class '''AbstractPlayerComponent'''.

[[File:Log_player_diagram.png|600px|Class diagrama of the log player]]

[[Category:LogProcessor]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica LogProcessor]]

Technical Documentation LogProcessor

2011-10-27T09:43:03Z

Daniel Héctor Stolfi Rosso: /* Class Diagram of the Graphs of Logs */

In the [[LogProcessor]] module we have implemented the analysis of the [[Log]] of the exercises and the exportation of the produced results to a [http://es.wikipedia.org/wiki/CSV CSV] file. Besides, you can produce graphs and pattern analyses of some type of exercises.

__TOC__

= Use Case =

In the use case diagram you can visualize the available actions that you can perform with this module, such as '''Analyse a log''', '''Export analysis to a CSV file''', '''Analyse patterns''' or '''Produce graphs''' using data form [[Log]] files of the exercises.

[[File:Log_UC.png|400px|Case use diagram of the processor of logs]]

= Class Diagram of the Log Reader =

In the class diagram of the log reader you can visualize the '''AbstractCommonLogGraph''' class which is used to produce graphs ('''CommonLogGraph''') and the pattern analyses ('''CommonLogPattern'''). The diagram also contains the '''AbstractCommonLogProcessor''' class which is used to read logs from the database ('''CommonLogProcessor''') or from a disk file ('''CommonFileLogProcessor''').

[[File:Log_reader_diagram.png|800px|Class diagram of the log reader]]

= Class Diagram of the Log Events =

In the class diagram of the log events you can visualize the events hierarchy that the program use. As you can see, there is a division between events of the pointing device ('''AbstractPointerEvent''') and the exercise events ('''LogEvent''').

[[File:Log_events_diagram.png|600px|Class diagram of the log events]]

= Class Diagram of the Log Processor =

In the class diagram of the log processor you can visualize the existing division between the processors of the exercises of the [[Aprendo]] module ('''AbstractAprendoProcessor''') and the exercises of the [[Leo]] module ('''AbstractLeoProcessor'''). Note that, there is a specific class for processing logs of each type of exercise.

[[File:Log_processor_diagram.png|800px|Class diagram of the log processor]]

= Class Diagram of the Graphs of Logs =

In the class diagram of the graphs of logs you can visualize several classes ('''DirectionalGraph''', '''PointsDensityGraph''' y '''AllPointsGraph''') which can be included into the container panel of graphs called '''GraphPanel'''. Note that the panel of graphs can also be included into the panel of pattern analysis ('''PatternStudyPanel''') which contains the pattern lists '''PatternList''' and the pattern list by user '''PatternUserList''' too.

[[File:Log_graph_diagram.png|800px|Class diagram of the graphs of logs]]

= Class Diagram of the Results Exporter =

In the class diagram of the results exporter you can visualize a division between the classes of the exercises of the [[Aprendo]] module (They inherit from '''AbstractAprendoExporter''') and the [[Leo]] ones (They inherit from '''AbstractLeoExporter''').

[[File:Log_exporter_diagram.png|800px|Class diagram of the results exporter]]

= Class Diagram of the Log Player =

In the class diagram of the log player you can visualize a division between the classes of the exercises of the [[Aprendo]] ('''AbstractAprendoPlayer''') and the [[Leo]] ones ('''AbstractLeoPlayer'''). Then, each exercise has got a specific class that implements the proper engine for the player. Note that the class used for replaying exercise events ('''AbstractExercisePlayer''') and for pointing device events ('''MouseEventsGlassPane''') inherit from the class '''AbstractPlayerComponent'''.

[[File:Log_player_diagram.png|600px|Class diagrama of the log player]]

[[Category:LogProcessor]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica LogProcessor]]

Technical Documentation LogProcessor

2011-10-27T09:39:30Z

Daniel Héctor Stolfi Rosso: /* Class Diagram of the Log Events */

In the [[LogProcessor]] module we have implemented the analysis of the [[Log]] of the exercises and the exportation of the produced results to a [http://es.wikipedia.org/wiki/CSV CSV] file. Besides, you can produce graphs and pattern analyses of some type of exercises.

__TOC__

= Use Case =

In the use case diagram you can visualize the available actions that you can perform with this module, such as '''Analyse a log''', '''Export analysis to a CSV file''', '''Analyse patterns''' or '''Produce graphs''' using data form [[Log]] files of the exercises.

[[File:Log_UC.png|400px|Case use diagram of the processor of logs]]

= Class Diagram of the Log Reader =

In the class diagram of the log reader you can visualize the '''AbstractCommonLogGraph''' class which is used to produce graphs ('''CommonLogGraph''') and the pattern analyses ('''CommonLogPattern'''). The diagram also contains the '''AbstractCommonLogProcessor''' class which is used to read logs from the database ('''CommonLogProcessor''') or from a disk file ('''CommonFileLogProcessor''').

[[File:Log_reader_diagram.png|800px|Class diagram of the log reader]]

= Class Diagram of the Log Events =

In the class diagram of the log events you can visualize the events hierarchy that the program use. As you can see, there is a division between events of the pointing device ('''AbstractPointerEvent''') and the exercise events ('''LogEvent''').

[[File:Log_events_diagram.png|600px|Class diagram of the log events]]

= Class Diagram of the Log Processor =

In the class diagram of the log processor you can visualize the existing division between the processors of the exercises of the [[Aprendo]] module ('''AbstractAprendoProcessor''') and the exercises of the [[Leo]] module ('''AbstractLeoProcessor'''). Note that, there is a specific class for processing logs of each type of exercise.

[[File:Log_processor_diagram.png|800px|Class diagram of the log processor]]

= Class Diagram of the Graphs of Logs =

In the class diagram of the graphs of logs you can visualize several classes ('''DirectionalGraph''', '''PointsDensityGraph''' y '''AllPointsGraph''') which can be included into the container panel of graphs '''GraphPanel'''. Note that the panel of graphs can also be included into the panel of pattern analysis ('''PatternStudyPanel''') which contains the pattern lists ('''PatternList''') and ('''PatternUserList''') too.

[[File:Log_graph_diagram.png|800px|Class diagram of the graphs of logs]]

= Class Diagram of the Results Exporter =

In the class diagram of the results exporter you can visualize a division between the classes of the exercises of the [[Aprendo]] module (They inherit from '''AbstractAprendoExporter''') and the [[Leo]] ones (They inherit from '''AbstractLeoExporter''').

[[File:Log_exporter_diagram.png|800px|Class diagram of the results exporter]]

= Class Diagram of the Log Player =

In the class diagram of the log player you can visualize a division between the classes of the exercises of the [[Aprendo]] ('''AbstractAprendoPlayer''') and the [[Leo]] ones ('''AbstractLeoPlayer'''). Then, each exercise has got a specific class that implements the proper engine for the player. Note that the class used for replaying exercise events ('''AbstractExercisePlayer''') and for pointing device events ('''MouseEventsGlassPane''') inherit from the class '''AbstractPlayerComponent'''.

[[File:Log_player_diagram.png|600px|Class diagrama of the log player]]

[[Category:LogProcessor]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica LogProcessor]]

Technical Documentation LogProcessor

2011-10-27T09:38:34Z

Daniel Héctor Stolfi Rosso: /* Use Case */

In the [[LogProcessor]] module we have implemented the analysis of the [[Log]] of the exercises and the exportation of the produced results to a [http://es.wikipedia.org/wiki/CSV CSV] file. Besides, you can produce graphs and pattern analyses of some type of exercises.

__TOC__

= Use Case =

In the use case diagram you can visualize the available actions that you can perform with this module, such as '''Analyse a log''', '''Export analysis to a CSV file''', '''Analyse patterns''' or '''Produce graphs''' using data form [[Log]] files of the exercises.

[[File:Log_UC.png|400px|Case use diagram of the processor of logs]]

= Class Diagram of the Log Reader =

In the class diagram of the log reader you can visualize the '''AbstractCommonLogGraph''' class which is used to produce graphs ('''CommonLogGraph''') and the pattern analyses ('''CommonLogPattern'''). The diagram also contains the '''AbstractCommonLogProcessor''' class which is used to read logs from the database ('''CommonLogProcessor''') or from a disk file ('''CommonFileLogProcessor''').

[[File:Log_reader_diagram.png|800px|Class diagram of the log reader]]

= Class Diagram of the Log Events =

In the class diagram of the log events you can visualize the events hierarchy that the program use. As you can see, there is a division between events of the pointing device ('''AbstractPointerEvent''') and exercise events ('''LogEvent''').

[[File:Log_events_diagram.png|600px|Class diagram of the log events]]

= Class Diagram of the Log Processor =

In the class diagram of the log processor you can visualize the existing division between the processors of the exercises of the [[Aprendo]] module ('''AbstractAprendoProcessor''') and the exercises of the [[Leo]] module ('''AbstractLeoProcessor'''). Note that, there is a specific class for processing logs of each type of exercise.

[[File:Log_processor_diagram.png|800px|Class diagram of the log processor]]

= Class Diagram of the Graphs of Logs =

In the class diagram of the graphs of logs you can visualize several classes ('''DirectionalGraph''', '''PointsDensityGraph''' y '''AllPointsGraph''') which can be included into the container panel of graphs '''GraphPanel'''. Note that the panel of graphs can also be included into the panel of pattern analysis ('''PatternStudyPanel''') which contains the pattern lists ('''PatternList''') and ('''PatternUserList''') too.

[[File:Log_graph_diagram.png|800px|Class diagram of the graphs of logs]]

= Class Diagram of the Results Exporter =

In the class diagram of the results exporter you can visualize a division between the classes of the exercises of the [[Aprendo]] module (They inherit from '''AbstractAprendoExporter''') and the [[Leo]] ones (They inherit from '''AbstractLeoExporter''').

[[File:Log_exporter_diagram.png|800px|Class diagram of the results exporter]]

= Class Diagram of the Log Player =

In the class diagram of the log player you can visualize a division between the classes of the exercises of the [[Aprendo]] ('''AbstractAprendoPlayer''') and the [[Leo]] ones ('''AbstractLeoPlayer'''). Then, each exercise has got a specific class that implements the proper engine for the player. Note that the class used for replaying exercise events ('''AbstractExercisePlayer''') and for pointing device events ('''MouseEventsGlassPane''') inherit from the class '''AbstractPlayerComponent'''.

[[File:Log_player_diagram.png|600px|Class diagrama of the log player]]

[[Category:LogProcessor]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica LogProcessor]]

Technical Documentation Edito

2011-10-27T09:32:22Z

Daniel Héctor Stolfi Rosso:

In the [[Edito]] module we have implemented the management of concepts, multimedia resources, pupils and syllable division.

__TOC__

= Concept Management =

In the use case diagram of the concept management you can visualize the available actions that you can perform on a concept, such as '''Add concept''', '''Modify concept''', '''Delete concept''' and '''Relate concepts'''.

[[File:Edito_concepts_UC.png|350px|Use case diagram of the concepts management]]

In the class diagram of the concept management you can visualize the main classes used for handling concepts. There are panels for concept management ('''ConceptPropertiesPanel'''), concept association management ('''ConceptAssociationPanel''') and relation type management ('''ConceptRelationTypePanel''') included into the main panel ('''ConceptPresenterPanel'''). Furthermore, you can visualize the class '''ConceptImagesPanel''' which manages the relations between concepts and multimedia resources, as well as the class '''ConceptTreePanel''' which contains the tree for selecting concepts.

[[File:Edito_concept_diagram.png|800px|Class diagram of the concepts management]]

= Multimedia Resource Management =

In the use case diagram of the multimedia resource management you can visualize the available action that you can perform on a multimedia resource, such as '''Add multimedia resource''', '''Modify multimedia resource''', '''Delete multimedia resource''' y '''Add a batch'''. Note that when you add or modify a multimedia resource you can also '''Associate it with a concept'''.

[[File:Edito_multimedia_resources_UC.png|600px|Use case diagram of the multimedia resources management]]

In the class diagram of the multimedia resource management you can visualize the main classes used for handling multimedia resources. Note that tabs for editing resources ('''MultimediaEditionPanel'''), addition of resources ('''MultimediaAdditionPanel''') and addition of batches of resources ('''MultimediaBatchAdditionPanel''') are included into the main tab panel ('''MultimediaTabbedPane'''). Furthermore, you can visualize the class '''MultimediaTreePanel''' which is used to contain the tree for selecting multimedia resources.

[[File:Edito_multimedia_resource_diagram.png|800px|Class diagram of the multimedia resources management]]

In the next diagram you can visualize the classes of the available data types which can be used to insert multimedia resources into the multimedia resources tree.

[[File:Edito_multimedia_Item_diagram.png|600px|Class diagram of the multimedia items management]]

= Pupil management =

In the use case diagram of the pupil management you can visualize the available action that you can perform on a pupil's record, such as '''Add pupil''', '''Modify pupil''', '''Delete pupil''' (provided that she has not been included in [[Sessions]] or [[Log]]s) and '''Change of group'''.

[[File:Edito_students_UC.png|600px|Use case diagram of the students management]]

In the class diagram of the pupil management you can visualize the main classes used for handling pupils. Note that the diagram includes the panel for editing pupils ('''StudentEditionPanel'''), the panel for the pupil's tree ('''StudentsTreeEditionPanel''') and the panel that contains the data of the pupil is being edited ('''StudentsPropertiesPanel'''). Furthermore, you can visualize the class hierarchy for the types of nodes which can be included into the pupils tree. Each node can be an instance of '''SchoolTreeItem''' if it is for a school, '''GroupTreeItem''' for a group or '''StudentTreeItem''' for a pupil.

[[File:Edito_student_diagram.png|800px|Class diagram of the students management]]

= Syllable division management =

In the use case diagram of the division management you can visualize the available action that you can perform on a syllable division, such as '''Add syllable division''' or '''Delete syllable division'''.

[[File:Edito_syllables_UC.png|350px|Use case diagram of the syllables management]]

In the class diagram of the syllable division management you can visualize the main classes used for handling syllable divisions. Note that there are a panel for editing '''SyllableEditionPanel''', another for including the concept tree '''SyllableTreeEditionPanel''' and another for the syllable divisions '''SyllablePropertiesPanel'''. You can also visualize the classes '''LeoLetterSyllableTreeItem''' and '''LeoWordSyllableTreeItem''' which are both children of the '''AbstractSyllableTreeItem class.

[[File:Edito_syllable_diagram.png|800px|Class diagram of the syllables management]]

[[Category:Edito]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica Edito]]

Technical Documentation Edito

2011-10-27T09:17:26Z

Daniel Héctor Stolfi Rosso:

In the [[Edito]] module we have implemented the management of concepts, multimedia resources, pupils and syllable division.

__TOC__

= Concept Management =

In the use case diagram of the concept management you can visualize the available actions that you can perform on a concept, such as '''Add concept''', '''Modify concept''', '''Delete concept''' and '''Relate concepts'''.

[[File:Edito_concepts_UC.png|350px|Use case diagram of the concepts management]]

In the class diagram of the concept management you can visualize the main classes used for handling concepts. There are panels for concept management ('''ConceptPropertiesPanel'''), concept association management ('''ConceptAssociationPanel''') and relation type management ('''ConceptRelationTypePanel''') included into the main panel ('''ConceptPresenterPanel'''). Furthermore, you can visualize the class '''ConceptImagesPanel''' which manages the relations between concepts and multimedia resources, as well as the class '''ConceptTreePanel''' which contains the tree for selecting concepts.

[[File:Edito_concept_diagram.png|800px|Class diagram of the concepts management]]

= Multimedia Resource Management =

In the use case diagram of the multimedia resource management you can visualize the available action that you can perform on a multimedia resource, such as '''Add multimedia resource''', '''Modify multimedia resource''', '''Delete multimedia resource''' y '''Add a batch'''. Note that when you add or modify a multimedia resource you can also '''Associate it with a concept'''.

[[File:Edito_multimedia_resources_UC.png|600px|Use case diagram of the multimedia resources management]]

In the class diagram of the multimedia resource management you can visualize the main classes used for handling multimedia resources. Note that tabs for editing resources ('''MultimediaEditionPanel'''), addition of resources ('''MultimediaAdditionPanel''') and addition of batches of resources ('''MultimediaBatchAdditionPanel''') are included into the main tab panel ('''MultimediaTabbedPane'''). Furthermore, you can visualize the class '''MultimediaTreePanel''' which is used to contain the tree for selecting multimedia resources.

[[File:Edito_multimedia_resource_diagram.png|800px|Class diagram of the multimedia resources management]]

In the next diagram you can visualize the classes of the available data types which can be used to insert multimedia resources into the multimedia resources tree.

[[File:Edito_multimedia_Item_diagram.png|600px|Class diagram of the multimedia items management]]

= Pupil management =

In the use case diagram of the pupil management you can visualize the available action that you can perform on a pupil's record, such as '''Add pupil''', '''Modify pupil''', '''Delete pupil''' (provided that she has not been included in [[Sessions]] or [[Log]]s) and '''Change of group'''.

[[File:Edito_students_UC.png|600px|Use case diagram of the students management]]

In the class diagram of the pupil management you can visualize the main classes used for handling pupils. Note that the diagram includes the panel for editing pupils ('''StudentEditionPanel'''), the panel for the pupil's tree ('''StudentsTreeEditionPanel''') and the panel that contains the data of the pupil is being edited ('''StudentsPropertiesPanel'''). Furthermore, you can visualize the class hierarchy for the types of nodes which can be included into the pupils tree. Each node can be an instance of '''SchoolTreeItem''' if it is for a school, '''GroupTreeItem''' for a group or '''StudentTreeItem''' for a pupil.

[[File:Edito_student_diagram.png|800px|Class diagram of the students management]]

= Syllable division management =

En el diagrama de casos de uso para la gestión de las separaciones en sílabas se observan las operaciones disponibles que se pueden realizar, tales como '''Añadir Separación en Sílabas''' o '''Eliminar Separación en Sílabas'''.

[[File:Edito_syllables_UC.png|350px|Use case diagram of the syllables management]]

En el diagrama de clases de la gestión de las separaciones en sílabas se visualizan las clases principales involucradas en la gestión de las separaciones en sílabas. Nótese la inclusión del panel de edición '''SyllableEditionPanel''', el panel destinado al árbol de conceptos '''SyllableTreeEditionPanel''' y el panel contenedor de las separaciones en sílabas '''SyllablePropertiesPanel'''. También se han incluido las clases para los items para el árbol siendo '''LeoLetterSyllableTreeItem''' y '''LeoWordSyllableTreeItem''' los nodos que heredan de la clase '''AbstractSyllableTreeItem.

[[File:Edito_syllable_diagram.png|800px|Class diagram of the syllables management]]

[[Category:Edito]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica Edito]]

Technical Documentation Edito

2011-10-27T08:16:16Z

Daniel Héctor Stolfi Rosso:

In the [[Edito]] module we have implemented the management of concepts, multimedia resources, pupils and syllable division.

__TOC__

= Concept Management =

In the use case diagram of the concept management you can visualize the available actions that you can perform on a concept, such as '''Add concept''', '''Modify concept''', '''Delete concept''' and '''Relate concepts'''.

[[File:Edito_concepts_UC.png|350px|Use case diagram of the concepts management]]

In the class diagram of the concept management you can visualize the main classes used for the concept management. There are panels for concept management ('''ConceptPropertiesPanel'''), concept association management ('''ConceptAssociationPanel''') and relation type management ('''ConceptRelationTypePanel''') included into the main panel ('''ConceptPresenterPanel'''). Furthermore, you can visualize the class '''ConceptImagesPanel''' which manages the relations between concepts and multimedia resources, as well as the class '''ConceptTreePanel''' which contains the tree for selecting concepts.

[[File:Edito_concept_diagram.png|800px|Class diagram of the concepts management]]

= Multimedia Resource Management =

In the use case diagram of the multimedia resource management you can visualize the available action that you can perform on a multimedia resource, such as '''Add multimedia resource''', '''Modify multimedia resource''', '''Delete multimedia resource''' y '''Add a batch'''. Note that when you add or modify a multimedia resource you can also '''Associate it with a concept'''.

[[File:Edito_multimedia_resources_UC.png|600px|Use case diagram of the multimedia resources management]]

In the class diagram of the multimedia resource management you can visualize the main classes used for the multimedia resource management. Note that tabs for editing resources ('''MultimediaEditionPanel'''), addition of resources ('''MultimediaAdditionPanel''') and addition of batches of resources ('''MultimediaBatchAdditionPanel''') are included into the main tab panel ('''MultimediaTabbedPane'''). Furthermore, you can visualize the class '''MultimediaTreePanel''' which is used to contain the tree for selecting multimedia resources.

[[File:Edito_multimedia_resource_diagram.png|800px|Class diagram of the multimedia resources management]]

En el siguiente diagrama se visualizan las clases representando los posibles tipos de datos que pueden ser incluidos dentro del árbol de recursos multimedia.

[[File:Edito_multimedia_Item_diagram.png|600px|Class diagram of the multimedia items management]]

= Gestión de alumnos =

En el diagrama de casos de uso para la gestión de alumnos se observan las operaciones disponibles que se pueden realizar sobre el registro de un alumno, siendo posible '''Añadir''', '''Modificar''', '''Eliminar''' (siempre que no tenga [[Sesiones]] o [[Log]]s) y '''Cambiar de Grupo'''.

[[File:Edito_students_UC.png|600px|Use case diagram of the students management]]

En el diagrama de clases de la gestión de alumnos se visualizan las clases principales involucradas en la gestión de los alumnos. Nótese la inclusión del panel de edición '''StudentEditionPanel''', el panel destinado al árbol de alumnos '''StudentsTreeEditionPanel''' y el panel contenedor de los datos que forman el registro de cada alumno ('''StudentsPropertiesPanel'''). Por otro lado, se ha incluido también la jerarquía de clases para los items a representar dentro del árbol de alumnos. Cada item podrá ser una instancia de '''SchoolTreeItem''' para las escuelas, '''GroupTreeItem''' para los grupos o '''StudentTreeItem''' para los alumnos.

[[File:Edito_student_diagram.png|800px|Class diagram of the students management]]

= Gestión de separaciones en sílabas =

En el diagrama de casos de uso para la gestión de las separaciones en sílabas se observan las operaciones disponibles que se pueden realizar, tales como '''Añadir Separación en Sílabas''' o '''Eliminar Separación en Sílabas'''.

[[File:Edito_syllables_UC.png|350px|Use case diagram of the syllables management]]

En el diagrama de clases de la gestión de las separaciones en sílabas se visualizan las clases principales involucradas en la gestión de las separaciones en sílabas. Nótese la inclusión del panel de edición '''SyllableEditionPanel''', el panel destinado al árbol de conceptos '''SyllableTreeEditionPanel''' y el panel contenedor de las separaciones en sílabas '''SyllablePropertiesPanel'''. También se han incluido las clases para los items para el árbol siendo '''LeoLetterSyllableTreeItem''' y '''LeoWordSyllableTreeItem''' los nodos que heredan de la clase '''AbstractSyllableTreeItem.

[[File:Edito_syllable_diagram.png|800px|Class diagram of the syllables management]]

[[Category:Edito]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica Edito]]

Technical Documentation Edito

2011-10-26T18:11:55Z

Daniel Héctor Stolfi Rosso: Created page with 'En el módulo Edito se ha implementado la gestión de conceptos, recursos multimedia, alumnos y separaciones en sílabas. __TOC__ = Gestión de conceptos = En el diagrama …'

En el módulo [[Edito]] se ha implementado la gestión de conceptos, recursos multimedia, alumnos y separaciones en sílabas.

__TOC__

= Gestión de conceptos =

En el diagrama de casos de uso para la gestión de conceptos se observan las operaciones disponibles que se pueden realizar sobre un concepto, siendo posible '''Añadir''', '''Modificar''', '''Eliminar''' y '''Relacionar Conceptos'''.

[[File:Edito_concepts_UC.png|350px|Use case diagram of the concepts management]]

En el diagrama de clases de la gestión de conceptos se visualizan las clases principales involucradas en la gestión de conceptos. Nótese la inclusión de los paneles de gestión de conceptos ('''ConceptPropertiesPanel'''), asociaciones entre conceptos ('''ConceptAssociationPanel''') y tipos relaciones ('''ConceptRelationTypePanel''') dentro del panel principal ('''ConceptPresenterPanel'''). Por otro parte, para la gestionar relación entre conceptos y recursos multimedia se utilizará la clase '''ConceptImagesPanel''' y para contener el árbol de selección de conceptos, la clase '''ConceptTreePanel'''.

[[File:Edito_concept_diagram.png|800px|Class diagram of the concepts management]]

= Gestión de recursos multimedia =

En el diagrama de casos de uso para la gestión de recursos multimedia se observan las operaciones disponibles que se pueden realizar sobre un recurso multimedia, siendo posible '''Añadir''', '''Modificar''', '''Eliminar''' y '''Añadir en Lotes'''. Nótese que al añadir o modificar un recurso se puede también '''Asociarlo con un Concepto'''.

[[File:Edito_multimedia_resources_UC.png|600px|Use case diagram of the multimedia resources management]]

En el diagrama de clases de la gestión de recursos multimedia se visualizan las clases principales involucradas en la gestión de los recursos multimedia. Nótese la inclusión de las pestañas de edición de los recursos multimedia ('''MultimediaEditionPanel'''), adición de nuevos recursos ('''MultimediaAdditionPanel''') y adición de recursos por lotes ('''MultimediaBatchAdditionPanel''') dentro del panel de pestañas principal ('''MultimediaTabbedPane'''). Por otra parte, para contener el árbol de selección de recursos multimedia se contará con la clase '''MultimediaTreePanel'''.

[[File:Edito_multimedia_resource_diagram.png|800px|Class diagram of the multimedia resources management]]

En el siguiente diagrama se visualizan las clases representando los posibles tipos de datos que pueden ser incluidos dentro del árbol de recursos multimedia.

[[File:Edito_multimedia_Item_diagram.png|600px|Class diagram of the multimedia items management]]

= Gestión de alumnos =

En el diagrama de casos de uso para la gestión de alumnos se observan las operaciones disponibles que se pueden realizar sobre el registro de un alumno, siendo posible '''Añadir''', '''Modificar''', '''Eliminar''' (siempre que no tenga [[Sesiones]] o [[Log]]s) y '''Cambiar de Grupo'''.

[[File:Edito_students_UC.png|600px|Use case diagram of the students management]]

En el diagrama de clases de la gestión de alumnos se visualizan las clases principales involucradas en la gestión de los alumnos. Nótese la inclusión del panel de edición '''StudentEditionPanel''', el panel destinado al árbol de alumnos '''StudentsTreeEditionPanel''' y el panel contenedor de los datos que forman el registro de cada alumno ('''StudentsPropertiesPanel'''). Por otro lado, se ha incluido también la jerarquía de clases para los items a representar dentro del árbol de alumnos. Cada item podrá ser una instancia de '''SchoolTreeItem''' para las escuelas, '''GroupTreeItem''' para los grupos o '''StudentTreeItem''' para los alumnos.

[[File:Edito_student_diagram.png|800px|Class diagram of the students management]]

= Gestión de separaciones en sílabas =

En el diagrama de casos de uso para la gestión de las separaciones en sílabas se observan las operaciones disponibles que se pueden realizar, tales como '''Añadir Separación en Sílabas''' o '''Eliminar Separación en Sílabas'''.

[[File:Edito_syllables_UC.png|350px|Use case diagram of the syllables management]]

En el diagrama de clases de la gestión de las separaciones en sílabas se visualizan las clases principales involucradas en la gestión de las separaciones en sílabas. Nótese la inclusión del panel de edición '''SyllableEditionPanel''', el panel destinado al árbol de conceptos '''SyllableTreeEditionPanel''' y el panel contenedor de las separaciones en sílabas '''SyllablePropertiesPanel'''. También se han incluido las clases para los items para el árbol siendo '''LeoLetterSyllableTreeItem''' y '''LeoWordSyllableTreeItem''' los nodos que heredan de la clase '''AbstractSyllableTreeItem.

[[File:Edito_syllable_diagram.png|800px|Class diagram of the syllables management]]

[[Category:Edito]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica Edito]]

File:Edito syllables UC.png

2011-10-26T18:02:26Z

Daniel Héctor Stolfi Rosso: Use case of syllables

Use case of syllables

File:Edito syllable diagram.png

2011-10-26T18:01:59Z

Daniel Héctor Stolfi Rosso: Class diagram of syllables

Class diagram of syllables

File:Edito students UC.png

2011-10-26T18:01:22Z

Daniel Héctor Stolfi Rosso: uploaded a new version of "File:Edito students UC.png": Boundaries corrected

Use case of students

File:Edito students UC.png

2011-10-26T17:59:27Z

Daniel Héctor Stolfi Rosso: Use case of students

Use case of students

File:Edito student diagram.png

2011-10-26T17:58:55Z

Daniel Héctor Stolfi Rosso: Class diagram of students

Class diagram of students

File:Edito relation types UC.png

2011-10-26T17:58:28Z

Daniel Héctor Stolfi Rosso: Use case of relation types

Use case of relation types

File:Edito multimedia resources UC.png

2011-10-26T17:57:29Z

Daniel Héctor Stolfi Rosso: Use case of multimedia resources.

Use case of multimedia resources.

File:Edito multimedia resource diagram.png

2011-10-26T17:56:56Z

Daniel Héctor Stolfi Rosso: Class diagram of multimedia resources

Class diagram of multimedia resources

File:Edito multimedia Item diagram.png

2011-10-26T17:56:21Z

Daniel Héctor Stolfi Rosso: Class diagram of multimedia item.

Class diagram of multimedia item.

File:Edito concepts UC.png

2011-10-26T17:55:47Z

Daniel Héctor Stolfi Rosso: Use case of concepts.

Use case of concepts.

File:Edito concept diagram.png

2011-10-26T17:54:45Z

Daniel Héctor Stolfi Rosso: Class diagram of concepts

Class diagram of concepts

Edito

2011-10-26T17:51:08Z

Daniel Héctor Stolfi Rosso:

[[Edito]] is a tool which belongs to the [http://patio.lcc.uma.es/patio/index.php?lang=en PATIO project]. It is used to modify the database in order to add new concepts, their relations and syllable divisions. Besides, it facilitates adding new multimedia resources and pupil management so they are able to perform the exercises of the [[Aprendo]], [[Escribo]], [[Leo]] and [[Trazo]] modules.

[[Edito]] has four main tabs:

* [[Concepts Tab]]
* [[Multimedia Resources Tab]]
* [[Pupils Tab]]
* [[Syllables Tab]]

In order to make proper use of [[Edito]], as well as other project's applications, you will have to check the current configuration in the [[Configuration Panel]].

You can also check the [[Technical Documentation Edito|Technical Documentation]] of the [[Edito]] module.

[[File:Edito_feature_schema_en.png|left|thumb|800px|Edito's feature schema]]

[[Category:Applications]]
[[Category:Edito]]
[[es: Edito]]

Category:Technical Documentation

2011-10-26T17:49:40Z

Daniel Héctor Stolfi Rosso: Created page with 'Technical Documentation. es: Category:Documentación Técnica'

Technical Documentation.
[[es: Category:Documentación Técnica]]

Technical Documentation LogProcessor

2011-10-26T17:46:55Z

Daniel Héctor Stolfi Rosso:

In the [[LogProcessor]] module we have implemented the analysis of the [[Log]] of the exercises and the exportation of the produced results to a [http://es.wikipedia.org/wiki/CSV CSV] file. Besides, you can produce graphs and pattern analyses of some type of exercises.

__TOC__

= Use Case =

In the use case diagram you can visualize the available actions of this module. You can '''Analyse a log''', '''Export analysis to a CSV file''', '''Analyse patterns''' or '''Produce graphs''' using data form [[Log]] files of the exercises.

[[File:Log_UC.png|400px|Case use diagram of the processor of logs]]

= Class Diagram of the Log Reader =

In the class diagram of the log reader you can visualize the '''AbstractCommonLogGraph''' class which is used to produce graphs ('''CommonLogGraph''') and the pattern analyses ('''CommonLogPattern'''). The diagram also contains the '''AbstractCommonLogProcessor''' class which is used to read logs from the database ('''CommonLogProcessor''') or from a disk file ('''CommonFileLogProcessor''').

[[File:Log_reader_diagram.png|800px|Class diagram of the log reader]]

= Class Diagram of the Log Events =

In the class diagram of the log events you can visualize the events hierarchy that the program use. As you can see, there is a division between events of the pointing device ('''AbstractPointerEvent''') and exercise events ('''LogEvent''').

[[File:Log_events_diagram.png|600px|Class diagram of the log events]]

= Class Diagram of the Log Processor =

In the class diagram of the log processor you can visualize the existing division between the processors of the exercises of the [[Aprendo]] module ('''AbstractAprendoProcessor''') and the exercises of the [[Leo]] module ('''AbstractLeoProcessor'''). Note that, there is a specific class for processing logs of each type of exercise.

[[File:Log_processor_diagram.png|800px|Class diagram of the log processor]]

= Class Diagram of the Graphs of Logs =

In the class diagram of the graphs of logs you can visualize several classes ('''DirectionalGraph''', '''PointsDensityGraph''' y '''AllPointsGraph''') which can be included into the container panel of graphs '''GraphPanel'''. Note that the panel of graphs can also be included into the panel of pattern analysis ('''PatternStudyPanel''') which contains the pattern lists ('''PatternList''') and ('''PatternUserList''') too.

[[File:Log_graph_diagram.png|800px|Class diagram of the graphs of logs]]

= Class Diagram of the Results Exporter =

In the class diagram of the results exporter you can visualize a division between the classes of the exercises of the [[Aprendo]] module (They inherit from '''AbstractAprendoExporter''') and the [[Leo]] ones (They inherit from '''AbstractLeoExporter''').

[[File:Log_exporter_diagram.png|800px|Class diagram of the results exporter]]

= Class Diagram of the Log Player =

In the class diagram of the log player you can visualize a division between the classes of the exercises of the [[Aprendo]] ('''AbstractAprendoPlayer''') and the [[Leo]] ones ('''AbstractLeoPlayer'''). Then, each exercise has got a specific class that implements the proper engine for the player. Note that the class used for replaying exercise events ('''AbstractExercisePlayer''') and for pointing device events ('''MouseEventsGlassPane''') inherit from the class '''AbstractPlayerComponent'''.

[[File:Log_player_diagram.png|600px|Class diagrama of the log player]]

[[Category:LogProcessor]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica LogProcessor]]

Technical Documentation LogProcessor

2011-10-26T13:51:13Z

Daniel Héctor Stolfi Rosso: Created page with 'In the LogProcessor module we have implemented the analysis of the Log of the exercises and the exportation of the produced results to a [http://es.wikipedia.org/wiki/CSV…'

In the [[LogProcessor]] module we have implemented the analysis of the [[Log]] of the exercises and the exportation of the produced results to a [http://es.wikipedia.org/wiki/CSV CSV] file. Besides, you can produce graphs and pattern analyses of some type of exercises.

__TOC__

= Use Case =

In the use case diagram you can visualize the available actions of this module. You can '''Analyse a log''', '''Export analysis to a CSV file''', '''Analyse patterns''' or '''Produce graphs''' using data form [[Log]] files of the exercises.

[[File:Log_UC.png|400px|Case use diagram of the processor of logs]]

= Class Diagram of the Log Reader =

In the class diagram of the log reader you can visualize the '''AbstractCommonLogGraph''' class which is used to produce graphs ('''CommonLogGraph''') and the pattern analyses ('''CommonLogPattern'''). The diagram also contains the '''AbstractCommonLogProcessor''' class which is used to read logs from the database ('''CommonLogProcessor''') or from a disk file ('''CommonFileLogProcessor''').

[[File:Log_reader_diagram.png|800px|Class diagram of the log reader]]

= Class Diagram of the Log Eventos =

En el diagrama de clases de eventos se tiene la jerarquía de eventos que el programa reconoce. Como se observa, existe una división entre eventos del puntero ('''AbstractPointerEvent''') y eventos de los ejercicios ('''LogEvent''').

[[File:Log_events_diagram.png|600px|Class diagram of the log events]]

= Diagrama de Clases del Procesador de Logs =

En el diagrama de clases del procesador de logs se observa la división existente entre los procesadores para los ejercicios realizados con el módulo [[Aprendo]] ('''AbstractAprendoProcessor''') y el módulo [[Leo]] ('''AbstractLeoProcessor'''). Nótese que existe una clase específica encargada de procesar los logs de cada tipo de ejercicio.

[[File:Log_processor_diagram.png|800px|Class diagram of the log processor]]

= Diagrama de Clases de las Gráficas de Logs =

En el diagrama de clases de las gráficas de logs se observan las distintas gráficas ('''DirectionalGraph''', '''PointsDensityGraph''' y '''AllPointsGraph''') que pueden incluirse dentro de el panel contenedor de gráficas '''GraphPanel'''. Nótese que el panel de gráficas también puede ser utilizado dentro del panel de análisis de patrones ('''PatternStudyPanel''') el cual contiene además a los listados de patrones ('''PatternList''') y ('''PatternUserList''').

[[File:Log_graph_diagram.png|800px|Class diagram of the log graphs]]

= Diagrama de Clases del Exportador de Resultados =

En el diagrama de clases del exportador de resultados se observa nuevamente una división entre las clases exportadoras de ejercicios del módulo [[Aprendo]] (Heredan de '''AbstractAprendoExporter''') y las correspondientes al módulo [[Leo]] (Heredan de '''AbstractLeoExporter''').

[[File:Log_exporter_diagram.png|800px|Class diagram of the result exporter]]

= Diagrama de Clases del Reproductor de Logs =

En el diagrama de clases del reproductor de logs se puede observar, al igual que en casos anteriores, la división entre clases para los ejercicios del módulo [[Aprendo]] ('''AbstractAprendoPlayer''') y del módulo [[Leo]] ('''AbstractLeoPlayer'''). Luego, cada ejercicio tiene su propia clase que implementa el motor de reproducción específico. Nótese que tanto la reproducción de ejercicios ('''AbstractExercisePlayer''') como la de eventos del ratón ('''MouseEventsGlassPane''') heredan de la clase '''AbstractPlayerComponent'''.

[[File:Log_player_diagram.png|600px|Class diagrama of the log player]]

[[Category:LogProcessor]]
[[Category:Technical Documentation]]
[[es: Documentación Técnica LogProcessor]]

File:Log UC.png

2011-10-26T13:10:35Z

Daniel Héctor Stolfi Rosso: Use case diagram

Use case diagram

File:Log reader diagram.png

2011-10-26T13:09:36Z

Daniel Héctor Stolfi Rosso: Class diagram of reader

Class diagram of reader

File:Log processor diagram.png

2011-10-26T13:09:13Z

Daniel Héctor Stolfi Rosso: Class diagram of processor

Class diagram of processor

File:Log player diagram.png

2011-10-26T13:08:37Z

Daniel Héctor Stolfi Rosso: Class diagram of player

Class diagram of player

File:Log graph diagram.png

2011-10-26T13:08:10Z

Daniel Héctor Stolfi Rosso: Class diagram of graph

Class diagram of graph

File:Log exporter diagram.png

2011-10-26T13:07:41Z

Daniel Héctor Stolfi Rosso: Class diagram of exporter

Class diagram of exporter

File:Log events diagram.png

2011-10-26T13:06:57Z

Daniel Héctor Stolfi Rosso: Class Diagram of events .

Class Diagram of events .

LogProcessor

2011-10-26T11:13:35Z

Daniel Héctor Stolfi Rosso:

[[LogProcessor]] is a tool which belongs to the [http://patio.lcc.uma.es/patio/index.php?lang=en PATIO project]. It is used to analyse the results of the exercises of the [[Aprendo]] and [[Leo]] modules.

[[LogProcessor]] has three main tabs:

* [[Log Selection Tab]]
* [[Results Tab]]
* [[Export Data Tab]]

Note that in the same way as in the other applications of the project, in order to make proper use of [[LogProcess]], you will have to check the current configuration in the [[Configuration Panel]].

You can also check the [[Technical Documentation LogProcessor|Technical Documentation]] of the [[LogProcessor]] module.

[[File:Log_feature_schema_en.png|left|thumb|800px|LogProcessor's feature schema]]

[[Category:Aplicaciones]]
[[Category:LogProcessor]]
[[es: LogProcessor]]

Export Data Tab

2011-10-25T13:20:24Z

Daniel Héctor Stolfi Rosso:

[[File:Log_data_export_en.png|right|thumb|550px|Export Data Tab]]

The [[Export Data Tab]], part of the [[LogProcessor]] application, is used to preview data from the performed analysis. They also can be exported to a [http://en.wikipedia.org/wiki/Comma-separated_values CSV] file.

There are two ways of selecting the data source for the preview. The first one is by pressing the '''Preview export''' button placed in the [[Log Selection Tab]]. In this case, data is obtained from the filtered [[Log]]s in that tab. The second option is by pressing the '''Import''' button in the present tab in order to import data from the analysis windows opened in the [[Results Tab]].

Note that each column has a reference number (e.g. IC-5.1) which stands for an indicator (e.g. Total of images). The indicators are grouped by exercise types in the right panel of the [[Export Data Tab]].

Finally, you can run the export process, pressing the '''Export''' button and entering the desired file name in the dialogue which appears on the screen.

[[Category:LogProcessor]]
[[es: Pestaña Exportar Datos]]

Results Tab

2011-10-25T13:03:17Z

Daniel Héctor Stolfi Rosso:

[[File:Log_analysis_en.png|right|thumb|550px|Results tab]]

The [[Results Tab]], part of the [[LogProcessor]] application, is a container of analysis windows, graphs and patterns. Each window can be minimized or closed, so that this tab behaves like a real workbench.

__TOC__

= Analysis =

[[File:Log_header_results_en.png|right|thumb|250px|Header analysis window]]

All analysis windows have a common header which contains the '''Exercise name''', its '''type''' and the date when it was performed. Below the header, the name and the picture of the pupil. In multi-user exercises, there are as many lines as pupils.

Besides, there are two buttons in the top right corner. The first one is for watching the video of children doing the exercise, if it is available and the multimedia player has been configured in the [[Configuration Panel]]. The second button is used to replay the exercise using the [[Exercise Player]].

Finally, there is series of tabs that are common to all analysis windows, but show different data depending on the [[:Category:Applications|Application]] and [[:Category:Exercises|Exercise]] type:

== Exercise Tab ==

[[File:Log_exercise_analysis_en.png|right|thumb|200px|Exercise tab]]

This tab shows a list with the data from the ''abstractLog'' section of a [[Log]] file.

The available info depends on the pupil's behaviour and the exercise type. Usually the ''abstractLog'' section contains data about high-level events which happened when the pupil was doing the exercise.

Notice that in each line of the list there is an event icon followed by the event time mark in seconds and a description of the event. By double-clicking on a line, you can visualize the image events or hear sound events.

More info about ''abstractLog'' events is available in the [[XSD Files]] topic.

== Pointer Tab ==

[[File:Log_pointer_en.png|right|thumb|200px|Pointer tab]]

This tab shows a list with the data from the ''mouseLog'' section of a [[Log]] file.

The available info depends on the pupil's behaviour because in the ''mouseLog'' section all low level events are recorded during the exercise performing.

Note that each line of the list has an event icon followed by the event time mark in seconds and the description of it.

More info about ''mouseLog'' events is available in the [[Log]] topic.

== Results Tab ==

[[File:Log_results_en.png|right|thumb|200px|Results tab]]

In this tab an specific analysis of the exercise is made. As a result, data shown will be different depending on the type of exercise:

=== Results for ''Emparejar Sonido-Imagen'' exercises ===

For ''[[Emparejar Sonido-Imagen]]'' exercises the following data is obtained:

* Specific Indicators
** IE-1.1: Image: Click and clicked (Pupil had to click on the image and she did)
** IE-1.2: Image: No click and clicked (Pupil didn't have to click on the image but she did)
** IE-1.3: Image: Click and didn't click (Pupil had to click on the image but she didn't)
** IE-1.4: Image: No click and didn't click (Pupil didn't have to click on the image and she didn't)
** IE-1.5: Without image: No click and clicked (Pupil clicked when she shouldn't have)
** IE-1.6: Without image: No click and didn't click (Pupil didn't click when she shouldn't have)
* Common Indicators
** IC-1.1: Total of images
** IC-1.2: Average time of correct clicks
** IC-1.3: Deviation time of correct clicks
** IC-1.4: Average time of wrong clicks
** IC-1.5: Deviation time of wrong clicks
** IC-1.6: Exercise length

=== Results for ''Diferencias'' exercises ===

For ''[[Diferencias]]'' exercises the following data is obtained:

* Specific Indicators
** IE-2.1: Hits on differences
** IE-2.2: Clicks out of image
** IE-2.3: Clicks on the left image
** IE-2.4: Clicks on the right image
* Common Indicators
** IC-2.1: Game ended
** IC-2.2: Time of the first correct click
** IC-2.3: Average time of correct clicks
** IC-2.4: Deviation time of correct clicks
** IC-2.5: Exercise length

=== Results for ''Memoria'' exercises ===

For ''[[Memoria]]'' exercises the following data is obtained:

* Specific Indicators
** IE-3.1: Wrong clicks
** IE-3.2: Clicks on the background and before new images
** IE-3.3: Clicks on the background and after new images
** IE-3.4: Repeated wrong clicks
* Common Indicators
** IC-3.1: Correct clicks
** IC-3.2: Game ended
** IC-3.3: Time of the first correct image
** IC-3.4: Average time between correct images
** IC-3.5: Deviation time between correct images
** IC-3.6: Time of first correct image
** IC-3.7: Average time between wrong images
** IC-3.8: Deviation time between wrong images
** IC-3.9: Exercise length

=== Results for ''Objetos Escena'' exercises ===

For ''[[Objetos Escena]]'' exercises the following data is obtained:

* Specific Indicators
** IE-4.1: Clicks on instructions
** IE-4.2: Wrong clicks
* Common Indicators
** IC-4.1: Correct clicks
** IC-4.2: Time of the first correct click
** IC-4.3: Time between correct clicks
** IC-4.4: Average time between correct clicks
** IC-4.5: Deviation time between correct clicks
** IC-4.6: Time of the first click on instruction
** IC-4.7: Average time between clicks over instructions
** IC-4.8: Deviation time between clicks over instructions
** IC-4.9: Time of the first wrong click
** IC-4.10: Average time between wrong clicks
** IC-4.11: Deviation time between wrong clicks

=== Results for ''Reflejos'' exercises ===

For ''[[Reflejos]]'' exercises the following data is obtained:

* Specific Indicators
** IE-5.1: Total of images
* Common Indicators
** IC-5.1: Correct clicks
** IC-5.2: Clicks out of images
** IC-5.3: Clicks when no image is shown
** IC-5.4: Average time of correct clicks
** IC-5.5: Deviation time of correct clicks
** IC-5.6: Average time of clicks out of image
** IC-5.7: Deviation time of clicks out of images
** IC-5.8: Average time of clicks when no image is shown
** IC-5.9: Deviation time of clicks when no image is shown
** IC-5.10: Average distance of clicks out of image
** IC-5.11: Deviation distance of clicks out of image
** IC-5.12: Exercise length

=== Results for ''Selecciona Distinta'' ===

For ''[[Selecciona Distinta]]'' exercises the following data is obtained:

* Specific Indicators
** IE-6.1: Consecutive correct clicks
** IE-6.2: Repeated correct clicks
* Common Indicators
** IC-6.1: Correct clicks
** IC-6.2: Clicks out of image
** IC-6.3: Wrong clicks
** IC-6.4: Time of the first click
** IC-6.5: Time of the first correct click
** IC-6.6: Average time between correct clicks
** IC-6.7: Deviation time between correct clicks
** IC-6.8: Time of the first wrong click
** IC-6.9: Average time between wrong clicks
** IC-6.10: Deviation time between wrong clicks
** IC-6.11: Time of the first click out of image
** IC-6.12: Average time between clicks out of image
** IC-6.13: Deviation time between clicks out of image
** IC-6.14: Average time between correct repeated clicks
** IC-6.15: Deviation time between correct repeated clicks
** IC-6.16: Exercise length

=== Results for ''Serie'' ===

For ''[[Serie]]'' exercises the following data is obtained:

* IC: Total correct images
* IE: Total wrong images
* MI: Total moved images
* MTIC: Average time of correct images
* DTIC: Deviation time of correct images
* MTIE: Average time of wrong images
* DTIE: Deviation time of wrong images
* MTIFC: Average time of moved images
* DTIFC: Deviation time of moved images
* DE: Exercise length

=== Results for ''Serie Multiusuario'' ===

For ''[[Serie Multiusuario]]'' exercises the following data is obtained:

* Single Indicators
** I.1: Total correct images
** I.2: Total wrong images
** I.3: Total moved images
** I.4: Turns taken
** I.5: Turns transferred
** I.6: Illegitimate turns
** I.7: Score
* Group Indicators
** G.1: Exceeded turns
** G.2: Number of players
** G.3: Placed images
** G.4: Group score
** G.5: Exercise length

=== Results for ''Escribir'' ===

For ''[[Escribir]]'' exercises the following data is obtained:

* Ex1: Total of reproduces videos
* Ex2: Exercise length

=== Results for ''Nube de Letras'' ===

For ''[[Nube de Letras]]'' exercises the following data is obtained:

* Ex1: Total token hits
* Ex2: Total token misses
* Ex3: Total identification hits
* Ex4: Total identification misses
* Ex5: Exercise length

== Exercise Figure Tab ==

[[file:Log_exercise_graph_en.png|right|thumb|200px|Exercise Graph tab]]

This tab contains a graph produced with the data from the ''abstractLog'' section of a [[Log]] file. The Y axis represents the exercise events, and the X axis is used for the exercise time; its length depends on the amount of time the user spent on doing the exercise.

In the same way as in the '''Exercise Tab''', the data available will change depending on the pupil's behaviour and the type of exercise.

Note that the goal of this analysis is building a temporal diagram showing the pupil's actions in order to draw visual inference from her behaviour and the order she followed to do the exercise.

More info about ''abstractLog'' events is available in the [[XSD Files]] topic.

== Pointer Figure Tab ==

[[file:Log_pointer_graph_en.png|right|thumb|200px|Pointer Graph tab]]

This tab contains a graph produced with the data from the ''mouseLog'' section of a [[Log]] file. The Y axis represents the pointer events, and the X axis is used for the exercise time. Like in the previous tab, the length of the time axis depends on the time pupil spent doing the exercise.

Note that this figure could be hard to read when the pupil behaves erratically without achieving the goal of the exercise.

More info about ''mouseLog'' events is available in the [[Log]] topic.

== Extra Tab ==

[[File:Log_extra_analysis_en.png|right|thumb|200px|Extra tab]]

This tab is visible only in the analysis of exercises of ''[[Diferencias Exercise|Diferencias]]'' and ''[[Objetos Escena Exercise|Objetos Escena]]'' types from the [[Aprendo]] module and for exercises of ''[[Escribir Exercise|Escribir]]'' type from the [[Leo]] module. It contains a graph formed by dots which represent the clicks made by the pupil. The dots are connected by arrows in order to show the sequence the pupil has followed.

Using a slider you can go forward or backward in the sequence of dots. There is another slider for changing the level of transparency of the background image of the exercise. As a result, all dots can be seen clearly.

There is a different manner of replaying exactly the way the pupil completed an exercise, using the [[Exercise Player]].

== Log File Tab ==

[[File:Log_log_file_en.png|right|thumb|200px|Log file]]

In this tab, the last one, you can see the [[Log]] file coded in ([http://es.wikipedia.org/wiki/XML XML]), in case you want to check the analysis made at a very low level.

= Graphs =

This graphical analysis only can be performed in exercises of ''[[Diferencias Exercise|Diferencias]]'' and ''[[Objetos Escena Exercise|Objetos Escena]]'' types because only they involve searching for objects in an image. This exercise is ideal to analyse the search points that pupils have clicked with the pointing device.

Since the graph shows the search points made in the exercise, you can combine many exercises of the same type and the same window dimensions. Then, the analysis adds a layer on the top of the exercise, drawing with different colours the point density for each delimited area. This representation can be modified changing the graph parameters with the sliders of the bottom panel:

; Granularity
: Changes the dimensions of the array cell.
; Radius
: Controls the influence of the neighbour cells on the value of each single array cell.
; Points size
: Modifies the size of points.
; Transparency
: Controls the transparency level of the density layer, so background image can be gradually unveiled.

Besides, a scale is provided in order to assign to each colour of the graph the number of points that it represents. Above the scale, you can read the total number of points in the graph and at the bottom of the panel you can select the name of the pupil whose points will be highlighted. This combo box is initially blank and it is useful only in graphs showing points of more than just one pupil.

[[File:Log_graph_en.png|center|thumb|550px|Points graph]]

= Patterns =

The exercises of ''[[Diferencias Exercise|Diferencias]]'' and ''[[Objetos Escena Exercise|Objetos Escena]]'' types have search points that can be interpreted like patterns. This analysis calculates the '''Search''' and '''Hits''' patterns and allows us to see the combined directional graph for many pupils, all in the same window.

This window has three parts. A directed graph in the top left panel where you can view the search point of the selected pupil; a list in the bottom left panel where you can select the pupil to be highlighted; and a panel on the right that contains three tabs:

; Graph
: Contains all directed graphs from the analysed logs in which the selected pupil from the list will be highlighted.
; Hits
: Contains all hit patterns calculated using the analysed logs.
; Patterns
: Contains all click patterns calculated using the analysed logs.

Finally, you can export in a [http://en.wikipedia.org/wiki/Comma-separated_values CSV] file all the patterns from the analysis using the '''Export''' button.

[[File:Log_patterns_en.png|center|thumb|550px|Pattern Analysis]]

[[Category:LogProcessor]]
[[es: Pestaña Resultados]]

Log Selection Tab

2011-10-25T11:48:23Z

Daniel Héctor Stolfi Rosso:

[[File:Log_logs_selection_en.png|right|thumb|550px|Log Selection Tab]]

The [[Log Selection Tab]], part of the [[LogProcessor]] application, is divided into a top panel and a central zone. The first contains several buttons for executing the application's processes and [[Configuration Panel|configuring]] its parameters. The latter contains a filter panel for selecting a set of [[Log]]s to work with.

__TOC__

= Filters =

To select the logs to be analysed, you can use several filters which depend on each other. The right order to filter Logs is from left to right, in other words, starting with [[Session|Sessions]] and ending with [[Log]]s.

Note that you can select a number of items from all filters, using '''Control''' ('''Command''' in Mac) plus left-click to select them individually or using '''Shift''' plus left-click to select a consecutive range of items. Also, you can use the '''Select all''' button, placed into each filter, to select all the filter items easily.

The available filters are:

; Sessions
: You can select the [[Session|Sessions]] of the tests pupils have done or the special item called [['''-- No session --''']] which filters all the logs from [[:Category:Exercises|Exercises]] not included in any session.

; Pupils
: This filter shows the list of the [[Pupil]]s which have done exercises in the sessions you have selected in the previous filter.

; Exercises
: This filter allows you to choose the [[Exercise]]s done by the previously selected pupils and sessions.

; Logs
: Finally, this filter shows the [[Log]]s belonging to all the previous filters. Selecting at least one of them allows you to execute the analyses available in the top panel of this tab.

= Operations =

When the filters have been applied and the logs have been selected, you will have to choose one process option from the available ones.

== Analyse ==

This process starts the analysis of the selected logs. Depending on the [[:Category:Applications|Application]] and the type of [[:Category:Exercises|Exercise]], the analysis will obtain different information from the logs. Usually it will includes answering times, number of hits and fails, etc. The results will be shown in the [[Results Tab]].

== Preview export ==

The analysis results can be exported in [http://en.wikipedia.org/wiki/Comma-separated_values CSV] format in order to be processed by external programs. This operation can be done pressing the '''Preview Export''' button or from the [[Export Data Tab]].

== Graphs ==

For exercises of the [[Diferencias Exercise|Diferencias]] and [[Objetos Escena Exercise|Objetos Escena]] types, you can do a graphical analysis of a pupil's clicks and point density, comparing several logs for the same type of exercise. In this way you can detect where pupils concentrate their searches. You launch this analysis by pressing the '''Graph''' button; the results are shown in the [[Results Tab]].

== Patterns ==

In the same way, exercises of the [[Diferencias Exercise|Diferencias]] and [[Objetos Escena Exercise|Objetos Escena]] types can be analysed at click level. The pattern analysis is made by dividing the background picture into a grid and assigning a symbol to each cell. So, each click inside a cell will add a new symbol to the pattern. You can execute this analysis by pressing on the '''Pattern''' button; the results are shown in the [[Results Tab]].

= Load from file =

You can also read log files from the disc in order to analyse them without using the database. To do that, you have to press the '''Load from file''' button and select the desired files in the dialogue which will appear on the screen.

[[Category:LogProcessor]]
[[es: Pestaña_Selección_de_Logs]]

LogProcessor

2011-10-25T11:35:24Z

Daniel Héctor Stolfi Rosso:

[[LogProcessor]] is a tool which belongs to the [http://patio.lcc.uma.es/patio/index.php?lang=en PATIO project]. It is used to analyse the results of the exercises of the [[Aprendo]] and [[Leo]] modules.

[[LogProcessor]] has three main tabs:

* [[Log Selection Tab]]
* [[Results Tab]]
* [[Export Data Tab]]

Note that in the same way as in the other applications of the project, in order to make proper use of [[LogProcess]], you will have to check the current configuration in the [[Configuration Panel]].

[[File:Log_feature_schema_en.png|left|thumb|800px|LogProcessor's feature schema]]

[[Category:Aplicaciones]]
[[Category:LogProcessor]]
[[es: LogProcessor]]

Exercise Player

2011-10-24T15:44:55Z

Daniel Héctor Stolfi Rosso:

Thanks to the [[Exercise Player]], you can watch how the pupil performed the exercise step by step within the time line, in order to detect her hits and misses.

The user interface consists of four buttons, each with a picture of a mouse on it, to show and hide the pointing device events. These button icons are coloured as follows:

; Red
: This button shows/hides pressing pointer events
; Gray
: This button shows/hides dragging pointer events
; Blue
: This button shows/hides releasing pointer events
; Yellow
: This button shows/hides clicking pointer events

Note that the dots drawn over the exercise are in the same colour as these buttons.

The user interface also contains a time bar which can be moved by the user manually or by using the buttons in the panel on the right. These buttons are for:

* Returning to the beginning of the exercise.
* Starting the exercise player.
* Pausing the exercise player.

Finally, above the button panel there is a display showing the position of the time bar. It can be visualized in minutes and seconds or in milliseconds; to change the display format, you have to click on it.

The player has got different engines to execute [[:Category:Exercises|Exercises]]. The choice of the engine depends on the type of the [[:Category:Exercises|Exercise]]

[[File:Log_exercise_player.png|left|thumb|800px|Exercise player]]

[[Category:LogProcessor]]
[[es: Reproductor de Ejercicios]]

Log

2011-10-24T15:38:27Z

Daniel Héctor Stolfi Rosso:

When an [[:Category:Exercises|Exercise]] has been done, a [[Log]] file is generated. It is an [http://en.wikipedia.org/wiki/XML XML] file which is divided into four sections at the most:

; Header
: Here are defined the type of exercise, the pupil code, the date and mode of the execution and the window's size in which the exercise has been executed.
; ''Exercise'' section
: It contains information about the exercise. This section is optional.
; ''AbstractLog'' section
: It contains the high-level events of the exercise.
; ''MouseLog'' section
: It contains the low-level events of the pointer device.
; ''PaintedPointsLog'' section
: It contains the low-level events of the drawing panel.

Note that the data in the ''exercise'' and ''abstracLog'' sections depends on the exercise type.

Finally, in the ''mouseLog'' section there can only be events of these kinds:

* Pointer press.
* Pointer drag.
* Pointer release.
* Pointer activation.

While the ''paintedPointsLog'' section can also contain events of the following types:

* Colour change.
* Size change.
* Tool change.

[[es: Log]]

Exercise Player

2011-10-19T15:47:15Z

Daniel Héctor Stolfi Rosso:

Using the [[Exercise Player]] you can watch the exercise performance of the pupil based in the time line, repeating her behaviour in the same way it was performed, in order to detect the hits and misses she has done.

The user interface consists on four buttons with a picture of a mouse like icon in order to show and hide the pointing device events. These button icons are coloured as follows:

; Red
: This button shows/hides pressing pointer events
; Gray
: This button shows/hides dragging pointer events
; Blue
: This button shows/hides releasing pointer events
; Yellow
: This button shows/hides clicking pointer events

Note that the dots drawn over the exercise are in the same colour as these buttons.

The user interface also contains a time bar which can be modified by the user directly or by using the button panel on the right. This panel has buttons for:

* Returning to the beginning of the exercise.
* Starting the exercise player.
* Pausing the exercise player.

Finally, above the button panel is a display showing the time mark of the position of the bar time. It can be visualized in minutes and seconds or in milliseconds; to toggle the display format, you have to click on it.

Depending on the type of the [[:Category:Exercises|Exercise]] the behaviour of the player will be different, executing different engines for each exercise type.

[[File:Log_exercise_player.png|left|thumb|800px|Exercise player]]

[[Category:LogProcessor]]
[[es: Reproductor de Ejercicios]]

Exercise Player

2011-10-19T15:38:30Z

Daniel Héctor Stolfi Rosso: Created page with 'Using the Exercise Player you can watch the exercise performance of the pupil based in the time line, repeating her behaviour in the same way it was performed, in order to de…'

Using the [[Exercise Player]] you can watch the exercise performance of the pupil based in the time line, repeating her behaviour in the same way it was performed, in order to detect the hits and misses she has done.

The user interface consists on four buttons with a picture of a mouse like icon in order to show and hide the pointing device events. These button icons are coloured as follows:

; Red
: This button shows/hides pressing pointer events
; Gray
: This button shows/hides dragging pointer events
; Blue
: This button shows/hides releasing pointer events
; Yellow
: This button shows/hides clicking pointer events

Note that the dots drawn over the exercise are in the same colour as these buttons.

The user interface also contains a time bar which can be modified by the user directly or by using the button panel on the right. This panel has buttons for:

* Returning to the beginning of the exercise.
* Starting the exercise player.
* Pausing the exercise player.

Por último sobre esta botonera se encuentra un visor mostrando el valor correspondiente a la posición de la barra de tiempo, pudiendo visualizarse en minutos y segundos o bien, en milisegundos. Este cambio de formato se consigue pulsando sobre dicho visor.

Según el tipo de [[:Categoría:Ejercicios|Ejercicio]] la respuesta del reproductor a los eventos del puntero obtenidos desde el fichero de [[Log]] será distinta, no sólo en cuanto al ''motor'' del ejercicio, sino a las entidades que se resaltan como correctas o erróneas.

[[Archivo:Log_reproduccion_ejercicios_es.png|left|thumb|800px|Reproductor de Ejercicios]]

[[Category:LogProcessor]]
[[es: Reproductor de Ejercicios]]

Syllables Tab

2011-10-18T14:53:01Z

Daniel Héctor Stolfi Rosso: Proofreading

[[File:Edito_syllables_en.png|right|thumb|600px|Syllables Tab]]

In the [[Syllables Tab]], part of [[Edito]] application, you can divide the names of the concepts into syllables or remove their syllable division so they can be used in the exercises of the [[Leo]] module.

This tab consists of a concepts tree placed on the left, where the concepts which have already been defined are shown, and a central panel with the syllable division of the selected concept (if it has been made), as well as the letters which form each syllable.

__TOC__

= Add syllable division =

[[File:Edito_syllable_popup_en.png|220px|thumb|left|Syllable Popup Menu]]

To divide a concept into syllables, you have to press the '''+''' button at the top of the concepts tree or choose the '''Add''' option from the popup menu which will appear when the tree is right clicked with the mouse. Next, you have to enter the syllable division in the dialogue shown, using a blank to separate the syllables, and finally, you have to confirm the operation.

= Delete syllable division =

In order to delete a syllable division, you have to select it from the concept tree and press the '''X''' button at the top of the tree or choose '''Delete''' from the popup menu. Finally, you have to confirm the deletion in the security dialogue before it takes place.

[[Category:Edito]]
[[es: Pestaña Sílabas]]

Pupils Tab

2011-10-18T14:41:59Z

Daniel Héctor Stolfi Rosso:

[[File:Edito_Pupils_en.png|right|thumb|600px|Pupils Tab]]

In the [[Pupils Tab]], a part of the [[Edito]] application, you can create, modify or delete pupils that will do the exercises of the [[Aprendo]], [[Leo]], [[Escribo]] or [[Trazo]] modules. This tab has the pupils tree on the left. In the tree there are schools from the database; inside each school there are groups and inside each group there are pupils.

In the middle zone, you can see the pupils corresponding to the selection made in the tree. For example, if you select a school, all pupils from this school will be shown; while if you select just a group, only pupils from this group will be shown instead. Finally, in the right panel there will be shown all the data available for the pupil.

Note that it is possible to change the thumbnail size and the order for pupils in the central list using the controls at the top of the central panel.

__TOC__

= Add a pupil =

[[File:Edito_pupils_popup_en.png|280px|thumb|right|Popup menu pupils]]

To add a new pupil, you have to select the desired group in the pupils tree and then, press the '''+''' button at the top of the tree or choose the '''Add''' option from the popup menu which appears when the tree is right clicked with the mouse. Next, you have to fill in the following fields in the panel on the right:

; Name and Surnames
: Name and Surnames of pupil (the second surname is not mandatory).
; Date of birth
: Date of birth of pupil (use ''0/0/0'' from empty).
; Image
: Pupil's picture.
; Comments
: Additional information about pupil.
; Language
: Languages that pupil speaks/understands and his/her skill.

To confirm that a new pupil has been added, you have to press the '''Save''' button at the bottom of the panel, if you select other existing pupil, group or school instead, the addition will be discarded.

= Modify a pupil =

To modify an existing pupil, you have to select her from the list and then, modify any data you want in the panel on the right. When the changes have been made, you have to confirm them by pressing the '''Save''' button. Like in the previous case, if you select other pupil, group or school, the unsaved modifications will be lost.

= Delete a pupil =

In order to delete an existing pupil, you can do one of the three things: Select it from the list and press the '''X''' button at the top of the pupils tree; choose the '''Delete''' option from the popup menu that will appear when the tree is right clicked with the mouse; or press the '''Delete''' button in the edition panel. Finally, you have to confirm the deletion in the security dialogue which will appear on the screen. Note that if the pupil has performed some exercises in the system, her record will not be deleted. In this case, it is safer to move such pupil to a predetermined group, especially created to store inactive pupils.

= Change the pupil group =

[[File:Edito_group_change_en.png|260px|thumb|right|Group change dialogue]]

The method for moving a pupil from group to group consists in dragging her from her current group in the pupils tree and dropping her over the target group. Then, a dialogue will be shown, so you can enter the '''Date of group change'''.

Keep in mind that if you enter a future date, the pupil will stay in the current group until this date has been reached.

[[Category:Edito]]
[[es: Pestaña_Alumnos]]

Multimedia Resources Tab

2011-10-18T13:37:32Z

Daniel Héctor Stolfi Rosso: Proofreading

In the [[Multimedia Resources Tab]], part of the [[Edito]] application, you can create, modify or delete multimedia resources. Besides, resources can be associated with concepts or you can even add new files of different languages to an existing multimedia resource.

Note that multimedia resources must have a description in the same language as the user interface, or in the ''neutral'' language, in order to be well shown in the multimedia resource tree.

__TOC__

= Modify Resources Tab =

[[File:Edito_resources_modify_en.png|right|thumb|600px|Multimedia Resources Tab]]

This tab contains the multimedia resource tree on the left; the resources list showing the resources filtered by the current selection, in the central zone; and the details of the chosen file, in the panel on the right.

Note that you can change the preview size and the order of the multimedia resources in the central list using the controls at the top of the central panel.

Each file has the following fields:

; File
: The name of the multimedia file.
; Type
: The type of the multimedia resource.
; Language
: The language in which the resource can be used.
; Image
: The image that represents the multimedia resource.
; Associations
: The list of concepts that this resource represents.

== Modify a multimedia resource ==

To modify an existing multimedia resource, you have to select it from the resources list, make the desired modifications and finally press the '''Save''' button to confirm changes.

Note that each multimedia resource can be associated with several files (one for each language) in order to provide specific representations for all the available languages.

Finally, you have to keep in mind that if you add a concept to the '''Association List''', you will get the same results as by dragging the multimedia resource over the '''Concepts - Resources Panel''' in the [[Concepts Tab]].

== Delete a multimedia resource ==

In order to delete a multimedia resource, you have to select it from the resources list and press the '''Delete''' button. Then, you have to confirm the deletion in the security dialogue that will appear on the screen.

= Add Resources Tab =

[[File:Edito_resources_add.png|right|thumb|600px|Add Resources Tab]]

In this tab, you can add multimedia resources to the database one by one.

First, you have to select the source directory where the multimedia files are. To do it, use the button with the folder icon or write the complete path in the text field which is located next to the button. When the multimedia files appear you can select one of them and add it to the database. Before ending this operation, you have to complete the following resource fields:

; Type
: The type of the multimedia resource.
; Language
: The language in which the resource can be used.
; Associations
: The optional list of concepts associations.
; Multimedia resources
: This list determine if the new file is a new multimedia resource ('''New''' option) or a part of the translation of an existing multimedia resource into another language.

To confirm the addition of a new resource (or the translation into the selected language), you have to press the '''Add''' button at the bottom of the panel.

Note that the multimedia resources shown in the list of the edition panel depend on the language that you have chosen for the file. Furthermore, you cannot add more than one file of the same language to one particular multimedia resource.

= Add Batch Tab =

[[File:Edito_resources_batch_en.png|right|thumb|600px|Add Batch Tab]]

In this tab, you can add many multimedia resources to the database at the same time.

Like in the previous case, you have to select the source directory which contains the multimedia files.

To select the desired files individually, press '''CTRL''' key and left-click on the mouse. To select a range of consecutive files, press '''Shift''' and left-click. When you have selected all the desired files, go to the panel on the right and choose the options that will be used by the batch process:

; Language
: The language in which the resource can be used.
; Concepts
: By checking this checkbox, a new concept will be created for each multimedia file (if it doesn't already exist). Each new concept will be named after its multimedia file. In addition, each new multimedia resource will be associated with the corresponding concept.
; Relations
: If you check this checkbox, the default relations "begins with", "contains" and "ends with" will be created when the concept is saved. That will only happen if the '''Concepts''' checkbox is also checked.

The last remaining step is pressing the '''Add''' button. As a result, the batch of multimedia resources is added to the database.

Observe that this method cannot be used to add translation files to current multimedia resources. That task can only be done in the '''Add Resources''' tab.

[[Category:Edito]]
[[es: Pestaña_Recursos_Multimedia]]

Multimedia Resources Tab

2011-10-18T13:19:25Z

Daniel Héctor Stolfi Rosso:

In the [[Multimedia Resources Tab]], part of the [[Edito]] application, you can create, modify or delete multimedia resources. Besides, resources can be associated with concepts or you can even add new files of different languages to an existing multimedia resource.

Note that multimedia resources must have a description in the same language as the user interface, or in the ''neutral'' language, in order to be well shown in the multimedia resource tree.

__TOC__

= Modify Resources Tab =

[[File:Edito_resources_modify_en.png|right|thumb|600px|Multimedia Resources Tab]]

This tab contains the multimedia resource tree on the left; the resources list showing the resources filtered by the current selection, in the central zone; and the details of the chosen file, in the panel on the right.

Note that you can change the preview size and the order of the multimedia resources in the central list, using the controls at the top of the central panel.

Each file has the following fields:

; File
: The name of the multimedia file.
; Type
: The type of the multimedia resource.
; Language
: The language in which the resource can be used.
; Image
: The image that represents the multimedia resource.
; Associations
: The list of concepts that this resource represents.

== Modify a multimedia resource ==

To modify an existing multimedia resource, you have to select it from the resources list, make the desired modifications and finally, press the '''Save''' button to confirm changes.

Note that each multimedia resource can be associated with several files (one for each language) in order to provide specific representations for all the available languages.

Finally, you have to keep in mind that if you add a concept to the '''Association List''', you will get the same results as by dragging the multimedia resource over the '''Concepts - Resources Panel''' in the [[Concepts Tab]].

== Delete a multimedia resource ==

In order to delete a multimedia resource, you have to select it from the resources list and press the '''Delete''' button. Then, you have to confirm the deletion in the security dialogue that will appear on the screen.

= Add Resources Tab =

[[File:Edito_resources_add.png|right|thumb|600px|Add Resources Tab]]

In this tab, you can add multimedia resources to the database one by one.

First, you have to select the source directory where the multimedia files are. To do it, use the button with the folder icon or write the complete path in the text field which is located next to the button. When the multimedia files appear you can select one of them and add it to the database. Before ending this operation, you have to complete the following resource fields:

; Type
: The type of the multimedia resource.
; Language
: The language in which the resource can be used.
; Associations
: The optional list of concepts associations.
; Multimedia resources
: This list determine if the new file is a new multimedia resource ('''New''' option) or a part of the translation of an existing multimedia resource into another.

To confirm the addition of a new resource (or the translation into the selected language), you have to press the '''Add''' button at the bottom of the panel.

Note that the multimedia resources shown in the list of the edition panel depend on the language that you have chosen for the file. Furthermore, you cannot add more than one file of the same language to one particular multimedia resource.

= Add Batch Tab =

[[File:Edito_resources_batch_en.png|right|thumb|600px|Add Batch Tab]]

In this tab, you can add many multimedia resources to the database at the same time.

Like in the previous case, you have to select the source directory which contains the multimedia files. To select the desired files individually, press '''CTRL''' key and left-click on the mouse. To select a range of consecutive files, press '''Shift''' and left-click. When you have selected all the desired files, go to the panel on the right and choose the options that will be used by the batch process:

; Language
: The language in which the resource can be used.
; Concepts
: By checking this checkbox, a new concept will be created for each multimedia file (if it doesn't exist). Each new concept will be named after its multimedia file. In addition, each new multimedia resource will be associated with the corresponding concept.
; Relations
: If you check this checkbox, the default relations "begins with", "contains" and "ends with" will be created when the concept is saved. That will only happen if the '''Concepts''' checkbox is also checked.

The last remaining step is pressing the '''Add''' button. As a result, the batch of multimedia resources is added to the database.

Observe that this method cannot be used to add translation files to current multimedia resources. That task can only be done in the '''Add Resources''' tab.

[[Category:Edito]]
[[es: Pestaña_Recursos_Multimedia]]

Category:Exercises

2011-10-18T09:43:11Z

Daniel Héctor Stolfi Rosso: Created page with 'Exercises of the Applications of the [http://patio.lcc.uma.es/patio/index.php?lang=en PATIO project].'

Exercises of the [[:Category:Applications|Applications]] of the [http://patio.lcc.uma.es/patio/index.php?lang=en PATIO project].

Log

2011-10-18T09:40:52Z

Daniel Héctor Stolfi Rosso:

A [[Log]] file from one [[:Category:Exercises|Exercise]] consists in a [http://en.wikipedia.org/wiki/XML XML] file which is divided in four sections at the most:

; Header
: Here are defined the type of exercise, the pupil code, the date and mode of the execution and window's size in which the exercise has been executed.
; ''Exercise'' section
: Contains information about the exercise. This section is optional.
; ''AbstractLog'' section
: Contains the high-level events of the exercise.
; ''MouseLog'' section
: Contains the low-level events of the pointer device.
; ''PaintedPointsLog'' section
: Contains the low-level events of the drawing panel.

Notice that the data contained in the ''exercise'' and ''abstracLog'' sections depends on the exercise type.

Finally, in the ''mouseLog'' section only can be events of these kind:

* Pointer press.
* Pointer drag.
* Pointer release.
* Pointer activation.

While the ''paintedPointsLog'' section can also contains events of these kind:

* Colour change.
* Size change.
* Tool change.

[[es: Log]]

Log

2011-10-18T08:00:54Z

Daniel Héctor Stolfi Rosso: Created page with 'A Log file from one Exercise consists in a [http://en.wikipedia.org/wiki/XML XML] file which is divided at the most in four sections: ; Cabecera : En…'

A [[Log]] file from one [[:Category:Exercises|Exercise]] consists in a [http://en.wikipedia.org/wiki/XML XML] file which is divided at the most in four sections:

; Cabecera
: En donde se define el tipo de ejercicio, el código del alumno, la fecha y hora de ejecución, el modo de ejecución y el tamaño de la ventana en dónde se ejecutó.
; Sección ''exercise''
: Proporciona información respecto a la configuración del juego. Esta sección es opcional.
; Sección ''abstractLog''
: Contiene los eventos de alto nivel del juego.
; Sección ''mouseLog''
: Contiene los eventos de bajo nivel correspondientes al puntero.
; Sección ''paintedPointsLog''
: Contiene los eventos de bajo nivel correspondientes al panel de dibujo.

Nótese que mientras la información situada dentro de las secciones ''exercise'' y ''abstracLog'' dependerá principalmente del tipo de ejercicio.

Por último, dentro de la sección ''mouseLog'' sólo se admitirán eventos del tipo:

* Pulsación del puntero.
* Arrastre del puntero.
* Liberación del puntero.
* Activación del puntero.

Mientras que dentro de la sección ''paintedPointsLog'' podrán encontrarse también los siguientes tipos de eventos de dibujo:

* Cambio de color.
* Cambio de tamaño.
* Cambio de herramienta.

[[es: Log]]

Log Selection Tab

2011-10-18T07:50:47Z

Daniel Héctor Stolfi Rosso: /* Preview export */

[[File:Log_logs_selection_en.png|right|thumb|550px|Log Selection Tab]]

The [[Log Selection Tab]], part of the [[LogProcessor]] application, is divided in a top panel containing several buttons in order to execute the application's processes and [[Configuration Panel|configure]] it. While in the central zone, there is the filter panel, so you can select the set of [[Log]]s to work with.

__TOC__

= Filters =

To select the logs to be analysed, the application has several filters which depend on each other. The right order to filter Logs is from left to right, in other words, starting with [[Session|Sessions]] and ending with [[Log]]s.

Note that you can select from all filters, a number of items using '''Control''' ('''Command''' in Mac) plus left-click to select individually or using '''Shift''' plus left-click to select a consecutive range of items. Also, you can use the '''Select all''' button, placed into each filter, to select all the filter items easily.

The available filters are:

; Sessions
: You can select the [[Session|Sessions]] of the tests pupils have done or the special item called [['''-- No session --''']] which filters all the logs from [[:Category:Exercises|Exercises]] not included in any session.

; Pupils
: This filter shows the list of the [[Pupil]]s which have done exercises in the sessions you select in the previous filter.

; Exercises
: This filter allows choose the [[Exercise]]s done by the previously selected pupils and sessions.

; Logs
: Finally, this filter shows the [[Log]]s belonging to all the previous filters. Selecting at least one of them allows you to execute the available analysis from the top button panel of this tab.

= Operations =

When the filters have been applied and logs have been selected, you will have to choose one process option from the available ones.

== Analyse ==

This process starts the analysis of the selected logs. Depending of the [[:Category:Applications|Application]] and the kind of [[:Category:Exercises|Exercise]], the analysis will obtain different information from logs. Usually it will consists in answering times, number of hits and fails, etc. The results will be shown in the [[Results Tab]].

== Preview export ==

The analysis results can be exported in [http://en.wikipedia.org/wiki/Comma-separated_values CSV] format in order to be processed by external programs. This operation can be done pressing the '''Preview Export''' button or from the [[Export Data Tab]].

== Graphs ==

For exercises of the [[Diferencias Exercise|Diferencias]] and [[Objetos Escena Exercise|Objetos Escena]] types, you can do a graphical analysis of pupil's clicks and points density, comparing several logs for the same type of exercise. In this way you can detect where pupils are in focus, or in other words, where they concentrate their searches. This analysis is launched pressing the '''Graph''' button and the results are shown in the [[Results Tab]].

== Patterns ==

In the same way, exercises of the [[Diferencias Exercise|Diferencias]] and [[Objetos Escena Exercise|Objetos Escena]] types can be analysed at click level. The pattern analysis is made by dividing the background picture in a grid and assigning a symbol to each cell. So, each click inside a cell will add a new symbol to the pattern. This analysis can be executed pressing on the '''Pattern''' button and the results are shown in the [[Results Tab]].

= Load from file =

You can also read log files from the disc in order to analyse them without using the database. To do that, you have to press the '''Load from file''' button and select the desire files in the dialogue which will appear on the screen.

[[Category:LogProcessor]]
[[es: Pestaña_Selección_de_Logs]]