8/13/2019 User Manual En iTutor
1/61
www.intelligent tutor.eu
Intelligent Tutoring for Life Long Learning
With the support of the
Lifelong Learning Programme
of the European Union.
Lifelong Learning Programme
KA3 - ICT
Project number:
519058-LLP-1-2011-1-IT-KA3-KA3MP
USER MANUALSER MANUALUSER MANUALSER MANUALUSER MANUAL
8/13/2019 User Manual En iTutor
2/61
1
ITUTORCONFIGURATION .......................................................................................................................................3
CREATINGTHEDOCUMENTCORPUSFORBUILDINGTHEITUTORSEMANTICSPACE .......................................................................... 3
Criteriaforpreparingtextsanddocuments ............................................................................................................... 4
Managingmorethanonelanguage .......................................................................................................................... 5
Interactingwiththehiddendatabase....................................................................................................................... . 5
Insertingadefinition .................................................................................................................................................. 7
Insertinganinsight .................................................................................................................................................... 7
Insertinganorganizationdocument.......................................................................................................................... 7
Exportingadatabase ................................................................................................................................................. 7
Importingadatabase................................................................................................................................................. 8
Creatinganew
empty
database ................................................................................................................................ 8
LoadingthestructureiftheITUTORdatabaseinthenewdatabase........................................................................8
Loadingdata .............................................................................................................................................................. 9
Readingdata........................................................................................................................... ................................. 10
THEITUTORMAPSTHEORETICALBACKGROUND........................................................................................................11
ITUTORCONCEPTUALSPACE ............................................................................................................................................11
TEACHER/ADMINMANUAL .................................................................................................................................... 16
MONITORING............................................................................................................................................................... 47
PROFILING .......................................................................................................................................................................50
TIMELINEVIEW .................................................................................................................................................................52
Options..................................................................................................................................................................... 53
Installation ............................................................................................................................................................... 53
ALERTER..........................................................................................................................................................................54
Installation ............................................................................................................................................................... 57
8/13/2019 User Manual En iTutor
3/61
2
OVERVIEW
ITUTORisintendedtoprovideintelligentsupporttothethreemainactorsinvolvedinthelearningprocess
throughaVLE:
-Theinstructionaldesigner
-Thetutor
-Thestudent.
Thepreviousactornamesaretobeintendedasroles:thesameusercanhavedifferentroles
wheninteractingwiththesystembutatdifferenttimes.Infewwords,ateachercanbeaninstructional
designerwhenshe/heplansthecoursematerials,devisesthecriteriatobemettoaccomplisha
pedagogicalgoal,andsoon.Thesameteacherisatutorwhenshe/heinteractswiththeVLEtomonitorthe
students,andtoassesstheirresults.
8/13/2019 User Manual En iTutor
4/61
3
I-TUTOR
CONFIGURATION
CreatingthedocumentcorpusforbuildingtheI-
TUTORsemanticspace
OneofthekeyfeaturesinITUTORisthedomainconceptmap,whichformsthebaseforaseriesofmap
based visualizations that are related to monitoring both social and task completion activities of the
studentsaswellasenablingteacherselfreflectionaboutthehomogeneityofthematerialswithrespectto
thetopics
covered
in
the
domain.
Duetothemultilanguageimplementationrequirement,suchatoolreliesonstatisticalanalysisoftextthat
isbagofwordsapproach.Inparticular,LatentSemanticAnalysis(LSA)hasbeenused,whichisaimedat
buildingasemanticspaceextractedfromadocumentcorpusonthebasisoftheoccurrencefrequencyof
a set of meaningful terms in each document of the corpus. The map will depict emergent semantic
correlationsbetweensuchtermsduetothenumberofdocumentsdealingwiththem.
When creating a new ITUTOR course, some requirements have to be satisfied in order to generate a
correctsemanticspace.Weneedadocumentcorpusthatiswideenoughtogainstatisticalsignificancein
representingthecoursecontents.Tothisaim,suitabletoolshavebeendevelopedtocreatethecorpus.
Thisdocumentisaddressedtouserswithateacher/administratorroleinMoodle(i.e.thepersonincharge
tocreateanewcourse)andexplainstheuseofsuchtools.
Whena teacher/administrator createsanew ITUTOR course,Moodlewill insertautomaticallyahidden
databaseasasectionofthecourse.Alltheinformationneededtocreatethesemanticspacewillgohere.As
ahiddensection,thedatabasewillnotbevisibletothestudents.
Thedatabaseacceptsthreekindsofdocuments:
Definitions
Insights,i.e.documentsusedtodeepenthetopicscoveredinthecourse
Organization, i.e.documents insupportofcoursemanagement:courseschedules,administrative
stuffandsoon(notusedtobuildthesemanticspace)
Definitions are used to insert a brief description of a key concept to be dealt with and developed
throughoutthecourse.Eachdefinitionconsistsofthreefields:
Atitle,i.e.theactualnameofthekeyconcept
Afieldcontainingtagsforannotatingthekeyconcept
Atextfieldcontainingthedescriptionofthekeyconcept
Thenameofakeyconceptcanbeidentifiedwithasinglewordorevenwithamultiwordterm(maybeno
morethantwoorthreewords:i.e.knowledgebasesmanagement).Eachkeyconceptcanbeassociated
8/13/2019 User Manual En iTutor
5/61
4
withotheronesandwithotherterms.Tothisaim,theteacher/administratorcanassociatetothedefinition
a setof tags.Tagsareeithera singlewordoramultiword asexplainedbefore.Tags are separatedby
commas.Eventually,theactualdescriptionofthekeyconcept isinsertedintothedatabaseusingthetext
field.
Please,
record
your
tags
and
key
concepts
apartfrom
the
database,
and
use
them
to
annotate
each single section you create in your Moodle course. You will have to create a hidden label in
eachsectionthatwillbeusedtowriteacommaseparatedlistofeitherkeyconceptsortagsthat
aresuitedtothesection.
Insightdocumentshavetodealwithaspecifictopicinthecourse.Theyshouldbeinasufficientnumberto
allowtheITUTORsystembuildingacomprehensivedescriptionofthedomain.Eachinsightismadeby:
Atitle
Asetoftagsforannotation
Theactual
document
Titlesshouldbeexpressiveenoughtodescribethedocumentcontent.Eachdocumentcanbeassociatedto
other terms and/or key concepts that aremeaningful in the course domains. As a consequence, the
teacher/administratorhastoassociateasetoftagstothedocuments.Suchtagscanbeeithertagsandkey
conceptsalreadyused fordefinitionsorcompletelynewwords.Tagsaresubject to thesame formatting
conditions explained before: commaseparated list of singleormultiplewords (i.e. two or threewords
separatedbyablankspace).Finally,thedocumentisafilethatisuploadedontotheMoodleplatform.
Organizationdocumentsareusefulonly for the teacher tomanageher/his course: theyarenotdirectly
relatedwiththecoursedomainandtheyrenotusedtobuildthesemanticspace.
Criteriaforpreparingtextsanddocuments
Whenbuildingthedocumentcorpus,theteacher/administratorhastofollowsomeguidelines.Thenumber
ofdocumentstobeuploaded/wrote intheMoodleplatformmustbehighenoughtoensureastatistical
significanceof the LSA.Currently, a minimum of three hundred (300) documents is highly recommended.
Please,avoidinsertingentirebooksassingledocuments.Asageneralguidelineadocumentshouldcovera
welldefinedandprecisetopic.Inparticular,documentsand/ortextsrelatedtoakeyconceptmustbevery
precisedescribing
only
the
concept
itself,
while
documents
and/or
texts
related
to
an
insight
can
cover
more than a key concept. Returning to the book example, a good strategy could be to upload each
subsectiondealingwithaparticulartopicinsideachapterasaseparatedocument.
Thefollowingformatsarerecognized:
PDF;
Doc;
Txt;
PowerPoint.
8/13/2019 User Manual En iTutor
6/61
When youprepare texts directly either by typesetting them or cuttingandpasting them in the
textareasofthedatabasepleaseavoidpendinghyphenations,uselesspendingfigurecaptions,
pagenumbering,headersandfooters,andalltheformattingstuff.
SuchtextisallnoisefortheLSAengineandcandecreasedramaticallytheperformanceofthesemantic
spaceand
the
quality
of
the
maps.
We
acknowledge
that
such
problems
can
be
present
in
those
files
that
youdownloadfromotherinformationsources.
Managingmorethanonelanguage
Currently, creating a semantic spacemade by terms coming from different languages is not possible.
Please,ALLTHEDATABASECONTENTMUSTBEWRITTENINTHESAMELANGUAGE.
Inthisrespect,content is:titles,tags,definitiontexts, filecontents. Insomecoursedomainsthereare
termscoming froma languageother thanthecourse languagethatarerelevant for the teacherand the
learner.Youcancopewith this issueeither treating the termasadefinitionorasanexplicit tag. In the
formercase,theforeigntermwillbeplacedinthedefinitiontitle,whileinthelatteritwillbeplacedinthe
textfieldcontainingtagsaccordingtothetagwritingrules.Suchtermswillbeautomaticallyaddedtothe
vocabularyofthecourselanguage.Moreover,theyrerelevanttermsfortheteacher,andwillbepreserved
fromautomaticfilteringthatisusedtopreprocessdatawhenbuildingthesemanticspace.
Interactingwiththehiddendatabase
Thefollowing imageshowsthesectioncontainingthehiddendatabaseasitappearswhencreatinganew
course.
Clickonthedatabasename,andyoullobtainthefollowingscreen.
ClickontheAddentrytabandyoullbeableto insertadocumentbelongingtowhatevertypology into
thedatabase,i.e.definitions,insights,andorganizationdocuments.
5
8/13/2019 User Manual En iTutor
7/61
TheuserclicksontheTYPEpulldownmenu,andselectsoneofthefollowing:
Insights
Definitions
Organization
6
8/13/2019 User Manual En iTutor
8/61
7
Insertingadefinition
Theuserfillsthefollowingfields:
TITLE:thenameofthekeyconcepttobedefinedgoeshere;
KEYWORDS:commaseparatedlistoftagsmadebyeithersingleormultiplewords;
TEXT:directwritingofthedescriptionofthekeyconcept.
Insertinganinsight
Theuserfillsthefollowingfields:
TITLE:thetitleofthedocumentasexplainedabovegoeshere;
KEYWORDS:comma
separated
list
of
tags
made
by
either
single
or
multiple
words;
Moreover, theusers clicks on the Choose a filebutton,which allows searching a file in the local file
systemintheuserscomputer.
Insertinganorganizationdocument
Theuserfillsthefollowingfields:
TITLE:the
title
of
the
document
goes
here;
KEYWORDS:commaseparatedlistoftagsmadebyeithersingleormultiplewords;
Moreover, theusers clickson the Choose a filebutton,which allows searching a file in the local file
systemintheuserscomputer.
Exportingadatabase
Ahiddendatabasecanbeexported tomake itavailable forgenerating thesemanticspaceofanother I
TUTORcourse.
This
functionality
has
been
devised
for
all
the
courses
sharing
acommon
set
of
key
concepts
andterms.Moreover,itispossibletothinkaboutanextendeddatabaseforcreatingacommonsemantic
spacethatissharedbymanycourses.
ToexportanITUTORhiddendatabaseasanadminuser:
Clickonthedatabasename
ClickonthePresetstab
ClickontheExportbutton
ClickontheExportentriesbutton
Please,donotmodifyexportoptions.
8/13/2019 User Manual En iTutor
9/61
Importingadatabase
Theoverallimportprocedureconsistsofthreesteps:
1. Creatinganemptydatabase
2. LoadingthestructureiftheITUTORdatabaseinthenewdatabase
3. Loadingdata.
Inwhatfollowsthepreviousstepsaredetailed.
Creatinganewemptydatabase
1. Createanewsection
2. Clickon
the
Turn
editing
on
button
and
onthe
Add
an
activity
pull
down
menu
for
actually
addinganactivitytothesection
3. Selectthedatabaseitem
4. SelecttheHideitemintheVisiblepulldownmenuinsideCommonmodulesettings
5. ClickontheSaveanddisplaybutton
LoadingthestructureiftheI-TUTORdatabaseinthenew
database
1. Clickonthedatabasename
2. Clickon
the
Presets
tab
3. ClickontheChooseafilebuttoninsideImportfromzipfile
4. SelectthefileexportedpreviouslyITUTORDATABASEpreset******.zip
8
8/13/2019 User Manual En iTutor
10/61
Loadingdata
1. ClickonImportentriesintheSettingsblock
2. ClickontheChooseafilebutton
3. Selectthefileyouhadexportedpreviously
4. ClickontheSubmitbutton
5.
9
8/13/2019 User Manual En iTutor
11/61
Readingdata
1. Clickonthedatabasename
2. ClickontheViewlistor Viewsingletab
3. IfyoureceivethemessageListtemplateisnotyetdefinedthen
a. Clickontemplate
b. ClickonSavetemplate(donotmodifyoptions)
4. ClickagainontheViewlistorViewsingletab
10
8/13/2019 User Manual En iTutor
12/61
11
THEI-TUTORMAPSTHEORETICALBACKGROUND
I-TUTOR
Conceptual
Space
TheITUTORConceptualspaceisabidimensionalsemanticspaceofkeywordsextractedfromthe
hiddendatabaseandfromthedidacticaldocumentsofthecourse;thekeywordsareclusterizedin
groupsandthosewhichare intothesameclusterarewordswiththesamemeaning(theymean
the same thing). Clusters are distributed so that neighboring clusters in the space contain
correlatedwords,i.e.wordsthatdonotmeanthesamethingbuthavesomeconceptualstatistical
relation(itwillbemoreclearnext).
The Latent Semantic Analysis paradigm
TheITUTORConceptualspaceiscomputedapplyingtheLatentSemanticAnalysis(LSA),thatisa
paradigmtoextractandrepresentthemeaningofwordsbystatistical;wordswereferareboth
the keywords specified by user in the hidden database and the words extracted from the
didactical documentsuploaded in theMoodle platforms for the course.The LSA paradigm uses
matrixdatastructureforrepresentingdocumentsandtheirwords:generally,amatrixisagridof
cellsorganized inrowsandcolumns.Acell is identifiedby itscoordinates(i,j)where i istherow
andj the column.According to the LSA paradigm thedocumentscollection is represented as a
matrixAwhere
each
row
is
associated
to
aword,
and
each
column
is
associated
to
adocument.
Thecontentofthe(i,j)thcellofAisaweightoftheithwordfrequencyinthejthdocument;this
weight is initially the number of times given words appears in the document.
IntheLSAparadigmthematrixAisthenapproximatedbythesingularvaluedecomposition(SVD)
technique (Landaueretal.1998) for reducing itsdimensions.Thisdecompositionoutputs three
differentmatrix and it aims to capture themajor associational structure in thematrix A and
removesthenoisegivenbytheaccidentalvariabilityoftermsappearinginthesamecontext.After
theseprocesses,eachwordisrepresentedbyavector,thatisarowofaspecificmatrixoutputted
fromtheSVDprocess.Thesetofthesevectorsistheconceptual/semanticspace.
Thesemanticspacecanbecreatedwheneveruserwants.Shecan insertnewkeywordsornew
documents and chooses to rebuild the semantic space when she considers it necessary.
Alternatively,only fordocumentsshecanproject them in thespacewithoutrecomputing it,as
will bemore clear follow. For keywords instead, she can change theweights theyhave in the
dssheretainsmoresignificant.space,highlightingthewor
The SelfOrganized Maps
Forclusteringkeywordsanddocumentsrepresentedasvectorsandforshowingthembyamap,a
selforganizingneuralnetwork,andinparticulartheselforganizingfeaturemap(SOM)isused.
8/13/2019 User Manual En iTutor
13/61
12
In thisneuralnetwork,neuronsareorganized ina lattice,usually inaone or twodimensional
space;usingatwodimensionalSOMnetwork,itispossibletoobtainamapofinputspacewhere
closeness betweenunitsor clusters in themap represents closeness of the input vectors. This
network has been used to classify information and documents in "informationmaps" in the I
TUTORConceptual
space
created
by
performing
LSA
on
the
various
corpora
of
learning
materials.
Asaconsequence,twodocumentswhosesemanticsisclose,areputtogetherinthesamecluster.
Givenasemanticspace(theLSAandthecorrespondentkeywords),theSOMcanbeused intwo
differentway:
1) forcing learning: in this case the neurons are trained for recognizing input and a new
classification ismade. Itmeans that the inputvectorsareusedas learningsetandSOM
buildsits"memory"forclusteringnewinput.WemeanthisstepasnewSOMcreation,and
allowsuser tocreatedifferentclustersdistributionon thesemanticspaceonwhichnext
classifythe
documents;
2) clustering input: in thiscase,givenaSOM (whenneuronsarealready trained), the input
vectorsareclassifiedby theSOM itself. In the ITUTORplugin,usercanchoose theSOM
shebuiltandprefers.Documentswillhavedifferentdistributioninthespaceaccordingto
theselectedSOM.
TheoutputoftheSOMprocessistheITUTORConceptualspacethathasthreelevelsofdepth;the
keywordsathighlevelshavehighweightsrespecttowordsatlowestlevelsandsotheyaremost
frequents. User can modify this distribution according her evaluations, as next shown. The
bythe
ITUTOR
Conceptual
Map.
Conceptual
space
is
represented
The ITUTOR Conceptual Map
The ITUTORConceptualMap isagraphicalrepresentationofaSOM. Inparticular, the ITUTOR
ConceptualMaplooksasfollow:
8/13/2019 User Manual En iTutor
14/61
Themaphasalatticebackgroundofrectangleswithsamewidthandheight,oneforeachneuron
oftheSOM.Forexample,inthefigurethemaprepresentsaSOMwith25neurons(5rowsper5
columns).Themapalsoshows theclustersgeneratedbytheSOMclassification;acluster in the
mapisthesetofcellswiththesamecolor.Theformofaclusterdependsbythecellsofwhichis
composed. Different shades of color for the same cluster means the documents distribution
amongthe
cluster
itself.
In
particular,
acell
with
more
documents
has
more
luminance
than
othersinthesamecluster.Lowluminancemeansthattherearefewerdocuments,highluminance
meansthattherearemanydocuments.
Once yourmousehover isonacluster,a labelwith thekeywords for thecell is shownon the
eights.mousehover,orderedaccordingtotheirw
Managing the ITUTOR Conceptual Map
Themain featureof the ITUTORMapplugin is thepossibility to tailor the ITUTORConceptual
space(LSA,
Keywords
weights
and
SOM),
hence
the
correspondent
map:
user
can
create
different
conceptualspacesmapsandshecanmanipulatetheITUTORConceptualspacecomponentsuntil
she finds the conceptual map she enjoys. Once a conceptual map is chosen, each other
functionalitieswillrefertoit.Inparticular,aconceptualmapmaybemanipulatedthrough:
1) newconceptualspacedefinition:itmeansanewLSAcomputation.Thistaskisusefulwhen
theunderlyingdataaremodified(newkeywordsordocumentsareuploadedinthe
platform)andanewconceptualdistributioncouldberequired;
2) newSOMdefinition:chosentheconceptualspace(theLSA),usercantrainanewSOMfor
recomputing
the
clusters
of
documents.
This
task
modifies
only
the
cluster
distribution
on
theconceptualspace,butnotthesemanticspacefromLSA;
13
8/13/2019 User Manual En iTutor
15/61
14
3) newweightdefinitionforkeywords:chosetheSOMandhencetheclustersdistribution,
usercanmodifytheweightofthekeywordsinthespacewiththeaimtohighlightsome
wordsrespecttoothersbringingthemathighlevelsofthemap.
Themapcanalsobemodifiedwhennewdocumentsareuploaded in theplatform. In thiscase
usercanmaketwodifferentchoices:
1) useaspecificsemanticspaceandaSOMandprojectthenewdocumentsinthisspace(the
documents are automatically clustered in the space by SOM); this projection will not
modifythesemanticspace;
2) buildanewsemanticspace (andsoanewSOM) thatwill include thenewdocuments.A
newspaceiscreatedconsideringtheeffectsofthesenewdocuments.
I-TUTORActivitySpace
TheITUTORActivitySpaceisgeneratedwhendocumentsrelatedtothestudents/classesactivities
areprojectedintheITUTORConceptualspace.Inparticular,thedocumentswereferarecalledas
activitydocuments(fordistinguishingthemfromthedidacticalones)andaredocumentsretrieved
fromtheMoodledatabaseandrelatedtoforum,wikispagesandeachotherdocumentsthatthe
studentsor groupsof students insert into theplatformduring the course (asheranswers to a
questionnaire). The underlying semantic space and the SOM are computed as shown in the
previous step, andonly newdocuments areprojected in the conceptual space selectedby the
user. The activity space is graphically represented as the conceptual one, with the obvious
differenceof
the
colors
of
the
cells,
because
in
this
case
there
are
more
documents
that
are
not
consideredintheconceptualcaseandmorecellsarefilledtroughdifferentlevelsofgray.
ThroughtheITUTORActivityspace ispossibletomonitorthedistributionamongtheconceptual
space of the students (or groups of students) activities, and both tutor and student can take
ptualdislocationduringthecourse.cognizanceabouttheirconce
The ITUTOR Activity Map
The ITUTORActivityMap graphically represents the ITUTORActivity space.As forConceptual
Map,it
is
aset
of
clusters
with
different
colors.
UsingtheMaps
The ITUTORpluginprovidesa functionality forobservingsomedocumentsdistributiononboth
conceptualand activity spaces; it isuseful forexample for tutorwhen shewants tomonitor a
particularstudentorgroupofstudents,watchingthedislocationoftheiractivitiesinthespace.
Inparticular,
atutor
can:
8/13/2019 User Manual En iTutor
16/61
1) view the distribution among the full didactical documents in the conceptual space of a
particularsectionofthecourse;
2) viewthedistributionamongthefulldidacticalandactivitydocumentsintheactivityspace
of the activity documents of a particular student; in thisway the tutor can view the
student'spartecipation
in
forum
or
wikis,
or
her
progression
in
the
study
of
the
didactical
documents;
3) viewthedistributionamongthefulldidacticalandactivitydocumentsintheactivityspace
oftheactivitydocumentsofaparticulargroupofstudent;inthiswaythetutorcanview
thegroup'spartecipationinforumorwikis,oritsprogressioninthestudyofthedidactical
documents.
At the other side, a student can view the distribution among the full didactical and activity
documents in the activity space of her activity documents; in this way she can evaluate her
partecipation
in
forum
or
wikisor
her
progression
in
the
study
of
the
didactical
documents,
motivatingtheselfregulationlearning.
Themarkeradopted forhightlighting thecells involved isGoogleMapmarker likeand looksas
follow:
The dimension of themarker for a cell depends by thepercentage computed considering the
number
of
the
involved
documents
on
the
total
documents
contained
in
the
cell
itself.
In
particular:
1) for a student, the involved documents are related to the student himself; they are the
forumpages studenthaspartecipatedandwikipagesand thedidacticaldocuments she
hasopenedatleastonce;
2) foragroupofstudents,theinvolveddocumentsarerelatedtothegroupofstudents;they
aretheforumpagesthestudentsofthegrouphavepartecipatedandwikipagesandthe
didacticaldocumentsstudentsofthegrouphaveopenedatleastonce;
3) forasection,theinvolveddocumentsarethedocumentsuploadedbytutorinthespecific
section.
TheseinformationareextractedfromMoodledatabaseandareretrievedontheflyeachtimethe
userwantsknowthedistributionofinvolveddocumentsinthesemanticspace(activityspacefor
thefirsttwocases,conceptualspaceforthelast).Thedistributionishighlightedmarkingthecells
that contain documents by one markerwith specific dimension that depends by the defined
percentage.Thepercentageisalsorepresentedintotalactivityfieldofthelabel.
Forexample, inthenextmapsomecellsaremarkedbysmallestmarkers; itmeansthat inthese
cellstherearesmallpercentagesofinvolveddocumentsrespecttothetotalnumberofdocuments
containedin
the
cell
itself
15
8/13/2019 User Manual En iTutor
17/61
TEACHER/ADMINMANUAL
InthissectionwewillexplainhowtouseITUTORmapsplugin.
Inordertousethisplugin,theloggeduserneedstoclickontheITUTORMapsPluginblock,available
insideacourse,usuallyonthetopleftposition.
16
8/13/2019 User Manual En iTutor
18/61
TheITUTOR
plugin
block
contains
four
main
links,
the
first
one,
I
TUTOR
Maps
once
clicked
will
open
ablankpagecontainingtheITUTORMapsmainpage.
TheITUTORpluginaimsMoodleuserstocreatetheconceptualandactivityspacesonwhichshe
canmanage,monitorandretrieveinformationabouthercourseanditsparticipants.
17
8/13/2019 User Manual En iTutor
19/61
TheITUTORmapsmainpagelooksasfollow;amenubarallowstoaccesstothemainITUTOR
pluginfunctionalitiesandithasfouroptions:"ConceptualMap","ActivityMap","UseMaps"and
"Snapshots".
The "ConceptualMap"widgethas adropdown submenuwith the "GenerateConceptualMAP"
and "Archive MAPS" options. First functionality allows to create a new semantic space for
generating conceptualmaps. This task creates the set of clusters of documents according to a
contentbasedapproach:aweightgiven tothewords inthedocumentsdeterminestheclass to
whichadocumentisassigned.Thisweightisinitiallythenumberoftimesgivenwordsappearsina
document.Thenweightcanbethenmodifiedaccordingyourneedsandevaluationsthroughthe
specificpluginfunctionality.DuringthistaskrelevantwordsaredistributedinthebidimensionalI
TUTOR semantic space: itmeans thatneighboringwords in the space arewords thathave the
samesemanticsense.
ConceptualMapfunctions
ConceptualMap
option
opens
adrop
down
menu
that
allows
to
manage
all
funcionalities
related
totheITUTORConceptualmaps.Inparticular,usercangenerateaconceptualmaporretrieved
oldconceptualmapsfromthearchive.
TheoptionGenerateConceputalMAPallowsusertoperform4differentactions:
1) CreateanewMAP;itcreatesofanewconceptualspace,sobothanewsemanticspaceby
LSAandanewSOMarecomputedbasingonthestateofthehiddenandMoodledatabase
atthemomentofthiscreation;
2)
Extend
MAP:
it
adds
new
documents
to
the
existent
conceptual
space,
projecting
them
in
themapanddoesnotrecomputetheunderlyingspace;
18
8/13/2019 User Manual En iTutor
20/61
3) CustomizeMAP:itallowsusertotailorthemapaccordingherevaluationsandneeds.Forviewinganewconceptualmapusercancombinethemainfeaturesofthemap;shecan
arrangeanexistentsemanticspace,anexistentSOMandanexistentlistofkeywordswith
aweightdistributionandviewtheresults;
4) RedrawMap: itallowsusertomodifytheweightsofthekeywordsformanagingtheirlevelsdistributioninthemap.
Eachpointisnextdescribed.
ConceptualMap GenerateConceptualMAPOption
NewMAPstepbystep
1.AnewLSAandanewSOMwillbegenerated
consideringthehiddenandMoodledatabaseat
thismomentandanewITUTORConceptualMap
iscreated.
2. ITUTORasksconfirmationaboutthisoperation.
3.DuringMapgeneration, ITUTOR
alerts you to wait the end of all
computations (LSA and SOM
creations).
4.
When
I
TUTOR
ends
the
process,
it
asks
you
to
give
a
name
to
this
new
conceptualmap.
19
8/13/2019 User Manual En iTutor
21/61
5.Thenew
conceptual
mapisthen
stored,anda
messageof
successfully
creationis
shown.
6.Next,ITUTORalertsyouthatthecorrespondentactivityspacewillbecreatedandremember
youthatyoucanchangetheconceptualandactivitymapthroughthecorrespondentfunctionality.
20
6.1OnceyouclickOK,ITUTORtellsyou
towait
the
end
of
the
process
(the
activityspacecreation,i.e.the
8/13/2019 User Manual En iTutor
22/61
projectionoftheactivitydocumentsontheconceptualspacenewlycreated).
6.2AttheendITUTORasksyoutospecifyanameforthisnewactivity
map
6.3...andstoresitinitsarchive.
ExtendMAPSTEPBYSTEP
1.ForprojectingintheITUTORSemantic
spacenewdocumentsuploadedinthe
platformafter
space
creation,
you
can
select
ExtendMapoption.
21
8/13/2019 User Manual En iTutor
23/61
2.ITUTORallows
youtoselectthe
documentsyou
wantaddinthe
existentsemantic
space;after
document
selection,ITUTOR
projectstheminto
thespacebySOM,
andyoucannext
view
the
new
documentsinthe
map.
CustomizeMAPstepbystep
1.OnceyouselectedCustomizeMapinthedrop
downmenu....
2....ITUTORhelpsyoufortailoringyour
idealmap;youfirstmust choosethe
semanticspace
computed
by
LSA
amongthatyouhavepreviously
created.
22
8/13/2019 User Manual En iTutor
24/61
3.ITUTORshowsyoualistofsemanticspacesbuiltuntilthatmoment(orderedbyname,data
creationandthecorrespondentmapscreatedbasingonit,thatcanbeconceptual,socialorother
withprojected
documents).You
canchoose
one
of
thesespacesby
buttonradio,and
thenyoucan
submityourchoice
Afteryour
submission,I
TUTORkeeps"at
mind"theSeman
spaceyou
have
chosen
23
.
tic
fornext
steps.
sele
Key
p
therea
willrefertothem.
4. ITUTOR
reportsyouthe
semanticspace
ctionadding
theredLSA+
wordspuzzle
iecesinthe
interface.It
meansthatonce
youhavechosen
asemanticspace,
reasetof
keywords
computedbythis
LSAandnextyou
8/13/2019 User Manual En iTutor
25/61
5.Nextyoucanmodifytheweightdistribution,changingtheweightforthekeywordsyouwant.
5.1. Clickingonthenoteiconyoucanmodifytheweightforthe
correspondentword
5.2.Alistofpossibleweightallowsyoutosetamorehighorlow
weightthanthecurrent.
24
8/13/2019 User Manual En iTutor
26/61
5.3. ITUTOR
reportsyou
theweight
modification
addingthe
yellow.
Weightpuzzle
piecesinthe
interface.
6.Next,youcan
choosetheSOM
amongthose
previouslycreated;in
thiswayyoucan
selectonewayfor
clusteringyour
documents.The
semantic
space
is
fixed,anddifferent
clustersdistribution
canmadeonit
throughdifferent
SOM.ITUTORshows
youthelistofall
existentSOMforthe
chosensemanticspace.
25
8/13/2019 User Manual En iTutor
27/61
7.Finallyallcomponents
aredefinedsoyoucan
generatethemap
accordingthepreference
youhaveselected.Your
idealmapistailoredand
youcanviewitintheI
TUTORarchive.
RedrawMapSTEPBYSTEP
1.OnceyouhaveselectedRedrawMAPoption
fromdropdownmenuyoucancomputed
differentclusterdistributiononthesame
semanticspace(LSA).Aclearexplanationis
showntoyouinthe
interface.
26
2.Onceyouhaveselected
thesemanticspace,you
cantrydifferentSOM
8/13/2019 User Manual En iTutor
28/61
distribution,learninganewSOM.
3.Asmallmappreviewis
shownforviewingthenew
clusterdistribution,
and
for
allowingyouthechoicethe
regionshapeyouenjoy.
ArchiveMAPSOption
1.OnceyouselectArchiveMAPoption
2.ITUTOR
wsyoualist
ofall
conceptual
mapsandyou
canviewoneof
themby
clickingonthe
sho
27
8/13/2019 User Manual En iTutor
29/61
correspondenteye.
3.The
correspondentI
TUTORconceputal
Mapisshownand
youcanbrowseit
usingarrows
or
clickingonitto
zoomazone.
Thereare3leve
ofzooming.Als
thereisalevel
wheretheof
documents
containedinthe
zoomedcell
are
listed.
les
o,
ActivityMapfunctions
ThesecondfunctionalityinthemainpageofIItutorpluginistheActivityMapoption,thatallows
youtousetheactivitymap.Therearetwosuboptions:ExtendMAPandArchiveMAP.
ConsideringthattheactivityMAPisautomaticallycreatedforeachconceptualmap,throughthis
functionyoucanusethecurrentactivitymap(thatistheactivitymapcorrespondenttothe
currentsetconceptualmap).
28
8/13/2019 User Manual En iTutor
30/61
ExtendMAPOption
Usethisoptiontoprojectnewactivitydocumentsintoanexistentactivitymap.
1.ITUTORshows
youalist
of
the
activitymaps.You
canchoosethe
mapyouwantto
extendandI
TUTORaddstoit
thenewactivity
documents.
ArchiveMAPSOption
Usethisoptionforviewinganactivitymap.
1.ITUTORshows
youalist
of
all
activitymaps.
29
8/13/2019 User Manual En iTutor
31/61
2.Clickontheeyeiconforviewingaspecificactivitymap
30
3.andITUTOR
showsyouthe
correspondent
map.Youcan
browse
it
through
thearrowsand
clickingonthecell
forzooming
fortheconceptua
map,theactivity
mapmaybe
zoomedto3lev
ofdepth;thereis
alsoaforthlevel
thatshows
the
list
ofdocuments
containedinthe
s
.Like
l
els
zoomedcell.
UseMAPfunctions
Onceyouhaveselectedthisoption,adropdownmenushowsyou4differentactions:
base.The
activity
map
is
the
ITUTOR
Conceptualmapwithactivitydocumentsprojected;
rtecipation in forum or wikis, or her progression in the study of the didactical
documents;
group'spartecipationinforumorwikis,oritsprogressioninthestudyofthedidacticaldocuments;
1)Domain:forviewingthecurrentconceptualmapandactivitymap.Theconceptualmapisthe
mapof
the
course
you
have
selected
(or
tailored)
as
map
2)Student: forviewingtheactivitydocumentsdistributionamong the fulldidacticalandactivity
documents intheactivityspaceoftheofaparticularstudent; inthiswaythetutorcanviewthe
student's pa
3)Group: for viewing the activitydocumentsdistribution among the fulldidactical and activity
documentsintheactivityspaceofaparticulargroupofstudent;inthiswaythetutorcanviewthe
8/13/2019 User Manual En iTutor
32/61
4)Section:forviewingthedistributionamongthefulldidacticaldocumentsintheconceptual
spaceofaparticularsectionofthecourse.
Domain
ConceptualMAPS
option
ITUTORshowsyouthe
currentsetconceptual
mapandyoucanbrowse
it.
Domain ActivityMAPoption
ITUTORshowsyouthecorrespondentactivitymaptothesetconceptualmapandyoucanbrowse
it.
31
8/13/2019 User Manual En iTutor
33/61
8/13/2019 User Manual En iTutor
34/61
studentactivity,asexplainedintheColoringtheMapsection.Inparticular,theConceptualview
showstheconceptualmappaintedaccordingtothepercentageofclickeddocumentbystudent,
whiletheActivityviewshowstheactivitymappaintedaccordingtothepercentageofactivity
documentsofthestudent,asshown.
2.ClickonthefoldericontoviewthepaintedConceptualMapofastudent
2.1 ITUTORshowsyou theconceptualMapof thecorrespondentstudentpaintedaccording to
thepercentageofthedidacticaldocumentsonwhichstudenthasclickedamongthetotalnumber
ofdidacticaldocumentscontainedinthecell.
3.Click
on
the
chat
icon
to
view
the
painted
Activity
Map
of
astudent
3.1ITUTORshowsyoutheActivityMapofthecorrespondentstudentpaintedaccordingtothe
percentageof
documents
related
to
the
student
among
the
total
number
of
activity
documents
containedinthecell.
4.Foreachkindofmap,youcanfrozenthemapitselfclickingonthephotoicon
33
8/13/2019 User Manual En iTutor
35/61
4.1ITUTORasksyoutospecifyanameforthephotoyouwanttostoreandthen
youcanfinditamongthesnapshotsinthespecificSnapshotfunctionnext
described.
GroupOption
1.ITUTORshowsyoualistofthegroupsofstudentsofthecourseandyoucanviewforeachof
themtheconceptualoractivitymaps,paintedaccordingtothegroupactivity,asexplainedinthe
ColoringtheMapsection.Inparticular,theConceptualviewshowstheconceptualmappainted
accordingtothe
percentageof
clicked
documentby
full
group,whilethe
Activityview
showsthe
activitymap
painted
accordingtothe
percentageof
activity
documentsof
thegroup,as
shown.
2.ClickonthefoldericontoviewthepaintedConceptualMapofagroup
34
8/13/2019 User Manual En iTutor
36/61
2.1ITUTORshowsyou
theconceptualMapof
thecorrespondent
studentpainted
accordingto
the
percentageofthe
didacticaldocuments
onwhichstudenthas
clickedamongthetotal
numberofdidactical
documentscontained
thecell.in
the
cell.
4.Foreachkindofmap,youcanfrozenitclickingonthephotoicon
3.ClickonthechaticontoviewthepaintedActivityMapofagroup
3.1ITUTORshows
youtheActivity
Mapof
correspondent
grouppainted
accordingtothe
percentageof
documentsrelated
tothegroupamong
thetotalnumberof
activitydocuments
containedinthe
35
8/13/2019 User Manual En iTutor
37/61
4.1ITUTORasksyoutospecifyanameforthephotoyouwanttostore
itamongthesnapshotsinthespecificSnapshot
Sectio
d
documentsintheconceptualspace
ofaparticularsectionofthecourse.
1.
youa
sectionsofthe
course
.Clickontheeyeiconforviewingaparticularsection
andthenyoucanfind
nctionnextdescribed.
fu
nOption
Usethisoptionforviewingthe
istributionamongthefulldidactical
ITUTORshows
listofall
2
36
8/13/2019 User Manual En iTutor
38/61
3.ITUTORshowsyoutheconceptualmapfortheselectedsection,thatispaintedaccordingto
thepercentageofdidacticaldocumentsofthesectionamongalldidacticaldocumentscontained
functionalityforretrievingyourfrozenmaps.
TUTORhelpsyouintheretrievalbecauseheordersthesnapshotsfortypology.Soyoucan
choosetoviewfrozenmapsaboutthedomain(conceptualoractivity) oraboutstudentsorabout
Domain ConceptualMAPSoption
1.ITU
y
frozenconce
maps.Clickonthe
eyeiconfor
retrievingthe
map.
ActivityMAPSoption
inthecell.
Snapshotfunction
Usethis
I
groups.
TORshows
oualistofall
ptual
Domain
37
8/13/2019 User Manual En iTutor
39/61
38
maps.
forretrievin
themap.
tudentoption
1.
which
you
have
frozenmaps.
thefoldericonforretrievingallfrozenconceptualmapsforaspecific
student.
1.ITUTOR
showsyoua
listofall
frozenactivity
Clickon
theeyeicon
g
S
ITUTORshowsyoua
listofstudentsfor
2.Clickon
8/13/2019 User Manual En iTutor
40/61
2.1.ITUTOR
showsyouall
frozenconceptual
mapsforthe
selectedstudent.
Clickontheeye
iconforretrieving
aparticularmap.
3.Clickonthe
chaticonforretrievingallfrozenactivitymapsforaspecificstudent.
3.1.ITUTOR
showsyou
all
frozenactivity
mapsforthe
selectedstudent.
Clickontheeye
iconforretrieving
aparticularmap.
GroupOption
39
8/13/2019 User Manual En iTutor
41/61
1.ITUTORshowsyoua
listofgroupsforwhich
youhavefrozenmaps.
2.Clickonthefoldericonforretrievingallfrozenconceptualmapsforaspecific
group.
2.1.ITUTORshowsyouall
frozenconceptualmapsfor
theselectedgroup.Clickon
theeyeiconforretrievinga
particularmap.
3.Clickonthechaticonforretrievingallfrozenactivitymapsforaspecific
group.
40
8/13/2019 User Manual En iTutor
42/61
3.1.ITUTOR
showsyouall
frozen
activitymaps
forthe
selected
group.Click
ontheeye
iconfor
retrievinga
particular
map.
STUDENTMANUAL
InordertouseITUTORplugin,theloggedstudentneedstoclickontheITUTORMapsPluginblock,
availableinside
acourse,
usually
on
the
bottom
left
position.
41
8/13/2019 User Manual En iTutor
43/61
TheITUTOR
plugin
aims
student
to
create
her
conceptual
and
activity
spaces
on
which
she
can
monitor
andretrieveinformationaboutherdidacticalactivities.
TheITUTORmapsmainpageforstudentlooksasfollow;amenubarallowstoaccesstothemainITUTOR
pluginfunctionalitiesandithastwooptions:"UseMaps"and"HistoricalSnapshotsMaps".
42
8/13/2019 User Manual En iTutor
44/61
UseMAPfunctions
Onceyouhaveselectedthisoption,adropdownmenushowsyou2differentactions:
1)ConceptualMaps:forviewingtheconceptualmapwiththedistributionofthedidacticaldocumentsyou
havestudied;themapiscoloredaccordingtowhatexplainedinthepreviouslysection(Coloringthemap).
TheconceptualmapisrelatedtothecourseyouhavepreviouslyselectedontheMoodleplatform;
2)ActivityMaps:forviewingyouractivitiesinthecourse.ItistheITUTORActivitymapcoloredconsidering
thedistributionofyouractivitydocuments.
ConceptualMAPSoption
ITUTORshowsyouthecurrentconceptualmapandyoucanbrowseit.Mapiscoloredaccording
tothepercentageofdidacticaldocumentsyouhaveclickedamongalldidacticaldocuments
uploadedontheMoodleplatformbyyourteacherforthecourse,soyoucanviewyourdislocation
intheconceptualspace.(seeColoringMapssection)
43
8/13/2019 User Manual En iTutor
45/61
44
ActivityMAPSoption
ITUTORshowsyouthe
currentactivitymapand
canbrowseit.Mapis
coloredaccordingtothe
percentageof
your
activity
documentsamongall
activitydocuments,soyou
canviewyourdislocationin
theactivityspace.(see
ColoringMapssection)
you
8/13/2019 User Manual En iTutor
46/61
Inbothsectionyoucanfrozenthemapclickingonthe"photo"iconforretrievingit
next.
Onceyouhaveselectedthe"photo"icon,ITUTORasksyoutospecifyanamefor
thesnapshotmapyouwantsave.
HistoricalSnapshotsMapsfunctions
Thisoptionallowsyoutoretrievethesnapshotsofthemaps(bothconceptualandactivity)youhave
previouslyfrozen;inthiswayyoucanseeyourprogressionandparticipationatthecourse.Onceyouhave
selectedthisoption,adropdownmenushowsyou2differentactions:"ConceptualMaps"and"Activity
Maps"options.
ConceptualMapsoption
Withthisoptionyoucanretrievetheconceptualmapsyouhavefrozen.
ITUTORshowsyoua
listoffrozen
conceptualmaps
withthenamesyou
havepreviously
entered.
Justclickontheeye
iconforviewingthe
map;youcanalso
deleteitclickingon
"cross"icon.
45
8/13/2019 User Manual En iTutor
47/61
ActivityMapsoption
Withthisoptionyoucanretrievetheactivitymapsyouhavefrozen.
ITUTORshows
youalistof
frozenactivity
mapswiththe
namesyou
have
previously
entered.
Justclickonthe
eyeiconfor
viewingthe
map;youcan
alsodeleteit
clickingon
"cross"icon.
Forbothoptions,onceyouhaveclickedon"eye"icon,theselectedmapisshown
46
8/13/2019 User Manual En iTutor
48/61
MONITORING
OnceyouclickonthemonitoringlinkintheITUTORplugintheMonitoringpageopens.Themonitoring
componentallowsvisualizationofdifferentindicatorsofthestudentsperformanceextractedbythe
clusteringengine.
TheMonitoringpagecontainsalistofactivities.Foreachofthemyouseeagraphicviewofthemain
studentclusters.
Clickonthelensiconforviewingtheactivityofyourinterest.
Activitiesare:
AssignmentSubmissions
ChatMessages
Comments
Files
47
8/13/2019 User Manual En iTutor
49/61
ForumDiscussions
ForumPostsResponder
ForumPosts
GradeGrades
Grade
Grades
Participation
Log
Message
MessageRead
MessageReadTo
MessageTo
MyPages
Post
QuizGrades
Tag
UserLastAccess
Overall
OverallActivities
OverallMarks
Therearealabelforeachcluster(thatareatmost4):notatall,low,onaverage,andhigh.
Bothhistogramandboxplotvisualizationareprovidedforeachclusterrelatedtoaindicator:boxplots
depictthequartilesofthepopulationgroupedineachcluster.Eachclusterisclickableinthetwocharts,
andprovides
the
complete
list
of
its
students
belonging.
Finally,
aparticular
student
name
can
be
selected
fromadropdownlisttoreadher/hisindicatorvalue.
Forexample,theactivityForumPostsshowstheactionsofthestudents,organizedingroups,asregards
theforummessages.
48
8/13/2019 User Manual En iTutor
50/61
Onceyouclickonacluster,alistofstudentisshown.Selectastudentinthelistforviewinghis/her
indicatorvalue.
Withthisgraphicalviewyoucaneasilyunderstandwhichstudentgroupsspentmoretimethanotherones,
onacertainactivity.
Alsoavisualizationhasbeenimplementedinthesameinterfaceforviewingthestatisticaldispersionof
StudentsinEachCluster.Youcanaccesstothisvisualizationscrollingthelateralbarofthewindows.
49
8/13/2019 User Manual En iTutor
51/61
Profiling
ForaccessingtoprofilingfunctionalityyoumustclickonProfilinglinkintheITUTORplugin.
Theprofilingcomponenthasbeenimplementedinthesamewayasthemonitoring.Onceyouaccesstothis
functionality,alistofstudentisshown.Selectoneofthemforviewinghis/herindicatorvalues.
Aradarchartdepictsthecomparativeperformanceofastudentw.r.t.asetofindicators.Thewideristhe
areaofthechartthebetteristhestudentsperformance.Thecomponentisabletoshowwhateversetof
indicators.
50
8/13/2019 User Manual En iTutor
52/61
51
8/13/2019 User Manual En iTutor
53/61
Timelineview
Thetimelineviewofpersonallogsdependsontheclusteringagentbeinginstalledandrunning. Itis
possibletoseeasampletimelineviewiftheMoodleadministratorshaveinstalledthedatabasetablesand
sampledata. Thesampledataprovidesaroughideaofthesortofinformationtheviewwillshow:
Thegraphshowstheindividualslevelofactivityforaspecificmetricbydefaultthegraphshowsforum
posts. Thisinformationisshownastheblackline,althoughtheactualdatapointsaremarkedwithred
circles(theblacklineistoprovideasenseofcontinuitybetweenthetimeswhentheclusteringagentruns).
Thebandsofcolourrepresentthedifferentclusters. Inthiscase,eachribbonofcolourshows1standard
deviationswidthawayfromthecentrallinewhichisthemeanvalueofthemetricforthatclusterof
students.
Thestudent
in
the
sample
data
was
about
average
in
the
lowest
activity
cluster
for
the
first
couple
of
measurements,andthenstartedengagingwithothersontheforums,reachingandbrieflyexceeding,the
averagenumberofforumpostsofthemosthighlyactivecluster,beforetailingoffonthelastday.
52
8/13/2019 User Manual En iTutor
54/61
Options
Asatutor(orotherpersongrantedthereport/plog:viewcoursecapability)youwillhavetheoptionof
choosingwhichusersdatayouwishtosee. Asastudent(orotherpersongrantedthe
report/plog:viewowncapability)
you
only
get
to
choose
the
time
period
and
which
metric
to
display:
ThesereportscanbeaccessedusingtheURL:
/report/plog/index.php
Thiswilldefaulttoshowingthevaluesfortheloggedinuser,forthecoursetheyaccessedthereportfrom.
Thesampledataisavailableat/report/plog/index.php?test=1
Ifatutorwishestolinktospecificcharts,theURLcanbecopyandpastedfromthebrowsersaddressbar,
orbuiltupusingthevaluesoftheparameters. Thisinformationcanalsobeusedforbuildingmoodle
blockstolinktospecificcharts.
Forexample,
/report/plog/index.php?student=49&startdate=1379376000&metric=forum_posts
Willgivethechartforthestudentwithid=49,startingon17September2013(thesedatesareeasiestto
createusingtheforms!),andwillshowtheforum_postsmetric.
Installation
ThereportplugincanbeinstalledbycopyingtheplogfolderintotheMoodlereportfolder,andvisiting
/admin/index.php
andfollowingnormalprocedures. However,currentlyonversion2.4.1ofMoodle,thecapabilitysettings
arenotcorrectlyloading,andamanualinterventionhastobeperformedtocreatethesettingsinthe
database(this
is
not
the
case
in
version
2.5+).
A
SQL
script
(export
from
mysql)
is
included
in
the
plog.tar
file.
53
8/13/2019 User Manual En iTutor
55/61
Ifyouwishtomakethetestdataavailable,thereare3SQLscriptswhichcreatethesampledatarecords.
NOTEhowever,thatcluster_runs.sqluseshardcodedidvalues(theothersrefertothese)soDONOT
installthesescriptsifyoualreadyhavecluster_runswithidvaluesbetween105and112inclusive,without
editingthesevaluesinallthreeclustertestdatascripts(cluster_runs.sql,cluster_stats.sql,
cluster_user_clusters.sql).
Thenatureofthetimelinegraphissuchthatitrequireshistoricaldatatoprovideameaningfuloutput. Itis
recommendedthatitisonlyusedaftertheclusteringagenthasrun3ormoretimestoprovidethat
historicalcontext.
Alerter
EnabletheITUTORProfilerblockinthecourseinwhichyouwishtousealerting.
Click
on
the
configuration
icon:
Theconfigurationpagewillbeshownnote,thisisonlyseenbytheteacher/admin,thealerterdoesnot
haveauserinterfaceforstudents,soyoucanhidethisblockonceyouhaveconfiguredthealertsyouwish
touse.
54
8/13/2019 User Manual En iTutor
56/61
Here
you
may
choose
when
you
want
the
alert
to
be
generated,
which
type
of
alert
you
wish
to
create,
and
whichmetrictobasethealerton.
Forinstance,youcanselecttohaveanalertifthestudentisintheZerocluster,(noactivity),orinthe
bottom10%. YoucanchoosewhethertoalertonQuizscores,anyactivity,posts,etc.
Youcanalsoconfigurewhatthemessageshouldsay,andwhethertosendittoyourself,ortothestudent
towhomthealertrelates.
Forexample:
55
8/13/2019 User Manual En iTutor
57/61
Onceyouhavesetupthebasicsettingsforthealert,thebottomhalfofthepagegivessomemore
advancedsettings,andtheopportunitytosavethealertsothatitwillmonitorstudentactivity:
56
8/13/2019 User Manual En iTutor
58/61
Ingeneral,itisOKtoleavethesesettingsastheyare,andclickSavechanges.
Whenyounextclickontheconfigurationicon,youwillseealistofalertsatthetopofthepage:
Youcancheckthesummaryofthedetails,andifyouuncheckthecheckbox,thealertwillbedeletedwhen
youclickonthesavechangesbutton.
Ifyousetupmultiplealerts,pleasebeawarethatstudentswhotriggereachcriteriawillbesentanemail
foreachonesoifyouhavealertsforbothZeroandlowest10%foreachofthecriteria,andastudent
neverlogsin,theywillreceive2emailsforeachcriteriatoalertthemthattheyhavenotbeentaking
advantageof
the
system.
It
is
probably
better
to
configure
asmall
number
of
alerts,
to
avoid
bombarding
students!
Installation
Requirements:Java
Thealerterinstallstheclusteringagent.
Installby
extracting
the
Alerter
folder
in
to
the
Blocks
folder
of
your
Moodle
installation.
57
8/13/2019 User Manual En iTutor
59/61
58
Furthermorethesystemadministrator needtorunthesedatabasescripts:
CREATETABLE`cluster_runs`(
`id`bigint(20)NOTNULLAUTO_INCREMENT,
`date`timestampNOTNULLDEFAULTCURRENT_TIMESTAMP,
`courseid`bigint(20)DEFAULTNULL,
`clusteringname`varchar(100)COLLATEutf8_unicode_ciDEFAULTNULL,
`maxCluster`int(11)DEFAULTNULL,
PRIMARYKEY(`id`)
)ENGINE=AUTO_INCREMENT=1DEFAULTCHARSET=utf8COLLATE=utf8_unicode_ci
CREATETABLE`cluster_stats`(
`id`bigint(20)NOTNULLAUTO_INCREMENT,
`clusterid`bigint(20)DEFAULTNULL,
`cluster`int(11)DEFAULTNULL,
`mean`decimal(20,4)DEFAULTNULL,
`stddev`decimal(20,4)DEFAULTNULL,
PRIMARYKEY(`id`)
)ENGINE=AUTO_INCREMENT=1DEFAULTCHARSET=utf8COLLATE=utf8_unicode_ci
CREATETABLE`cluster_user_clusters (
`id`bigint(20)NOTNULLAUTO_INCREMENT,
`clusterid`bigint(20)DEFAULTNULL,
`userid`bigint(20)DEFAULTNULL,
`cluster`int(11)
DEFAULT
NULL,
`value`decimal(20,4)DEFAULTNULL,
8/13/2019 User Manual En iTutor
60/61
59
PRIMARYKEY(`id`)
)ENGINE=AUTO_INCREMENT=1DEFAULTCHARSET=utf8COLLATE=utf8_unicode_ci
8/13/2019 User Manual En iTutor
61/61
Intelligent Tutoring for Life Long Learning
That is all...hat is all...Enjoy the I-TUTOR plugin!njoy the I-TUTOR pluginThat is all...hat is all...Enjoy the I-TUTOR plugin!njoy the I-TUTOR pluginThat is all...Enjoy the I-TUTOR plugin!