RSAModelUttKLDiv_4params: Main cost function for four parameter optimization for the...

Description Usage Arguments Details Value

View source: R/RSA_UttChoiceOptimization.R

Description

Full-RSA

The actual RSA model Kullback-Leibler divergence determination for utterance choice experiments.

Softness, non-obedience, alpha and klValueFactor are optimized.

Usage

1
RSAModelUttKLDiv_4params(data, par1, par2, par3, par4)

Arguments

data

A matrix with data rows.

column structure: [1:OC1,OC2,OC3,4:numUttOptions,7-X:TurkerSliderValues]

1:OC1 Object 1. A value between 1 and 27.

2:OC2 Object 2. A value between 1 and 27.

3:OC3 Object 3. A value between 1 and 27.

4:numUttOptions The number of valid utterances in the scene.

7-X:TurkerSliderValues These columns contain the participants' slider values.

par1
softness parameter

A parameter value between [0,infinity) (The larger the value the higher the tendency towards uniform liking).

Value reflects how categorical the listener's preferences are:

0: The listener always picks her preferred object.

If the listener prefers red objects, she will always pick the red object in the scene.

infinity: It is as likely for the listener to pick green, blue or red objects.

par2
non-obedience parameter

Determines the extent to which the instruction of the speaker is obeyed by the listener.

(0 = full obedience, infinity = full instruction ignorance).

Example:

0: Listener always picks red objects following the utterance "red".

infinity: Listener as likely to pick green, blue or red objects even if the utterance is "red".

par3
alpha parameter

A parameter value between 0 and 1.

This parameter is an exponential scaling of the speaker choosing the utterance that maximizes the chance of the listener getting the target object right.

par4

klValueFactor can be negative, 0 or positive:

zero

Don't care about learning about the feature preferences of the listener

positive

Care about learning about the feature preferences of the listener

negative

Trying to pick non-ambiguous utterances

Details

This function uses getBestInfGainUttPreferences.

And is used by

RSAModelUttKLDivParamD4,

RSAModelUttKLDivParamD4A.2,

RSAModelUttKLDivParamD4B.2,

RSAModelUttKLDivParamD4AB.2,

RSAModelUttKLDivParamAD4,

RSAModelUttKLDivParamBD4,

RSAModelUttKLDivParamAD4B.2,

RSAModelUttKLDivParamBD4A.2,

RSAModelUttKLDivParamCD4,

RSAModelUttKLDivParamBCD4,

RSAModelUttKLDivParamACD4,

RSAModelUttKLDivParamABD4,

RSAModelUttKLDivParamABCD4.

Value

Minimized Kullback-Leibler divergence and the optimal parameters.


haniaelkersh/rsa-publish-test documentation built on Jan. 31, 2021, 2:02 a.m.