SecToPat-PhilTransExtractions/about.html at main · DigitalHistory-Lund/SecToPat-PhilTransExtractions · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>About — Extractions Viewer</title>
<style>
* { box-sizing: border-box; margin: 0; padding: 0; }
body {
  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
  font-size: 0.9rem; line-height: 1.6; color: #222; background: #f5f5f5;
}
header {
  background: #1e2a3a; color: #fff;
  padding: 0.6rem 1rem; display: flex; align-items: center; gap: 1rem;
  box-shadow: 0 2px 4px rgba(0,0,0,.3);
}
header h1 { font-size: 1rem; font-weight: 600; }
header a { color: #aac; font-size: 0.8rem; text-decoration: none; margin-left: auto; }
header a:hover { color: #fff; }
main { max-width: 700px; margin: 2rem auto; padding: 0 1.5rem 3rem; }
h2 {
  font-size: 0.95rem; font-weight: 700; color: #1e2a3a;
  margin: 1.75rem 0 0.5rem; border-bottom: 2px solid #ddd; padding-bottom: 0.25rem;
}
p { margin-bottom: 0.75rem; }
a { color: #5b9bd5; }
code { background: #eee; padding: 0.1em 0.3em; border-radius: 3px; font-size: 0.85em; }
</style>
</head>
<body>
<header>
  <h1>Extractions Viewer</h1>
  <a href="index.html">← Back</a>
</header>
<main>
  <h2>About</h2>
  <p>
    The <a href="https://royalsocietypublishing.org/rstl"><em>Philosophical Transactions of the Royal
    Society</em></a> is the longest-running scientific journal in the world, with its first volume
    appearing in 1665. As part of the <a href="https://secretstopatents.org/"><em>Secrets to
    Patent</em></a> project, we use local LLMs to extract structured information from OCR'd article
    text: whether each article describes an experiment, what locations are mentioned, and who
    participated.
  </p>
  <p>
    This viewer lets you browse those extractions article by article, filter by classification
    (experiment: yes / no / unsure), and inspect extracted locations and participants alongside the
    original article text.
  </p>

  <h2>Dashboard</h2>
  <p>
    The collapsible band at the top of the page is a small dashboard for exploring the corpus as a
    whole. The <strong>timeline</strong> shows three series per year: number of articles, average
    number of detected locations per article, and average number of detected participants per
    article. The two histograms on the right show the per-article distribution of detected
    locations and detected participants &mdash; both visibly power-law, with most articles in the
    low bins and a long tail.
  </p>
  <p>
    Every chart is <strong>brushable</strong>: click and drag along the x-axis to select a range.
    All brushes AND together with the experiment dropdown and immediately re-filter the article
    list and the other charts. The <em>reset filters</em> link clears every active brush at once,
    and <code>− Charts</code> hides the dashboard for full-height article view.
  </p>

  <h2>URL routing</h2>
  <p>
    The full filter state is encoded in the URL fragment, so any view is bookmarkable and
    shareable. Open <code>#article=1290791</code> to jump straight to a single article, or combine
    keys to share a filtered slice:
    <code>#article=1290791&amp;years=1700-1750&amp;locs=2-&amp;parts=1-3&amp;exp=yes</code>.
    Open-ended ranges (<code>locs=2-</code>, <code>years=-1750</code>) are accepted.
  </p>

  <h2>Prompt</h2>
  <p>Each article was passed to the LLM with the following prompt. Structured output was enforced via JSON schema using the Ollama API.</p>
  <pre style="background:#f0f0f0;padding:0.75rem 1rem;border-radius:4px;font-size:0.8rem;line-height:1.55;white-space:pre-wrap;margin-bottom:0.75rem">You are analysing an article from the Philosophical Transactions of the Royal Society (17th–19th century). Answer three questions:

1. is_experiment: Does this article describe one or more experiments or systematic observations? Answer "yes", "no", or "unsure".

2. locations: List every spatial location where an experiment or observation took place. For each, provide:
   - place: the immediate setting at room or building scale (e.g. "private study", "ship's cabin", "kitchen"); null if not mentioned
   - geography: named place at city, region, country, estate, or vessel scale (e.g. "London", "aboard HMS Endeavour"); null if not mentioned
   - detail: specific spatial detail within the place (e.g. "by the south window", "in a dark corner"); null if not mentioned
Do not include apparatus or containers as locations. Return an empty list if no spatial setting is mentioned.

3. participants: List every person named in the article who conducted, observed, or contributed to the experiment or observation. For each, provide:
   - name: the person's name as it appears in the text
   - role: their role if stated (e.g. "experimenter", "observer", "subject", "correspondent", "author"); null if not clear
Return an empty list if no individuals are named.</pre>

  <h2>Repository</h2>
  <p>
    Source code and data:
    <a href="https://github.com/DigitalHistory-Lund/SecToPat-PhilTransExtractions">github.com/DigitalHistory-Lund/SecToPat-PhilTransExtractions</a>
  </p>

  <h2>Team</h2>
  <p>
    Natacha Klein Käfer is the principal investigator of the
    <a href="https://secretstopatents.org/"><em>Secrets to Patent</em></a> project.
    The extraction pipeline and viewer were assembled by Mathias Johansson using Python, Ollama,
    and Claude.
  </p>

  <h2>Citation</h2>
  <p>
    If you use this site or its data in your work, please cite the repository.
    Machine-readable metadata is in <a href="CITATION.cff"><code>CITATION.cff</code></a>.
  </p>

  <h2>License</h2>
  <p>
    <a href="https://creativecommons.org/licenses/by-nc/4.0/">
      <img src="https://licensebuttons.net/l/by-nc/4.0/88x31.png" alt="CC BY-NC 4.0" style="vertical-align:middle;margin-right:0.5rem">
    </a>
    This work is licensed under a
    <a href="https://creativecommons.org/licenses/by-nc/4.0/">Creative Commons
    Attribution-NonCommercial 4.0 International License</a> (CC BY-NC 4.0).
    See <a href="LICENSE"><code>LICENSE</code></a>.
  </p>

  <h2>Contact</h2>
  <p>
    For questions or feedback, contact Mathias Johansson at
    <a href="mailto:MathiasJohansson@kultur.lu.se">MathiasJohansson@kultur.lu.se</a>,
    or open an <a href="https://github.com/DigitalHistory-Lund/SecToPat-PhilTransExtractions/issues">issue</a>.
  </p>
</main>
</body>
</html>