__init__ (
        self,
        env,
        interpreter,
        lisp="()",
        )

Create a Program

You must provide a Charlemagne environment and optionally an initial lisp expression.

_makeProgram ( self,  lisp )

Factory method for instantiating programs

This can be overridden in subclasses to create Program subclasses.

adjustedFitness ( self )

Calculate the adjusted fitness

Note the program needs to have been evaluated by a ProgramEvaluator for this to work. The adjusted fitness is based on the rawfitness of the lisp expression.

contextSensitiveCrossover ( self,  mate )

Perform a crossover operation with another program

contextSensitiveCrossoverAt (
        self,
        mate,
        branch,
        )

Perform a context sensitive crossover

Perform a crossover operation with another program at specified points on the program trees.

crossover ( self,  mate )

Perform a crossover operation with another program

crossoverAt (
        self,
        mate,
        branch1,
        branch2,
        )

Perform a crossover operation with another program at specified points on the program trees

flatCount ( self )

Return the number of possible program branches in the lisp expression

getDepth ( self )

Returns the depth of the lisp expression

Note the program needs to have been evaluated by a ProgramEvaluator for this to be set. The Program does not evaluate its own depth.

getHits ( self )

Get the hits statistic

Note the program needs to have been evaluated by a ProgramEvaluator for this to be set. The Program does not evaluate its own hits.

getLisp ( self )

Retrieve the lisp source of the program

getRawFitness ( self )

Returns the raw fitness of the program

Note the program needs to have been evaluated by a ProgramEvaluator for this to be set. The Program does not evaluate its own fitness.

mutant ( self )

Perform a mutation on the program

randomize ( self,  depth )

Randomize the Program's lisp expression

replaceConstantSynthesisTokens ( self )

Synthesize constants for all CONSTANT-SYNTHESIS token terminals

The terminal CONSTANT-SYNTHESIS is a keyword which is replaced with a random constant.

replica ( self )

Replicate the program

save ( self,  file )

Save the program to file

Saves the lisp expression as one line in the provided open file.

saveStats ( self,  file )

Save the stats

Saves the stats for this program to the provided open file.

setDepth ( self,  depth )

Set the depth of the program

Note: this is setting the depth statistic for the program, not altering the lisp expression in any way. Normally a FitnessEvaluator should be doing this.

setHits ( self,  hits )

Set the hits statistic

Note: this is setting the hits statistic for the program, not altering the lisp expression in any way. Normally a FitnessEvaluator should be doing this.

setLisp ( self,  lisp )

Set the lisp source of the program

setRawFitness ( self,  rawfitness )

Set the raw fitness of the program

Normally a FitnessEvaluator should be doing this.

show ( self )

Abstract method for displaying the program

Implement this in subclasses to provide custom display formats.