RC-A1

From UNL Wiki
(Difference between revisions)
Jump to: navigation, search
(The corpus)
m (moved UC-A1 to RC-A1: revert)
 
(39 intermediate revisions by one user not shown)
Line 1: Line 1:
The UC-A1 is an experimental corpus used to prepare the initial versions of the grammar for sentence-based [[UNLization]] and [[NLization]], using [[IAN]] and [[EUGENE]], respectively. It comprises a list of 100 structures in UNL, and is supposed to cover very basic linguistic phenomena.  
+
The UC-A1 is an experimental corpus used to prepare the initial versions of the grammar for sentence-based [[UNLization]] and [[NLization]], using [[IAN]] and [[EUGENE]], respectively. It comprises a list of 50 structures in UNL, and is supposed to cover very basic linguistic phenomena.  
  
 
== The corpus ==
 
== The corpus ==
*UC-A1 in one single file
+
The corpus UCA1 was extracted from a simplified and translated version of "The Hare and the Tortoise", by Aesop.
**[http://www.unlweb.net/resources/corpus/UCA1/UCA1_eng.txt UC-A1 in English], to be (manually) translated to your target language in order to be used as the input for the UNLization process (with [[IAN]])
+
*[http://www.unlweb.net/resources/UCA1/uca1_eng.txt UC-A1 in English], to be translated (manually) in order to be used as the input for the UNLization process (with [[IAN]])
**[http://www.unlweb.net/resources/corpus/UCA1/UCA1_unl.txt UC-A1 in UNL], to be used, "as is" (i.e., without any change), as the input for the NLization process (with [[EUGENE]])
+
*[http://www.unlweb.net/resources/UCA1/uca1_unl.txt UC-A1 in UNL], to be used "as is", as the input for the NLization process (with [[EUGENE]])
*UC-A1 in different files (the same as above, but divided according to the different classes)
+
{|+CorpusA1 border=1 align=center cellpadding=5
+
!Type
+
!English*
+
!UNL**
+
!Examples
+
!Number of sentences
+
|-
+
|Temporary entries
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_TEMP_eng.txt UCA1_TEMP_eng.txt]***
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_TEMP_unl.txt UCA1_TEMP_unl.txt]
+
|[[English_grammar/Temporary_entries|Temporary Entries]]
+
|align=center|5
+
|-
+
|Determiners
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_DET_eng.txt UCA1_DET_eng.txt]
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_DET_unl.txt UCA1_DET_unl.txt]
+
|[[English_grammar/Determiners|Determiners]]
+
|align=center|10
+
|-
+
|Possessive determiners
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_SPR_eng.txt UCA1_SPR_eng.txt]
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_SPR_unl.txt UCA1_SPR_unl.txt]
+
|[[English_grammar/Determiners|Determiners]]
+
|align=center|10
+
|-
+
|Prepositions
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_PRE_eng.txt UCA1_PRE_eng.txt]
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_PRE_unl.txt UCA1_PRE_unl.txt]
+
|[[English_grammar/Prepositions|Prepositions]]
+
|align=center|20
+
|-
+
|Conjunctions
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_CJC_eng.txt UCA1_CJC_eng.txt]
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_CJC_unl.txt UCA1_CJC_unl.txt]
+
|[[English_grammar/Conjunctions|Conjunctions]]
+
|align=center|10
+
|-
+
|Noun phrase structure
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_NP_eng.txt UCA1_NP_eng.txt]
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_NP_unl.txt UCA1_NP_unl.txt]
+
|[[English_grammar/NP|NP]]
+
|align=center|20
+
|-
+
|Verb forms
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_VER_eng.txt UCA1_VER_eng.txt]
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_VER_unl.txt UCA1_VER_unl.txt]
+
|[[English_grammar/Verbs|Verbs]]
+
|align=center|10
+
|-
+
|Sentence structures
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_S_eng.txt UCA1_S_eng.txt]
+
|[http://www.unlweb.net/resources/corpus/UCA1/UCA1_S_unl.txt UCA1_S_unl.txt]
+
|[[English_grammar/Sentences|Sentences]]
+
|align=center|15
+
|}
+
<nowiki>*</nowiki>To be manually translated to your target language in order to be used as the input for UNLization (IAN)<br />
+
<nowiki>**</nowiki>To be used as the input for NLization (EUGENE)<br />
+
<nowiki>***</nowiki>Do not translate (or transliterate) the temporary entries<br />
+
 
+
== Goals ==
+
#To provide the dictionary and grammars necessary to '''UNLize''' your translated version of UC-A1 (with [[IAN]])
+
#To provide the dictionary and grammars necessary to '''NLize''', to your target language, the UNL version of UC-A1 (with [[EUGENE]])
+
 
