Difference between revisions of "How to get started with lexical selection rules"

From Apertium
Jump to navigation Jump to search
 
(23 intermediate revisions by 6 users not shown)
Line 1: Line 1:
  +
{{TOCD}}
== Choose your words ==
 
  +
  +
This page is about how to start writing rules for [[lexical selection]]. It documents a few approaches, with example rules in the [[constraint-based lexical selection]] format.
  +
  +
== First approach ==
  +
  +
=== Choose your words ===
   
 
Before you start making lexical selection rules, you first want to choose a word in your source language (e.g. English) which has more than one translation in your target language (e.g. Spanish). For example
 
Before you start making lexical selection rules, you first want to choose a word in your source language (e.g. English) which has more than one translation in your target language (e.g. Spanish). For example
Line 7: Line 13:
 
* argument → argumento
 
* argument → argumento
   
== Think about context ==
+
=== Think about context ===
   
 
The words around our word often help us decide how to translate it, for example, a verb might inform us of how to translate a noun, or a noun might inform us of how to translate an adjective.
 
The words around our word often help us decide how to translate it, for example, a verb might inform us of how to translate a noun, or a noun might inform us of how to translate an adjective.
Line 13: Line 19:
 
If we say "to have an argument", then it probably means "discusión", whereas if we say "to accept the argument", then you probably want to translate it as "argumento".
 
If we say "to have an argument", then it probably means "discusión", whereas if we say "to accept the argument", then you probably want to translate it as "argumento".
   
== Try a parallel corpus ==
+
=== Think about synonyms and antonyms ===
  +
  +
Once you have a rule, one way of making it more general is to think of synonyms and antonyms for the context words. For example, if you have the rule:
  +
  +
<pre>
  +
<rule>
  +
<match lemma="positive" tags="*"/>
  +
<match lemma="charge" tags="n.*">
  +
<select lemma="carga" tags="n.*"/>
  +
</match>
  +
</rule>
  +
</pre>
  +
  +
You could quite easily think that the antonym of "positive" is "negative", and add that too:
  +
  +
<pre>
  +
<rule>
  +
<or>
  +
<match lemma="positive" tags="*"/>
  +
<match lemma="negative" tags="*"/>
  +
</or>
  +
<match lemma="charge" tags="n.*">
  +
<select lemma="carga" tags="n.*"/>
  +
</match>
  +
</rule>
  +
</pre>
  +
  +
=== Think about semantically related words ===
  +
  +
If you have the rule:
  +
  +
<pre>
  +
<rule>
  +
<match lemma="wind"/>
  +
<match lemma="power" tags="n.*">
  +
<select lemma="energía" tags="n.*"/>
  +
</match>
  +
</rule>
  +
</pre>
  +
  +
You might think that the translation of "power" as "energía" (instead of the default translation ''poder'') can happen more times than only after "wind", for example, "solar power" ''energía solar'', "wave power" ''energía olamotriz''. This might give, for example:
  +
  +
<pre>
  +
<rule>
  +
<or>
  +
<match lemma="wind"/>
  +
<match lemma="solar"/>
  +
<match lemma="hydro"/>
  +
<match lemma="geothermal"/>
  +
<match lemma="tidal"/>
  +
</or>
  +
<match lemma="power" tags="n.*">
  +
<select lemma="energía" tags="n.*"/>
  +
</match>
  +
</rule>
  +
</pre>
  +
  +
And even thinking about these can bring you to other rules, for example "electrical power" is not ''energía eléctrica'', it's ''potencia eléctrica''.
  +
  +
=== Look at a concordance ===
  +
  +
A concordance (or "key word in context") is a set of sentences where they are centred on a single word (sometimes called the "key word"). To make a concordance you can use a concordancer (e.g. [http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium-tools/apertium-concord apertium-concord]).
  +
  +
Here is an example from [[EuroParl]]:
  +
  +
<pre>
  +
represent, to the President and to the Governor of Texas, Mr Bush, who has the power to order a stay
  +
We should do everything within our We should do everything within our power to force the
  +
