# This file is part of the source code of
program_name = "gradint v0.9927 (c) 2002-2009 Silas S. Brown. GPL v3+."
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
# Start of sequence.py - make individual graduated-interval sequences to be interleaved into the lesson
def randomInstruction(numTimesBefore,promptsData,language):
if not numTimesBefore: return (availablePrompts.getPromptList("repeatAfterMe",promptsData,language),0)
if numTimesBefore==1: return (availablePrompts.getPromptList("sayAgain",promptsData,language),1)
if language==secondLanguage and ((dbase.veryExperienced() and numTimesBefore>=reallyKnownThreshold) or (meaningTestThreshold and numTimesBefore>meaningTestThreshold and not random.choice([1,2,3])==1)):
return (None,1) # no instruction needed
r = availablePrompts.getRandomPromptList(promptsData,language)
# horrible hack: whatSay goes after the 1st-language
# word; others go before
for i in r:
if i.startswith("whatSay_"): return (r,0)
return (r,1)
def anticipation(promptFile,zhFile,numTimesBefore,promptsData):
# Returns an item in an "anticipation sequence"
# i.e. an event made up of prompt, 1st language, &
# 2nd language, perhaps repeated 2-3 times depending
# on progress.
#
# (Note: numTimesBefore is from ALL LESSONS)
# Set some parameters depending on numTimesBefore
instructions, instrIsPrefix = randomInstruction(numTimesBefore,promptsData,languageof(zhFile))
if instructions: instructions = map(lambda x:fileToEvent(x,promptsDirectory), instructions)
else: instructions = [Event(1)]
zhEvent = filesToEvents(zhFile) ; secondPause = 1+zhEvent.length
promptEvent = filesToEvents(promptFile)
if not numTimesBefore: anticipatePause = 1
else: anticipatePause = secondPause
# work out number of repetitions needed. not sure if this should be configurable somewhere.
first_repeat_is_unessential = 0
if numTimesBefore == 1: numRepeat = 3
elif numTimesBefore < 5: numRepeat = 2
elif numTimesBefore < 10:
numRepeat = random.choice([1,2])
if numRepeat==2: first_repeat_is_unessential = 1
else: numRepeat = 1
if numRepeat==1:
k,f = synthcache_lookup(zhFile,justQueryCache=1)
if f and k[0]=="_" and not textof(zhFile) in subst_synth_counters:
# Hack: an experimental cache entry but only 1 repetition - what do we do?
c=random.choice([1,2,3])
if c==1: pass # do nothing
elif c==2: # have the word twice
numRepeat = 2
first_repeat_is_unessential = 1
elif c==3: subst_synth_counters[textof(zhFile)]=1 # so it uses the cached version
# Now ready to go
theList = []
if instrIsPrefix: theList = instructions
theList.append(promptEvent)
if promptFile==zhFile and not promptFile in singleLinePoems:
# A multi-line poem with no first-language prompts, so we're using each fragment as a prompt for the next, but the first fragment is its own prompt, which means that 'prompt' is ambiguous. Say "beginning" to disambiguate it.
theList = theList + map(lambda x:fileToEvent(x,promptsDirectory), availablePrompts.getPromptList("begin",promptsData,languageof(zhFile)))
if not instrIsPrefix: theList = theList + instructions
origZhEvent = zhEvent
for i in range(numRepeat):
if i:
# re-generate zhEvent, in case using cache sporadically or using first_repeat_is_unessential
zhEvent = filesToEvents(zhFile)
secondPause = 1+zhEvent.length
theList.append(Event(anticipatePause))
# (if first_repeat_is_unessential and we're running more than 1sec late, can drop the 1st repetition and pause after it without consequence)
if i==1 and first_repeat_is_unessential: theList[-1].importance,theList[-1].max_lateness = 0,1 # the pause after the 1st repetition
theList.append(zhEvent)
if i==0 and first_repeat_is_unessential:
theList[-1].setOnLeaves('max_lateness',1) # the 1st repetition itself
theList[-1].setOnLeaves('wordToCancel','') # so it doesn't register as needing to cancel anything
theList[-1].setOnLeaves('importance',0) # and doesn't try to cap the max lateness of earlier events
anticipatePause = secondPause
theList.append(Event(1))
extraPauseAfter = random.choice([0,1,2])
if extraPauseAfter:
theList.append(Event(extraPauseAfter))
theList[-1].importance,theList[-1].max_lateness = 0,1
if not numTimesBefore:
explanation = explanations(zhFile)
if explanation:
theList.insert(1,origZhEvent)
theList.insert(1,explanation)
theList.insert(1,origZhEvent)
return CompositeEvent(theList)
def reverseAnticipation(promptFile,zhFile,promptsData):
# Returns a "what does this mean" test
zhEvent = filesToEvents(zhFile)
promptEvent = filesToEvents(promptFile)
theList = []
theList.append(zhEvent)
for p in availablePrompts.getPromptList("whatmean",promptsData,languageof(zhFile)): theList.append(fileToEvent(p,promptsDirectory))
theList.append(Event(1))
for p in availablePrompts.getPromptList("meaningis",promptsData,languageof(zhFile)): theList.append(fileToEvent(p,promptsDirectory))
theList.append(promptEvent)
theList.append(Event(random.choice([1,2,3])))
return CompositeEvent(theList)
def languageof(file,needVariants=False):
assert "_" in file, "no _ in %s" % (file,)
if needVariants:
second_ = file.find("_",file.index("_")+1)
if second_ > -1: # name_lang_variant.ext
return file[file.index("_")+1:second_]
s=file[file.rindex("_")+1:]
if extsep in s: return s[:s.rindex(extsep)]
else: return s
def commentSequence():
sequence = []
for c in commentsToAdd:
sequence.append(GluedEvent(Glue(1,maxLenOfLesson),fileToEvent(c,"")))
return sequence
def anticipationSequence(promptFile,zhFile,start,to,promptsData,introList):
# Returns a sequence of "anticipations" (as above) with
# graduated-interval glue between the items
# (try number from 'start' to 'to', EXCLUDING 'to')
sequence = []
# First one has initialGlue() whatever the value of 'start' is
if meaningTestThreshold and to==start+1 and start>meaningTestThreshold and random.choice([1,2])==1 and not type(promptFile)==type([]) and promptFile.find("_"+firstLanguage+extsep)>=0:
# *** not sure about that condition - should the random be more biased?
# (the type() and following condition is a hack that ensures this is not used for poetry etc where there are composite prompts or the prompt is the previous line. TODO would be better to keep track of which samples are poetic, because the above breaks down on the first line of a poem that has a translation into the first language because that looks like a normal prompt/response - but ok for now)
firstItem = reverseAnticipation(promptFile,zhFile,promptsData)
else: firstItem = anticipation(promptFile,zhFile,start,promptsData)
if introList: firstItem=CompositeEvent(introList+[firstItem])
sequence.append(GluedEvent(initialGlue(),firstItem))
for i in range(start+1,to):
sequence.append(GluedEvent(glueBefore(i),anticipation(promptFile,zhFile,i,promptsData)))
return sequence
def glueBefore(num):
if num==0: return initialGlue()
elif num==1: return Glue(15,15)
elif num==2: return Glue(45,15)
elif num==3: return Glue(130,30)
elif num==4: return Glue(500,60)
else: return Glue(500,150+3*(num-5))
randomAdjustmentThreshold = 500
# (if initial glue len >= this, it's randomly adjusted
# BEFORE checking for collisions - this avoids certain
# problems with repetitive lessons)