+
== Methodology ==
+
In order to prepare the dictionaries and grammars to deal with the UC-A1, follow the steps below:
+
=== UNLization ===
+
#Corpus
+
##Translate (manually) the sentences of the [http://www.unlweb.net/resources/corpus/UCA1/UCA1_eng.txt UC-A1] from English into your native language. Be as close as possible to the original, and provide one single translation for each sentence. This will be your input document file, and your goal will be to provide (automatically, through [[IAN]]) the UNL graphs for each sentence
+
##Save the translated text (without the English original) in a plain text (.txt) file with UTF-8 encoding and upload it to UNLWEB>UNLDEV>IAN>NL FILES.
+
#Dictionary
+
##Localize the dictionary available at [http://www.unlweb.net/resources/dic/UCA1/eng_unl_dic.txt eng_unl_dic.txt]. Note that "localization" is not the same as "translation". You may need other features (in English, for instance, nouns do not have gender or case) or other entries. In any case, the resulting dictionary should fit your translated version of the corpus (i.e., all the entries appearing in your translated version of the corpus should appear in the dictionary). For further information on localization, see [[Localization]]. For information on the dictionary structure, see [[Dictionary Specs]]. For an explanation of the structure of the English dictionary, see [[English_dictionary|English Dictionary]]. In case you need additional features, use only the tags available at the [[tagset]].
+
##Save the NL-UNL dictionary in a plain text (.txt) file with UTF-8 encoding and upload it to UNLWEB>UNLDEV>IAN>DICTIONARIES.
+
#Grammar
+
##Create the NL-UNL (analysis) transformation grammar necessary to analyze, in UNL, the natural language sentences of the translated corpus. This grammar is the most difficult (and the actual goal) of the whole analysis task. In order to prepare the grammar, study the [[Grammar Specs]]. Next, take a look at the structure of the [[English_grammar|English Grammar]] for a detailed example. In many cases, it would be simpler just to localize the English grammar to your own locale rather than creating a whole grammar from the scratch. See the instructions at [[Localization]]. The grammar is normally developed inside IAN, because we have to test it every time. But you may also prepare a draft grammar, save it in a plain text (.txt) file with UTF-8 encoding and upload it to UNLWEB>UNLDEV>IAN>T-RULES.
+
##Create the NL-UNL (analysis) disambiguation grammar in order to improve the results of the transformation and to control the process of tokenization. Again, this  grammar is normally developed inside IAN (at the D-RULES tab), because we have to test it every time. Consult the [[English_grammar|English Grammar]] for a detailed example of a disambiguation grammar.
+
##Test the grammar against the corpus and provide the necessary changes.
+
 
+
=== NLization ===
+
#Corpus
+
##Upload the file [http://www.unlweb.net/resources/corpus/UCA1/UCA1_unl.txt UCA1_unl.txt] to UNLWEB>UNLDEV>EUGENE>UNL DOCUMENT. Do not do any change to this file.
+
#Dictionary
+
##Localize the dictionary available at [http://www.unlweb.net/resources/corpus/UCA1/unl_eng_dic.txt unl_eng_dic.txt] to your locale. Note, once again, that localization is not the same as translation. The localized version must reflect the word list of your translated corpus. In any case, use only the tags available at the [[tagset]]. For further information on the dictionary structure, see [[Dictionary Specs]].
+
##Save the UNL-NL dictionary in a plain text (.txt) file with UTF-8 encoding and upload it to UNLWEB>UNLDEV>PROJECTS>EUGENE>DICTIONARIES.
+
#Grammar
+
##Provide the UNL-NL (generation) T-grammar and D-grammar necessary to generate natural language sentences from the UNL corpus. Follow the sample instructions available for the analysis grammar.
+
 
+
== Samples and Examples ==
+
The following resources have been used to deal with UC-A1 in English and may be used as a sample of what is expected to be provided
+
*UNLization
+
**[http://www.unlweb.net/resources/dic/UCA1/eng_unl_dic.txt ENG-UNL Dictionary] (English dictionary used for the UNLization of UC-A1) (Documentation available at [[English_dictionary|English Dictionary]])
+
**[http://www.unlweb.net/resources/grammar/UCA1/eng_unl_tgrammar.txt ENG-UNL T-Grammar] (Transformation grammar used for the UNLization of UC-A1) (Documentation available at [[English_grammar|English Grammar]])
+
**[http://www.unlweb.net/resources/grammar/UCA1/eng_unl_dgrammar.txt ENG-UNL D-Grammar] (Disambiguation grammar used for the UNLization of UC-A1) (Documentation available at [[English_grammar|English Grammar]])
+
*NLization
+
**[http://www.unlweb.net/resources/dic/UCA1/unl_eng_dic.txt UNL-ENG Dictionary] (English dictionary used for the NLization of UC-A1) (Documentation available at [[English_dictionary|English Dictionary]])
+
**[http://www.unlweb.net/resources/dic/UCA1/unl_eng_tgrammar.txt UNL-ENG T-Grammar] (Transformation grammar used for the NLization of UC-A1) (Documentation available at [[English_grammar|English Grammar]])
+
 
+
== Recommended Readings ==
+
Before starting the activity, and in order to fully understand what is expected to be done, it is important for you to be acquainted with the following documentation:
+
*[[Tagset]], because you are expected to use only the tags included in the tagset
+
*[[UNL Dictionary Specs]], which is essential to understand the dictionary structure
+
*[[UNL Grammar Specs]], which is essential to understand the grammar structure
+
It is also interesting to make a test drive with [[IAN]] and [[EUGENE]].
+

Latest revision as of 12:56, 2 June 2018

The UC-A1 is an experimental corpus used to prepare the initial versions of the grammar for sentence-based UNLization and NLization, using IAN and EUGENE, respectively. It comprises a list of 50 structures in UNL, and is supposed to cover very basic linguistic phenomena.

The corpus

The corpus UCA1 was extracted from a simplified and translated version of "The Hare and the Tortoise", by Aesop.

  • UC-A1 in English, to be translated (manually) in order to be used as the input for the UNLization process (with IAN)
  • UC-A1 in UNL, to be used "as is", as the input for the NLization process (with EUGENE)
Software