![](\"images/tf-small.png\")
\n",
"![](\"images/etcbc.png\"/)
\n",
"![](\"images/dans-small.png\"/)
\n",
"\n",
"You might want to consider the [start](search.ipynb) of this tutorial.\n",
"\n",
"Short introductions to other TF datasets:\n",
"\n",
"* [Dead Sea Scrolls](https://nbviewer.jupyter.org/github/annotation/tutorials/blob/master/lorentz2020/dss.ipynb),\n",
"* [Old Babylonian Letters](https://nbviewer.jupyter.org/github/annotation/tutorials/blob/master/lorentz2020/oldbabylonian.ipynb),\n",
"or the\n",
"* [Quran](https://nbviewer.jupyter.org/github/annotation/tutorials/blob/master/lorentz2020/quran.ipynb)\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"tags": []
},
"source": [
"# Upgrade features along a node mapping\n",
"\n",
"Consider the semantic actor features in \n",
"[ch-jensen/participants/actor/tf](https://github.com/ch-jensen/participants/tree/master/actor/tf).\n",
"\n",
"We see only features for version ``c`` of the BHSA, but we prefer to work with version `2021` of the BHSA.\n",
"\n",
"When we try to load the features by simply saying\n",
"\n",
"```\n",
"A = use(\"ETCBC/bhsa\", mod=\"ch-jensen/participants/actor/tf\")\n",
"```\n",
"\n",
"we have no luck, because there is no `ch-jensen/participants/actor/tf/2021` on GitHub.\n",
"\n",
"But, one of the features in the BHSA is `omap@c-2021.tf` and this contains the information to map\n",
"all nodes in version `c` to the nodes of version `2021`, as faithfully as is reasonably possible.\n",
"\n",
"My homework as Text-Fabric developer is to make it so that the statement above works, by steering Text-Fabric\n",
"to download version `c` and using the mapping feature to produce upgraded data in the right place.\n",
"But I have not get round to that yet.\n",
"\n",
"So, here is what *you* can do about it 😎.\n",
"\n",
"1. File an [issue](https://github.com/ch-jensen/participants/issues) and ask Christian whether he is inclined to\n",
" use his software to build the features against BHSA version 2021.\n",
" *But he might be too busy to do that right now.*\n",
"2. Fork [ch-jensen/participants](https://github.com/ch-jensen/participants) and try to run his software yourself.\n",
" *That might not be easy. It seems that the code to run is in another repository.\n",
" Is all the input data publicly available? Are special settings needed for version 2021?\n",
" Is the software still executable?*\n",
"3. Do fork the repo by all means, and then use a tool of text-fabric to *upgrade* the features of the older version\n",
" to the newer version.\n",
" \n",
"We take you through the last option and evaluate how well the upgrade process fares."
]
},
{
"cell_type": "code",
"execution_count": 1,
"metadata": {},
"outputs": [],
"source": [
"%load_ext autoreload\n",
"%autoreload 2"
]
},
{
"cell_type": "markdown",
"metadata": {
"tags": []
},
"source": [
"# Incantation\n",
"\n",
"The ins and outs of installing Text-Fabric, getting the corpus, and initializing a notebook are\n",
"explained in the [start tutorial](start.ipynb)."
]
},
{
"cell_type": "code",
"execution_count": 2,
"metadata": {
"ExecuteTime": {
"end_time": "2018-05-24T10:06:39.818664Z",
"start_time": "2018-05-24T10:06:39.796588Z"
}
},
"outputs": [],
"source": [
"import collections\n",
"\n",
"from tf.app import use\n",
"from tf.fabric import Fabric\n",
"from tf.dataset.nodemaps import Versions"
]
},
{
"cell_type": "markdown",
"metadata": {
"tags": []
},
"source": [
"## Load the current version of the BHSA\n",
"\n",
"We need the current version (`2021`) of the BHSA anyway, so we are going to load it.\n",
"\n",
"## Convention\n",
"\n",
"We will have two versions of the corpus in our notebook and in our variables.\n",
"It is handy to have a consistent naming scheme:\n",
"\n",
"* `N` (the *now* version): `2021`\n",
"* `P` (the *previous* version): `c`"
]
},
{
"cell_type": "code",
"execution_count": 3,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"TF-app: ~/text-fabric-data/github/etcbc/bhsa/app"
],
"text/plain": [
"| n | p | phrase_atom |
|---|---|---|
| 1 | Leviticus 25:11 | 945873tihyˈeh |
| 2 | Leviticus 25:12 | 945886yôvˈēl |
| 3 | Leviticus 25:12 | 945887hˈiw |
| 4 | Leviticus 25:12 | 945888qˌōḏeš |
| 5 | Leviticus 25:12 | 945889tihyˈeh |
| 6 | Leviticus 25:51 | 946353baššānˈîm |
| 7 | Leviticus 25:52 | 946362baššānˈîm |
| n | p | phrase_atom |
|---|---|---|
| 1 | Leviticus 25:10 | 945830šānˈā |
| 2 | Leviticus 25:11 | 945851šānˌā |
| 3 | Leviticus 25:11 | 945852tihyˈeh |
| 4 | Leviticus 25:12 | 945865yôvˈēl |
| 5 | Leviticus 25:12 | 945866hˈiw |
| 6 | Leviticus 25:12 | 945867qˌōḏeš |
| 7 | Leviticus 25:12 | 945868tihyˈeh |
| 8 | Leviticus 25:51 | 946332baššānˈîm |
| 9 | Leviticus 25:52 | 946341baššānˈîm |
sentence 1
" ], "text/plain": [ "