Skip to content
Snippets Groups Projects
Commit be2c7f71 authored by Ribary, Marton Dr (School of Law)'s avatar Ribary, Marton Dr (School of Law)
Browse files

Footnotes in SQL README.md

parent 4f0d46b3
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
Showing
with 18 additions and 30 deletions
sql/README.md
+ 18
− 30
View file @ be2c7f71
......@@ -16,7 +16,7 @@ The _Digest_ is the definitive Roman law compendium compiled under emperor Justi
[6. Footnotes](#6-footnotes)
### 1. Instructions for using `digest.db`
### 1. Instructions for using `digest.db` [↩](#0-table-of-contents)
The database can be queried with `SQL` statements in four types of `SQLite` interfaces listed below. All of these interfaces are free of charge. They all support exporting the result of `SQL` queries in a `csv` flat file to be opened in a notebook, text or spreadsheet editor.
......@@ -38,17 +38,15 @@ The database can be connected directly in a Python script with the `sqlite3` pac
Alternatively, one may export tables and results of `SQL` statements as `csv` flat files which could be loaded as `pandas` dataframes into a Python code for further processing.
[Back to Table of contents](#0-table-of-contents)
### 2. Tables of the database
### 2. Tables of the database [↩](#0-table-of-contents)
#### 2.1 `text`
The core "text" table includes the 21,055 text units with foreign keys which chain text units in many-to-one relationships to supplementary information stored in other tables. The text is pulled from the Amanuensis software[<sup id="inline1">1</sup>](#fn1) incorporating the the text from the ROMTEXT database.[<sup id="inline2">2</sup>](#fn2) The text itself is from Theodor Mommsen's printed edition of the _Digest_.[<sup id="inline3">3</sup>](#fn3) The numbering by books, sections, passages and text units follows the schoalrly convention. In Mommsen, if a passage includes multiple sentences (here denoted as "text units"), the first one is marked by "r.", the second by "1" and so on. This zero numbering is reflected in the database with "0" replacing Mommsen's "r."
The core "text" table includes the 21,055 text units with foreign keys which chain text units in many-to-one relationships to supplementary information stored in other tables. The text is pulled from the Amanuensis software<sup id="a1">[1](#f1)</sup> incorporating the the text from the ROMTEXT database.<sup id="a2">[2](#f2)</sup> The text itself is from Theodor Mommsen's printed edition of the _Digest_.<sup id="a3">[3](#f3)</sup> The numbering by books, sections, passages and text units follows the schoalrly convention. In Mommsen, if a passage includes multiple sentences (here denoted as "text units"), the first one is marked by "r.", the second by "1" and so on. This zero numbering is reflected in the database with "0" replacing Mommsen's "r."
#### 2.2 `jurist`
The "jurist" table lists the 37 jurists quoted in the _Digest_ with estimated dates for their "birth", their most active "date" and their "death". The dates are based on the articles written on the individual jurists in the _Paulys Realenzylkopädie_[<sup id="inline4">4</sup>](#fn4) and Adolf Berger's _Dictionary of Roman law_.[<sup id="inline5">5</sup>](#fn5) Dates were calculated on the assumption that jurists lived a maximum life expectancy of 60 years and they were the most active at the age of 40. These assumptions are based on the studies by Bruce Frier[<sup id="inline6">6</sup>](#fn6) and Walter Scheidel.[<sup id="inline7">7</sup>](#fn7)
The "jurist" table lists the 37 jurists quoted in the _Digest_ with estimated dates for their "birth", their most active "date" and their "death". The dates are based on the articles written on the individual jurists in the _Paulys Realenzylkopädie_<sup id="a4">[4](#f4)</sup> and Adolf Berger's _Dictionary of Roman law_.<sup id="a5">[5](#f5)</sup> Dates were calculated on the assumption that jurists lived a maximum life expectancy of 60 years and they were the most active at the age of 40. These assumptions are based on the studies by Bruce Frier<sup id="a6">[6](#f6)</sup> and Walter Scheidel.<sup id="a7">[7](#f7)</sup>
#### 2.3 `book`
......@@ -64,11 +62,9 @@ The "section" table includes the titles of the _Digest_'s 432 thematic sections
#### 2.6 `bko`
The "bko" table presents information related to the theory about the _Digest_'s compositional structure formulated by Friedrich Bluhme in 1820[<sup id="inline8">8</sup>](#fn8) and revised by Paul Krüger for Theodor Mommsen's edition of the _Digest_. The theory was accompanied by a tabular summary known as the Bluhme-Krüger Ordo (hence "bko") which was revised and expanded by Tony Honoré.[<sup id="inline9">9</sup>](#fn9)
[Back to Table of contents](#0-table-of-contents)
The "bko" table presents information related to the theory about the _Digest_'s compositional structure formulated by Friedrich Bluhme in 1820<sup id="a8">[8](#f8)</sup> and revised by Paul Krüger for Theodor Mommsen's edition of the _Digest_. The theory was accompanied by a tabular summary known as the Bluhme-Krüger Ordo (hence "bko") which was revised and expanded by Tony Honoré.<sup id="a9">[9](#f9)</sup>
### 3. Sample SQL queries
### 3. Sample SQL queries [↩](#0-table-of-contents)
There are some sample queries in the `SQL_queries.txt` file to assist users unfamiliar with the `SQL` query language. These queries are ready to be copy-pasted as a multi-line `SQL` statement into the interface of your choice. The queries can be customised by replacing the relevant values. Names of tables and their columns are fixed, but all other values can be customised. Please play around and [send a message](mailto:m.ribary@surrey.ac.uk) for [support](#52-support-for-sql-queries).
......@@ -119,9 +115,7 @@ ON t.jurist_id = j.id
WHERE (t.text like '%proprieta%') AND (j.id = 23);
```
[Back to Table of contents](#0-table-of-contents)
### 4. Future steps
### 4. Future steps [↩](#0-table-of-contents)
The current version of `digest.db` is intended to be polished with input from its users. While major flaws and inconsistencies in the data were captured during the pre-processing stage, it is expected that typographical errors and some inconsistencies remain. Please leave a comment or send an [email](mailto:m.ribary@surrey.ac.uk), if you spot an error. A reporting tool or a collaborative editing method will de added in due course.
......@@ -129,9 +123,7 @@ The database is also intended to be enriched with additional features in its tab
Currently there is no custom-made GUI for using `digest.db`. As the project and the database matures, an appropriate user-friendly interface and visualisation tool will be created to open up the database to those less familiar with the `SQL` query language.
[Back to Table of contents](#0-table-of-contents)
### 5. Support for users
### 5. Support for users [↩](#0-table-of-contents)
#### 5.1 Feedback and collaborative development
......@@ -143,26 +135,22 @@ In time, the database will receive a custom interface which builds on top the `S
Please leave a comment or send an [email](mailto:m.ribary@surrey.ac.uk), if you would like to request a sample `SQL` query for your research, or if you need help with adjusting one of the existing queries. These queries will be continuously added to the `SQL_queries.txt` file.
[Back to Table of contents](#0-table-of-contents)
### 6. Footnotes
[<sup id="fn1">1</sup>](#inline1) Peter Riedlberger and Günther Rosenbaum, eds. (2020): _Amanuensis_ V5.0. München. URL: http://www.riedlberger.de/08amanuensis.html [Last accessed on 19 May 2020]
### 6. Footnotes [↩](#0-table-of-contents)
[<sup id="fn2">2</sup>](#inline2) Georg Klingenberg, "Die ROMTEXT-Datenbank," _Informatica e diritto_ 4 (1995): 223-232.
<sup id="f1">1</sup> Peter Riedlberger and Günther Rosenbaum, eds. (2020): _Amanuensis_ V5.0. München. URL: http://www.riedlberger.de/08amanuensis.html [Last accessed on 19 May 2020] [↩](#a1)
[<sup id="fn3">3</sup>](#inline3) Theodor Mommsen and Paul Krüger, _Corpus Iuris Civlis. Editio stereotypa quinta. Vol 1: Institutiones. Digesta._ Berlin: Weidmann, 1889.
<sup id="f2">2</sup> Georg Klingenberg, "Die ROMTEXT-Datenbank," _Informatica e diritto_ 4 (1995): 223-232. [↩](#a2)
[<sup id="fn4">4</sup>](#inline4) Georg Wissowa, Wilhelm Kroll, Karl Mittelhaus, Konrat Ziegler and Hans Gärtner, eds.,_Paulys Realencyclopädie der classischen Altertumswissenschaft: Neue Bearbeitung_. Stuttgart: Metzler, 1893-1980.
<sup id="f3">3</sup> Theodor Mommsen and Paul Krüger, _Corpus Iuris Civlis. Editio stereotypa quinta. Vol 1: Institutiones. Digesta._ Berlin: Weidmann, 1889. [↩](#a3)
[<sup id="fn5">5</sup>](#inline5) Adolf Berger, "Encyclopedic dictionary of Roman law," _Transactions of the American Philosophical Society_ 43 (1953): 333-809.
<sup id="f4">4</sup> Georg Wissowa, Wilhelm Kroll, Karl Mittelhaus, Konrat Ziegler and Hans Gärtner, eds.,_Paulys Realencyclopädie der classischen Altertumswissenschaft: Neue Bearbeitung_. Stuttgart: Metzler, 1893-1980. [↩](#a4)
[<sup id="fn6">6</sup>](#inline6) Bruce Frier, "Roman life expectancy: Ulpian's evidence," _Harvard Studies in Classical Philology_, 86 (1982): 213-251.
<sup id="f5">5</sup> Adolf Berger, "Encyclopedic dictionary of Roman law," _Transactions of the American Philosophical Society_ 43 (1953): 333-809. [↩](#a5)
[<sup id="fn7">7</sup>](#inline7) Walter Scheidel, "Roman age structure: Evidence and models," _The Journal of Roman Studies_ 91 (2001): 1-26.
<sup id="f6">6</sup> Bruce Frier, "Roman life expectancy: Ulpian's evidence," _Harvard Studies in Classical Philology_, 86 (1982): 213-251. [↩](#a6)
[<sup id="fn8">8</sup>](#inline8) Friedrich Bluhme, "Die Ordnung der Fragmente in den Pandectentiteln: Ein Beitrag der Entstehungsgeschichte der Pandecten," _Zeitschrift der Savigny-Stiftung für Rechtsgeschichte_ 4 (1820): 257-472.
<sup id="f7">7</sup> Walter Scheidel, "Roman age structure: Evidence and models," _The Journal of Roman Studies_ 91 (2001): 1-26. [↩](#a7)
[<sup id="fn9">9</sup>](#inline9) Tony Honoré, "Justinian's Digest: The distribution of authors and works to the three committees," _Roman Legal Tradition_ 3 (2006): 1-47.
<sup id="f8">8</sup> Friedrich Bluhme, "Die Ordnung der Fragmente in den Pandectentiteln: Ein Beitrag der Entstehungsgeschichte der Pandecten," _Zeitschrift der Savigny-Stiftung für Rechtsgeschichte_ 4 (1820): 257-472. [↩](#a8)
[Back to Table of contents](#0-table-of-contents)
\ No newline at end of file
<sup id="f9">9</sup> Tony Honoré, "Justinian's Digest: The distribution of authors and works to the three committees," _Roman Legal Tradition_ 3 (2006): 1-47. [↩](#a9)
\ No newline at end of file
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment