faal_algo

Class Matcher

java.lang.Object

faal_algo.Matcher

public class Matcher
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Matcher()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	build_word(java.lang.String word, java.lang.String parsed_word, java.lang.String fileName_phon_diacritics)
static java.util.List<java.lang.Integer>	index_morph_bound(int a, int b, int c, java.lang.String word_A, java.lang.String word_B)
static java.util.List<java.util.List<java.lang.Object>>	Matcher_new(java.lang.String parsed_word_A, java.lang.String parsed_word_B, int[][] comp_matrix, int[][] comp_matrix_orig, java.lang.String unparsed_word_A, java.lang.String unparsed_word_B) Method corresponding to the Matcher module.
static java.util.List<java.util.List<java.lang.Object>>	Matcher_new(java.lang.String parsed_word_A, java.lang.String parsed_word_B, int[][] comp_matrix, int[][] comp_matrix_orig, java.lang.String unparsed_word_A, java.lang.String unparsed_word_B, java.util.List<java.lang.Boolean> Matcher_configs_1, java.util.List<java.lang.Integer> Matcher_configs_2, java.util.List<java.lang.String> Matcher_configs_3, java.util.List<java.lang.Double> Matcher_configs_4, java.lang.Boolean external_function) Method corresponding to the Matcher module.
static double	sum_feat_calc(int option, double sum_feat, double val_matrix)
static java.lang.String	type_match(int i, int n, java.util.List<java.util.List<java.lang.Integer>> match_A, java.util.List<java.util.List<java.lang.Integer>> match_B, java.lang.String word_A, java.lang.String word_B)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Matcher

public Matcher()

Method Detail

Matcher_new

public static java.util.List<java.util.List<java.lang.Object>> Matcher_new(java.lang.String parsed_word_A,
                                                                           java.lang.String parsed_word_B,
                                                                           int[][] comp_matrix,
                                                                           int[][] comp_matrix_orig,
                                                                           java.lang.String unparsed_word_A,
                                                                           java.lang.String unparsed_word_B)

Method corresponding to the Matcher module. It parses one pair of words at a time, using default values (see online documentation for their values). It returns an array list of possible alignments organized according to their Global Similarity Score.

Parameters:

parsed_word_A - (String): parsed (i.e. without diacritics etc) transcription of word A (returned by IPA_parser.IPA_parser_new - output 0).

parsed_word_B - (String): parsed (i.e. without diacritics etc) transcription of word B (returned by IPA_parser.IPA_parser_new - output 1).

comp_matrix - (int[][]): matching features matrix corrected according to the salience settings (returned by IPA_parser.IPA_parser_new - output 2).

comp_matrix_orig - (int[][]): basic matching features matrix with- out any salience corrections (returned by IPA_parser.IPA_parser_new - output 3).

unparsed_word_A - (String): IPA transcription of the first word to be aligned.

unparsed_word_B - (String): IPA transcription of the second word to be aligned.

Returns:

Result output: List<List<Object>>

Each List<Object> item within the List corresponds to an alignment. They are organized according to their Global or Corrected Global Similarity score (see the config files in the documentation online). Each of these List<Object> item contains:

0. String: Alignment for Word A

1. String: Alignment for Word B

2. String: Alignment for Word A without diacritics

3. String: Alignment for Word B without diacritics

4. Double: Global Similarity Score

5. Double: Corrected Global Similarity Score

6. List<String>: List of phonetic pairs attested within the alignment. Each item on the list corresponds to a phonetic pair, and it is stored as a string with the following syntax: "phoneme_A - phoneme_B"

7. List<Integer>: Number of attestations within the alignment for each phonetic pair of point 6. here above.

Matcher_new