On the market, the balance of On the market, the balance of power between supply and
  +
The scandalous concentration of The scandalous concentration of power in sectors of strategic
  +
fact, retaining not only the The Commission is, in fact, retaining not only the power
  +
to your questions about the nuclear Turning to your questions about the nuclear power stations in
  +
financing required for improving the degree of efficiency and safety of nuclear power stations in certain
  +
have the Mr President, it is clear that the European Union does not have the power to intervene in the
  +
the balance of I therefore feel we must carefully consider the balance of power that we are in
  +
the sea's Having spent a lot of time at sea myself I am well aware of the sea's power and destructive force,
  +
The Commission is following with interest the planned construction of a nuclear power plant in Akkuyu, Turkey
  +
siting, construction, commissioning, operation and decommissioning of nuclear power plants in Turkey rests
  +
a serious risk that some idiot will decide that the new geopolitical balance of power in the Caucasus calls
  +
in the development of that nuclear If we see in the development of that nuclear power
  +
build a nuclear If the conclusion is that Turkey is planning to build a nuclear power plant that does not
  +
none of the upheaval would have been caused had we not acted with parliamentary power to press for changes
  +
yet the police are being forced into a position where they will not have the power to resist the terrorist
  +
right to interfere in the formation of a government even though it has assumed power on the basis of
  +
unusual about what is happening in Austria: there has been a changeover of power following democratic
  +
for this Intergovernmental Conference to score a hat trick; that of the power to act, democratic
  +
course, we need to create the At the same time of course, we need to create the power to act in order
  +
The European Union must also have the The European Union must also have the power to act
  +
  +
...
  +
</pre>
  +
  +
If you do the concordance yourself, particularly interesting are the sequences: "nuclear power", "nuclear power station", "nuclear power plant", "parliamentary power", "sea's power", "balance of power", "concentration of power", "power to act", "motive power", "abuse of power", "decision-making power", "power supply", "come into power", "economic power", "power structures", "combined power and heat", "political power".
  +
  +
=== Try a parallel corpus ===
   
 
You can look at which contexts are used in one translation, but not another by looking at a [[parallel corpus]].
 
You can look at which contexts are used in one translation, but not another by looking at a [[parallel corpus]].
   
  +
<pre>
  +
$ paste europarl-v6.es-en.en europarl-v6.es-en.es | grep ' power .* potencia '
  +
Since the Union as a whole is a world-class fishing '''power''' and one of the largest markets for fish produce, ...
  +
Por ser la Unión en conjunto una '''potencia''' pesquera en el nivel mundial y uno de los mayores mercados de productos pesqueros, ...
  +
</pre>
  +
  +
== Second approach ==
  +
  +
Another approach is to write rules to fix translation errors that you come across. In order to try this out, take a big text (for example a newspaper article), and run it through the translator.
  +
  +
