| Both sides previous revisionPrevious revision | |
| en:manualy:kontext:korpusy [2023/03/09 11:05] – jankocek | en:manualy:kontext:korpusy [2023/03/13 15:17] (current) – lukes |
|---|
| ====== Menu: Corpora ====== | ====== Menu: Corpora ====== |
| |
| FIXME The first menu item **Available corpora** opens a page where the user can search for all corpora to which he has access. | The first menu item **Available corpora** shows a list of accessible corpora which can be filtered according to various criteria. |
| |
| The remaining three items are dedicated to **virtual sub-corpora** (i.e. subsets of texts from the original corpus). Here it is possible both to create your own subcorpus and to manage existing subcorpora (work with the subcorpus draft, view finished subcorpora, archive them, delete them, etc.). | The remaining three items are dedicated to **virtual subcorpora** (i.e. subsets of texts from the original corpus). Here it is possible both to create your own subcorpus and to manage existing subcorpora (work on a subcorpus draft, view existing subcorpora, archive them, delete them, etc.). |
| |
| Subcorpora are tied to the user account. Virtual subcorpora are therefore available to [[en:kurz:zaciname|registered]] users from any computer, provided that they sign in with their username and password. The search results in each individual subcorpus are also visible to other users (e.g. by sending a link to concordances or frequency distribution tables created on the subcorpus data). The entire subcorpus can also be published among public subcorpora if the user fills in the public subcorpus description field. FIXME | Subcorpora are tied to the user account. Virtual subcorpora are therefore available to [[en:kurz:zaciname|registered]] users from any computer, provided that they sign in with their username and password. The search results in each individual subcorpus are also visible to other users (e.g. by sending a link to concordances or frequency distribution tables created on the subcorpus data). The subcorpus itself can also be made public if the user fills in the public subcorpus description field. |
| |
| Generally speaking, a subcorpus is only an additional condition which is applied to all queries in the search. For example, if we are searching for the lemma //dřevo// in the fiction subcorpus SYN2020:beletrie, the query will automatically add the condition [[en:pojmy:within|within]], which specifies the texts of the corpus [[en:cnk:syn2020|SYN2020]] in which the search is to be conducted. | Generally speaking, a subcorpus is only an additional condition which is applied to all queries in the search. For example, if we are searching for the lemma //dřevo// in the fiction subcorpus SYN2020:beletrie, the query will automatically add the condition [[en:pojmy:within|within]], which specifies the texts of the corpus [[en:cnk:syn2020|SYN2020]] in which the search is to be conducted. |
| - a default corpus, from which the text will be selected | - a default corpus, from which the text will be selected |
| - a subcorpus name, an unambiguous identifier which has not been previously used in the list of existing subcorpora | - a subcorpus name, an unambiguous identifier which has not been previously used in the list of existing subcorpora |
| - FIXME if we wish the subcorpus to be searchable using the page **Corpora → Public subcorpora**, we fill in the public description (if the field is left blank, the subcorpus as a whole will be unsearchable) FIXME | - if we wish the subcorpus to be publicly accessible via the page **Corpora → Public subcorpora**, we fill in the public description (if the field is left blank, the subcorpus will not appear there, though individual query results will still be public) |
| - a condition based on which we select the text for the subcorpus | - a condition based on which we select the text for the subcorpus |
| |
| [{{ :en:manualy:kontext:subkorpus_50-50.png?direct&300|Subcorpus created according to your own criteria}}] | [{{ :en:manualy:kontext:subkorpus_50-50.png?direct&300|Subcorpus created according to your own criteria}}] |
| |
| FIXME If a subcorpus is created by selecting structural attribute values, the resulting subcorpus can be combined in a concordance query with an ad hoc selection of text type values, where the values corresponding to the content of the selected subcorpus are automatically preselected at the beginning. This makes it possible to further specify the desired text types in the subcorpus. | If a subcorpus is created by selecting structural attribute values, the resulting subcorpus can be combined in a concordance query with an ad hoc selection of text type values, where the values corresponding to the content of the selected subcorpus are automatically preselected at the beginning. This makes it possible to further refine the desired text types in the subcorpus. |
| |
| Another option is to mix the subcorpus according to your own criteria (e.g. 50% of texts from fiction and 50% of journalistic texts). If you want to use this feature, when creating the subcorpus, tick the desired text types within the selected attribute and then click on **Refine selection**. This will make the **Custom text type proportions** function available. So, for example, if we want a SYN2015 journalism subcorpus that contains 50% national press and 50% regional press (the default is 75% national press and 25% regional press), we check both desired genres -- NTW: national press and REG: regional press -- in the doc.genre field and narrow the selection. Then we select the Custom text type ratios function and change the ratios to 50% and 50%. The resulting subcorpus will contain randomly selected texts from both genres in the ratio we chose. FIXME | Another option is to automatically sample texts to satisfy user-specified proportions (e.g. 50% of texts from fiction and 50% of journalistic texts). If you want to use this feature, when creating the subcorpus, tick the desired text types within the selected attribute and then click on **Refine selection**. This will make the **Custom text type proportions** function available. So, for example, if we want a SYN2015 journalism subcorpus that contains 50% national press and 50% regional press (the default is 75% national press and 25% regional press), we check both desired genres -- NTW: national press and REG: regional press -- in the doc.genre field and narrow the selection. Then we select the Custom text type ratios function and change the ratios to 50% and 50%. The resulting subcorpus will contain randomly selected texts from both genres in the ratio we chose. |
| |
| <WRAP round important 60%> | <WRAP round important 60%> |
| FIXME Please be aware that the use of more than one structural attribute can easily lead to specifications that cannot be satisfied by any selection of texts from the original corpus. In this case, a subcorpus will not be created. FIXME | Please be aware that the use of more than one structural attribute can easily lead to specifications that cannot be satisfied by any selection of texts from the original corpus. In this case, no subcorpus will be created. |
| </WRAP> | </WRAP> |
| |
| ==== Creating a subcorpus draft on the concordance query page ==== | ==== Creating a subcorpus draft on the concordance query page ==== |
| |
| FIXME The subcorpus can also be created directly on the concordance query page under the Restrict search option. After checking the selected segments just click on the **Save as a subcorpus draft** option. To make a subcorpus active, you need to go to the menu **Corpora → My subcorpora**, find the subcorpus draft in the table and use the gear icon to open the subcorpus properties and then finalize it (see the following section). FIXME | The subcorpus can also be created directly on the concordance query page under the Restrict search option. After checking the selected segments just click on the **Save as a subcorpus draft** option. To make a subcorpus active, you need to go to the menu **Corpora → My subcorpora**, find the subcorpus draft in the table and use the gear icon to open the subcorpus properties and then finalize it (see the following section). |
| ===== My subcorpora ===== | ===== My subcorpora ===== |
| |
| [{{ :en:manualy:kontext:subkorpus_prehled.png?direct&400|A list of the user’s existing subcorpora }}] | [{{ :en:manualy:kontext:subkorpus_prehled.png?direct&400|A list of the user’s existing subcorpora }}] |
| |
| FIXME The section **Corpora → My Subcorpora** provides a list of all the subcorpora (nebo jejich připravených konceptů) defined by the user. Next to their name in the table is also their size (in the number of [[en:pojmy:pozice|positions]]) and the date they were created. Simultaneously, on each line you can use the gear icon to open a special menu and change the properties of the subcorpus: | The section **Corpora → My subcorpora** provides a list of all the subcorpora (including drafts) defined by the user. The table lists their name, their size (as the number of [[en:pojmy:pozice|positions]]) and the date they were created. Each line also contains a gear icon you can use to open a special menu and change the properties of the subcorpus: |
| |
| - If the subcorpus is in the draft status, you can finalize its settings (modify its structure, or add its public description) and convert it to the active status by selecting **Finalize subcorpus** on the File bar. | - If the subcorpus is in draft status, you can finalize its settings (modify its structure, or add its public description) and convert it to active status by selecting **Finalize subcorpus** in the File tab. |
| - You can change the text selection of a given subcorpus using the **Subcorpus structure** bar only for the subcorpus draft. However, if the user changes the structure of an already created subcorpus, the settings can then be simply copied to a new subcorpus with the new name using the **Save as...** option. | - Only drafts allow changing the text selection of a given subcorpus using the **Subcorpus structure** tab. However, if the user changes the structure of an already created subcorpus, the settings can then be simply copied to a new subcorpus using the **Save as...** option. |
| - For each sub-corpus, the name can be changed as well as the public searchability by adding or deleting the description in the **Name and public description** bar. | - For each subcorpus, the name can be changed and public availability can be modified by adding or deleting the description in the **Name and public description** tab. |
| - If the user no longer plans to actively work with the subcorpus, she can archive it (using the **Archive** button on the File bar). In this case, the subcorpus will be hidden in the My Subcorpora list, will not appear on the search pages, and will not be publicly searchable. However, the URLs created for the search results will still work. If necessary, an archived subcorpus can also be displayed in my subcorpus list at a later time (by checking **Show archived corpora as well**) and restored to its original state. | - If the user no longer plans to actively work with the subcorpus, it can be archived (using the **Archive** button on the File tab). In this case, the subcorpus will be hidden in the My subcorpora list, will not appear on the search pages, and will not be publicly accessible. However, the URLs created for the search results will still work. If necessary, an archived subcorpus can also be displayed in the My subcorpora list at a later time (by checking **Show archived corpora as well**) and restored to its original state. |
| - Subcorpora can also be permanently deleted by clicking the **Delete** button on the File bar. In this case, all subcorpus data is already physically removed, and the existing URLs are no longer valid. This procedure is therefore more appropriate for subcorpora that have not yet been shared between users, or if there is a serious reason to remove them. | - Subcorpora can also be permanently deleted by clicking the **Delete** button in the File tab. In this case, all subcorpus data is irretrievably removed, and the existing URLs are no longer valid. This procedure is therefore more appropriate for subcorpora that have not yet been shared between users, or if there is a serious reason to remove them. |
| |
| The list contains all of the user’s corpora. At the same time they can be filtered by individual original corpora. FIXME However, it must be repeated that subcorpora ale always tied to the default (original) corpus. Therefore, if we create a fiction subcorpus from the corpus [[en:cnk:syn2020|SYN2020]] based on a general condition or by selecting one of the options, it doesn’t mean that we will also have at our disposition an analogical subcorpus of fiction from the corpus [[en:cnk:syn2015|SYN2015]]. | The list contains all of the user’s subcorpora and allows for filtering based on the original parent corpus. However, it must be repeated that subcorpora ale always tied to the default (original) corpus. Therefore, if we create a fiction subcorpus from the corpus [[en:cnk:syn2020|SYN2020]] based on a general condition or by selecting one of the options, it doesn’t mean that we will also have at our disposition an analogical subcorpus of fiction from the corpus [[en:cnk:syn2015|SYN2015]]. |
| |
| ==== Using subcorpora ==== | ==== Using subcorpora ==== |
| ===== Public subcorpora ===== | ===== Public subcorpora ===== |
| |
| FIXME The results of subcorpus searches can be made available to other users by simply posting a link (assuming the users have access to the source corpus from which the subcorpus is created). However, it is also possible to share subcorpora as a whole, if the user fills in the **Public subcorpus description** field when creating a corpus (on the **Corpora → Create new subcorpus** page) or editing it (in the menu on the **Corpora → My subcorpora** page). | The results of subcorpus searches can be made available to other users by simply sharing a link (assuming the users have access to the original parent corpus from which the subcorpus is derived). However, it is also possible to share subcorpora as a whole, if the user fills in the **Public subcorpus description** field when creating a subcorpus (on the **Corpora → Create new subcorpus** page) or editing it (in the menu on the **Corpora → My subcorpora** page). |
| |
| Each subcorpus is assigned a unique key (e.g. ''7e06d19af7'') that can be shared and used to access the corpus from the menu **Corpus > Public subcorpora**. Alternatively, a public subcorpus can also be searched by the author's last name. The unique key can be displayed in the corpus properties on the **Corpora → My subcorpora** page, or if the user selects a corpus to work on and has information about it displayed (link at the beginning of the navigation with the concordance editing sequence under the KonText logo). FIXME | Each subcorpus is assigned a unique key (e.g. ''7e06d19af7'') that can be shared and used to access the corpus from the menu **Corpus → Public subcorpora**. Alternatively, a public subcorpus can also be retrieved using the author's last name. This unique key is displayed either in the subcorpus properties on the **Corpora → My subcorpora** page (by clicking on the gear icon), the search results on **Corpus → Public subcorpora**, or if the corpus is already selected, by clicking on its name at the beginning of the navigation with the concordance editing sequence under the KonText logo. |
| |
| ---- | ---- |