public static java.util.List<java.util.List<java.lang.Object>> Matcher_new(java.lang.String parsed_word_A,
                                                                           java.lang.String parsed_word_B,
                                                                           int[][] comp_matrix,
                                                                           int[][] comp_matrix_orig,
                                                                           java.lang.String unparsed_word_A,
                                                                           java.lang.String unparsed_word_B,
                                                                           java.util.List<java.lang.Boolean> Matcher_configs_1,
                                                                           java.util.List<java.lang.Integer> Matcher_configs_2,
                                                                           java.util.List<java.lang.String> Matcher_configs_3,
                                                                           java.util.List<java.lang.Double> Matcher_configs_4,
                                                                           java.lang.Boolean external_function)

Method corresponding to the Matcher module. It parses one pair of words at a time, using personalized values (see online documentation for detailed description). It returns an array list of possible alignments organized according to their Global or Corrected Global Similarity Score, or according to an external function.

Parameters:

parsed_word_A - (String): parsed (i.e. without diacritics etc) transcription of word A (returned by IPA_parser.IPA_parser_new - output 0).

parsed_word_B - (String): parsed (i.e. without diacritics etc) transcription of word B (returned by IPA_parser.IPA_parser_new - output 1).

comp_matrix - (int[][]): matching features matrix corrected according to the salience settings (returned by IPA_parser.IPA_parser_new - output 2).

comp_matrix_orig - (int[][]): basic matching features matrix with- out any salience corrections (returned by IPA_parser.IPA_parser_new - output 3).

unparsed_word_A - (String): IPA transcription of the first word to be aligned.

unparsed_word_B - (String): IPA transcription of the second word to be aligned.

Matcher_configs_1 - (List<Boolean>): Boolean array list with variables for the configuration of the FAAL.faal and Matcher.Matcher_new modules. For a detailed description of the variables see online documentation.

Matcher_configs_2 - (List<Integer>): Integer array list with variables for the configuration of the FAAL.faal and Matcher.Matcher_new modules. For a detailed description of the variables see online documentation.

Matcher_configs_3 - (List<String>): String array list with variables for the configuration of the FAAL.faal and Matcher.Matcher_new modules. For a detailed description of the variables see online documentation.

Matcher_configs_4 - (List<Double>): Double array list storing the factors used in the calculation of the Corrected Global Similarity score. It is used in the configuration of the FAAL.faal and Matcher.Matcher_new modules For a detailed description of the variables see online documentation.

external_function - (Boolean): select if using or not an external function - True = use external function from config. folder; False = do not use external function.

Returns:

Result output: List<List<Object>>

Each List<Object> item within the List corresponds to an alignment. They are organized according to their Global or Corrected Global Similarity score (see the config files in the documentation online). Each of these List<Object> item contains:

0. String: Alignment for Word A

1. String: Alignment for Word B

2. String: Alignment for Word A without diacritics

3. String: Alignment for Word B without diacritics

4. Double: Global Similarity Score

5. Double: Corrected Global Similarity Score

6. List<String>: List of phonetic pairs attested within the alignment. Each item on the list corresponds to a phonetic pair, and it is stored as a string with the following syntax: "phoneme_A - phoneme_B"

7. List<Integer>: Number of attestations within the alignment for each phonetic pair of point 6. here above.

sum_feat_calc

public static double sum_feat_calc(int option,
                                   double sum_feat,
                                   double val_matrix)

type_match

public static java.lang.String type_match(int i,
                                          int n,
                                          java.util.List<java.util.List<java.lang.Integer>> match_A,
                                          java.util.List<java.util.List<java.lang.Integer>> match_B,
                                          java.lang.String word_A,
                                          java.lang.String word_B)

index_morph_bound

public static java.util.List<java.lang.Integer> index_morph_bound(int a,
                                                                  int b,
                                                                  int c,
                                                                  java.lang.String word_A,
                                                                  java.lang.String word_B)

build_word

public static java.lang.String build_word(java.lang.String word,
                                          java.lang.String parsed_word,
                                          java.lang.String fileName_phon_diacritics)