For example, if we take [http://www.guardian.co.uk/politics/2011/dec/07/coalition-government-first-commons-defeat this article], the translation is pretty bad, but there are some places where lexical selection could improve the picture.
  +
  +
<blockquote>
  +
MPs who had '''spent''' almost six hours debating the state of the UK economy voted by 213 to 79, a majority of 134.<br/>
  +
  +
MPs Quién había '''gastado''' casi seis horas debatiendo el estado de la economía de UK votada por 213 a 79, una mayoría de 134.
  +
</blockquote>
  +
  +
In English, "spend" can have a number of meanings, among them "to pass time" ''pasar'' and "to pay money" ''gastar''. In this case, we see that the context demands the translation of ''pasar'' because it is talking about time spent. So, we might make a rule like the following:
  +
  +
<pre>
  +
<rule> <!-- MPs spent almost six hours debating... -->
  +
<match lemma="spend" tags="vblex.*">
  +
<select lemma="pasar" tags="vblex.*"/>
  +
</match>
  +
<match/>
  +
<match/>
  +
<or>
  +
<match lemma="minute"/>
  +
<match lemma="hour"/>
  +
<match lemma="year"/>
  +
</or>
  +
</rule>
  +
</pre>
  +
  +
  +
== Rule weighting ==
  +
  +
Rule weighting is a bit complicated, partly because of how it works. So, suppose you have the following input:
  +
  +
<pre>
  +
^a<pr>/to<pr>$ ^un<det><ind><f><sg>/a<det><ind><sg>$
  +
^estació<n><f><sg>/station<n><sg>/season<n><sg>$
  +
^llarg<adj><f><sg>/long<adj><sint>$
  +
</pre>
  +
  +
If you have the following rules:
  +
  +
<pre>
  +
<rule weight="1.0"><match lemma="estació" tags="n.*"><select lemma="station" tags="n.*"/></match></rule>
  +
<rule weight="1.0"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match></rule>
  +
</pre>
  +
  +
Then both translations with no context have an equal weight. Which one is picked will depend on how the transducer is minimised (e.g. it will be non-deterministic). If you want one translation to have a higher weight than another, then you can just adjust the weight:
  +
  +
<pre>
  +
<rule weight="1.2"><match lemma="estació" tags="n.*"><select lemma="station" tags="n.*"/></match></rule>
  +
<rule weight="0.8"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match></rule>
  +
</pre>
  +
  +
Now "station" will be picked, as <math>1.2 > 0.8</math>. Now, how about if we want to add some context in there. We can just add another rule:
  +
  +
<pre>
  +
<rule weight="1.2"><match lemma="estació" tags="n.*"><select lemma="station" tags="n.*"/></match></rule>
  +
<rule weight="0.8"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match></rule>
  +
<rule weight="1.0"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match>
  +
<or><match lemma="llarg"/><match lemma="curt"/></or></rule>
  +
</pre>
  +
  +
So, if we have the sequence above "a una estació llarga", then the "season" translation will get <math>1.8</math> and the station translation will get <math>1.2</math> meaning that "season" will be picked...
  +
  +
But let's not stop there, the preposition can also give us some information, so let's add another rule:
  +
  +
<pre>
  +
<rule weight="1.0"><or><match lemma="a"/><match lemma="en"/></or><match/>
  +
<match lemma="estació" tags="n.*"><select lemma="station" tags="n.*"/></rule>
  +
<rule weight="1.2"><match lemma="estació" tags="n.*"><select lemma="station" tags="n.*"/></match></rule>
  +
<rule weight="0.8"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match></rule>
  +
<rule weight="1.0"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match>
  +
<or><match lemma="llarg"/><match lemma="curt"/></or></rule>
  +
</pre>
  +
  +
Now, if we have the sequence "a una estación llarga", we would get:
  +
  +
* a _ estació → station = 1.0
  +
* estació → station = 1.2
  +
* estació → season = 0.8
  +
* estació → season llarga = 1.0
  +
  +
So which translation would win ? The "station" translation because <math>1.0 + 1.2 > 0.8 + 1.0</math>.
  +
  +
==Why do my rules not match?==
  +
  +
First off, read the above about rule weighting (lrx-proc will not always pick the longest match; you have to give it a higher weight to make it the preferred one).
  +
  +
Also, note that <code><match tags="n.*"></match></code> never matches anything, you have to write it like <code><match tags="n.*"/></code> (see https://sourceforge.net/p/apertium/tickets/64/ )
  +
  +
== See also ==
  +
* [[Constraint-based lexical selection module‎]]
   
 
[[Category:Documentation]]
 
[[Category:Documentation]]
  +
[[Category:Lexical selection]]
  +
[[Category:Documentation in English]]

Latest revision as of 13:21, 7 December 2015

This page is about how to start writing rules for lexical selection. It documents a few approaches, with example rules in the constraint-based lexical selection format.

First approach[edit]

Choose your words[edit]

Before you start making lexical selection rules, you first want to choose a word in your source language (e.g. English) which has more than one translation in your target language (e.g. Spanish). For example

  • argument → discusión
  • argument → polémica
  • argument → argumento

Think about context[edit]

The words around our word often help us decide how to translate it, for example, a verb might inform us of how to translate a noun, or a noun might inform us of how to translate an adjective.

If we say "to have an argument", then it probably means "discusión", whereas if we say "to accept the argument", then you probably want to translate it as "argumento".

Think about synonyms and antonyms[edit]

Once you have a rule, one way of making it more general is to think of synonyms and antonyms for the context words. For example, if you have the rule:

	<rule>
	  <match lemma="positive" tags="*"/>
	  <match lemma="charge" tags="n.*">
	    <select lemma="carga" tags="n.*"/>
	  </match>
	</rule>

You could quite easily think that the antonym of "positive" is "negative", and add that too:

	<rule>
          <or>
	    <match lemma="positive" tags="*"/>
	    <match lemma="negative" tags="*"/>
          </or>
	  <match lemma="charge" tags="n.*">
	    <select lemma="carga" tags="n.*"/>
	  </match>
	</rule>

Think about semantically related words[edit]

If you have the rule:

	<rule>
	  <match lemma="wind"/>
	  <match lemma="power" tags="n.*">
	    <select lemma="energía" tags="n.*"/>
	  </match>
	</rule>

You might think that the translation of "power" as "energía" (instead of the default translation poder) can happen more times than only after "wind", for example, "solar power" energía solar, "wave power" energía olamotriz. This might give, for example:

	<rule>
          <or>
	    <match lemma="wind"/>
	    <match lemma="solar"/>
	    <match lemma="hydro"/>
	    <match lemma="geothermal"/>
	    <match lemma="tidal"/>
          </or>
	  <match lemma="power" tags="n.*">
	    <select lemma="energía" tags="n.*"/>
	  </match>
	</rule>

And even thinking about these can bring you to other rules, for example "electrical power" is not energía eléctrica, it's potencia eléctrica.

Look at a concordance[edit]

A concordance (or "key word in context") is a set of sentences where they are centred on a single word (sometimes called the "key word"). To make a concordance you can use a concordancer (e.g. apertium-concord).

Here is an example from EuroParl:

   represent, to the President and to the Governor of Texas, Mr Bush, who has the power to order a stay
            We should do everything within our We should do everything within our power to force the
                      On the market, the balance of On the market, the balance of power between supply and
                  The scandalous concentration of The scandalous concentration of power in sectors of strategic 
  fact, retaining not only the The Commission is, in fact, retaining not only the power
  to your questions about the nuclear Turning to your questions about the nuclear power stations in
  financing required for improving the degree of efficiency and safety of nuclear power stations in certain 
     have the Mr President, it is clear that the European Union does not have the power to intervene in the
        the balance of I therefore feel we must carefully consider the balance of power that we are in
  the sea's Having spent a lot of time at sea myself I am well aware of the sea's power and destructive force, 
  The Commission is following with interest the planned construction of a nuclear power plant in Akkuyu, Turkey
    siting, construction, commissioning, operation and decommissioning of nuclear power plants in Turkey rests
  a serious risk that some idiot will decide that the new geopolitical balance of power in the Caucasus calls
  in the development of that nuclear If we see in the development of that nuclear power
  build a nuclear If the conclusion is that Turkey is planning to build a nuclear power plant that does not
  none of the upheaval would have been caused had we not acted with parliamentary power to press for changes
     yet the police are being forced into a position where they will not have the power to resist the terrorist
   right to interfere in the formation of a government even though it has assumed power on the basis of
       unusual about what is happening in Austria: there has been a changeover of power following democratic 
          for this Intergovernmental Conference to score a hat trick; that of the power to act, democratic 
  course, we need to create the At the same time of course, we need to create the power to act in order
      The European Union must also have the The European Union must also have the power to act
 
                           ...

If you do the concordance yourself, particularly interesting are the sequences: "nuclear power", "nuclear power station", "nuclear power plant", "parliamentary power", "sea's power", "balance of power", "concentration of power", "power to act", "motive power", "abuse of power", "decision-making power", "power supply", "come into power", "economic power", "power structures", "combined power and heat", "political power".

Try a parallel corpus[edit]

You can look at which contexts are used in one translation, but not another by looking at a parallel corpus.

$ paste europarl-v6.es-en.en europarl-v6.es-en.es | grep ' power .* potencia '
Since the Union as a whole is a world-class fishing '''power''' and one of the largest markets for fish produce, ...
Por ser la Unión en conjunto una '''potencia''' pesquera en el nivel mundial y uno de los mayores mercados de productos pesqueros, ...

Second approach[edit]

Another approach is to write rules to fix translation errors that you come across. In order to try this out, take a big text (for example a newspaper article), and run it through the translator.

For example, if we take this article, the translation is pretty bad, but there are some places where lexical selection could improve the picture.

MPs who had spent almost six hours debating the state of the UK economy voted by 213 to 79, a majority of 134.

MPs Quién había gastado casi seis horas debatiendo el estado de la economía de UK votada por 213 a 79, una mayoría de 134.

In English, "spend" can have a number of meanings, among them "to pass time" pasar and "to pay money" gastar. In this case, we see that the context demands the translation of pasar because it is talking about time spent. So, we might make a rule like the following:

	<rule> <!-- MPs spent almost six hours debating... -->
	  <match lemma="spend" tags="vblex.*">
	    <select lemma="pasar" tags="vblex.*"/>
	  </match>
	  <match/>
	  <match/>
          <or>
	    <match lemma="minute"/>
	    <match lemma="hour"/>
	    <match lemma="year"/>
          </or>
	</rule>


Rule weighting[edit]

Rule weighting is a bit complicated, partly because of how it works. So, suppose you have the following input:

^a<pr>/to<pr>$ ^un<det><ind><f><sg>/a<det><ind><sg>$ 
 ^estació<n><f><sg>/station<n><sg>/season<n><sg>$
 ^llarg<adj><f><sg>/long<adj><sint>$

If you have the following rules:

  <rule weight="1.0"><match lemma="estació" tags="n.*"><select lemma="station" tags="n.*"/></match></rule>
  <rule weight="1.0"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match></rule>

Then both translations with no context have an equal weight. Which one is picked will depend on how the transducer is minimised (e.g. it will be non-deterministic). If you want one translation to have a higher weight than another, then you can just adjust the weight:

  <rule weight="1.2"><match lemma="estació" tags="n.*"><select lemma="station" tags="n.*"/></match></rule>
  <rule weight="0.8"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match></rule>

Now "station" will be picked, as . Now, how about if we want to add some context in there. We can just add another rule:

  <rule weight="1.2"><match lemma="estació" tags="n.*"><select lemma="station" tags="n.*"/></match></rule>
  <rule weight="0.8"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match></rule>
  <rule weight="1.0"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match>
                     <or><match lemma="llarg"/><match lemma="curt"/></or></rule>

So, if we have the sequence above "a una estació llarga", then the "season" translation will get and the station translation will get meaning that "season" will be picked...

But let's not stop there, the preposition can also give us some information, so let's add another rule:

  <rule weight="1.0"><or><match lemma="a"/><match lemma="en"/></or><match/>
                     <match lemma="estació" tags="n.*"><select lemma="station" tags="n.*"/></rule>
  <rule weight="1.2"><match lemma="estació" tags="n.*"><select lemma="station" tags="n.*"/></match></rule>
  <rule weight="0.8"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match></rule>
  <rule weight="1.0"><match lemma="estació" tags="n.*"><select lemma="season" tags="n.*"/></match>
                     <or><match lemma="llarg"/><match lemma="curt"/></or></rule>

Now, if we have the sequence "a una estación llarga", we would get:

  • a _ estació → station = 1.0
  • estació → station = 1.2
  • estació → season = 0.8
  • estació → season llarga = 1.0

So which translation would win ? The "station" translation because .

Why do my rules not match?[edit]

First off, read the above about rule weighting (lrx-proc will not always pick the longest match; you have to give it a higher weight to make it the preferred one).

Also, note that <match tags="n.*"></match> never matches anything, you have to write it like <match tags="n.*"/> (see https://sourceforge.net/p/apertium/tickets/64/ )

See also[edit]