Photograph and Scan Provenance Catalog
Updated
IntermediateWhat you'll learn
~50 min- Ask an AI tool, in plan mode, for a catalog page of your photographs and scans in a short, plain request, and answer its questions
- Read its plan for what matters to the research: where each file came from, each copy tied to its master (the untouched scan it was made from), and dates kept as ranges you state
- Keep a reading as the master shows it, with [?] (the sign for 'cannot be read'), when a brightened copy seems to show more
- State a photograph's date range yourself from dating clues, each with its bound and any condition it depends on
- Read two scans of one exposure (one frame taken by a camera) as one photograph, not two
The story, and what you will end up with
Great-uncle Walt, Sergeant Walter Olof Engstrom, served overseas in the war and did not come home alive. There is one photograph of him in the family album: a small photograph of him in uniform beside a barn. Nobody wrote a date on it. In the family papers there is also a letter his mother, Ruth, wrote to him on 12 June 1944: “I am sending the picture Dad took by the barn on your furlough.” It is tempting to say the letter dates the photograph. It might. It might also mean another picture taken by the same barn.
On the back of the print is a drugstore stamp, KETTLE FORD DRUG CO. and PRINTED 4, then a digit too faded to read. You scanned the front and the back on 20 January 2026. The next day you made a brightened, sharpened copy of the back to see the stamp better, and on that copy the faded digit looks like a 3. From there it is a short step to “printed in 1943”, and another to “taken in 1943”.
You also hold a photograph of the memorial plaque in India that carries Walt’s name, given to a county historical society in 2009 with no photographer recorded, and three scans of two aerial survey photographs of the family’s farm near Kettle Ford, taken in 1945, two of the scans made from the same frame. The next lesson compares the two aerial photographs.
A few words first. Provenance is where a file came from: who holds the original (the print itself, or the plaque), who made this file, how and when. Your master is either your own scan of the original or the file an archive sent you; every copy is made from it, and it stays untouched. An enhanced copy is a later file made from the master with settings such as brightness or sharpening. A scan is a later digital copy of an exposure, and one exposure can have several scans.
By the end of this lesson you will have a small catalog page on your own computer that shows each image with where it came from, ties each copy to its master with the settings that made it, and keeps your dating clues and the date range you state from them. You build it by asking your AI tool in plain English, and then you do the reading and the dating yourself.
Before you start
First, if your AI tool is still open, leave it: type /exit and press Enter (if you use Antigravity, press Ctrl+D with nothing typed instead), and wait until you see the $ or % prompt. The next line goes there, in the terminal, not in the AI tool. It makes a folder for this lesson and goes into it:
mkdir -p ~/archive-playbook/10-photo-catalog && cd ~/archive-playbook/10-photo-catalogStart your AI tool with the start line you kept from the setup lesson, the one with approval prompts off. Then ask it to set the folder up:
Set this folder up so we can undo any change you make, download https://learn.intellimetrics.net/starters/history/10/photo-files.zip and unpack it into a data folder, and save a checkpoint.Look for it saying three things: the folder is set up with Git (the program that saves snapshots, from setup), the download is unpacked into data/ (your notes in catalog.json, a text file of data, and seven images in images/), and a first snapshot, your checkpoint, is saved. If it does not mention one of them, ask: “Did you save a checkpoint with the files in it?” If the download does not work, download photo-files.zip in your browser, check where it went (the browser’s list of downloads shows the folder), and tell your AI tool, for example: “photo-files.zip is in my Downloads folder. Unpack that one file into a data folder here, and save a checkpoint.” In Windows PowerShell or a desktop app, “my Downloads folder” works as is; only say “my Windows Downloads folder” if you use Ubuntu (WSL) on Windows, which keeps its own Downloads folder apart from Windows.
Everything in the download is fictional, made up for this course. The images are drawings standing in for the scans, with an empty outline where Walt stands. Nothing in the case ties the aerial photographs to Walt’s loss; they are here for practice in reading images.
Open this box once, because it says what each code used further down stands for.
ℹWhat is in photo-files.zipclick to expand
Seven images in an images folder, and catalog.json, your notes on them. Each image has an id, and each note gives what the file is, where the original is, how, when and by whom the file was made, and its file state: Archive master (read-only) for a master, Enhanced copy (parameters logged) for a copy, which also names the file it was made from and the settings that made it.
| Id | What it is | Made |
|---|---|---|
TRAINING-PH-0031F | front of print PH-0031: Walt in uniform beside a barn | scanned 2026-01-20, master |
TRAINING-PH-0031B | back of the same print: the drugstore stamp, read in your notes as PRINTED 4[?] | scanned 2026-01-20, master |
TRAINING-PH-0031B-E01 | brightened, sharpened copy of the back | made 2026-01-21 from TRAINING-PH-0031B, enhanced copy |
TRAINING-PH-0032 | photograph of the memorial plaque at Nohorkhat airfield, India | donated 2009-05-11, photographer not recorded; copy received 2026-02-15, master |
TRAINING-AER-A-0412-S1 | scan 1 of aerial exposure A, frame 0412, taken 1945-02-04 | scanned 2026-02-02, master |
TRAINING-AER-A-0412-S2 | scan 2 of the same exposure; your note: a dust speck on this scan only | scanned 2026-02-09, master |
TRAINING-AER-B-0077-S1 | scan of aerial exposure B, frame 0077, taken 1945-04-18 | scanned 2026-02-09, master |
The notes also hold five dating clues, C-1 to C-5. Each clue says which photograph it dates, where it is seen, and the bound it gives: not before a date, not after a date, or none. Some carry a condition, the thing that must be true for the clue to count. R codes are records in the case, the invented family history this course works on: R-13 is Walt’s enlistment index entry, R-15 the letter, R-25 the plaque itself.
| Clue | Dates | What it is | Bound | Condition |
|---|---|---|---|---|
| C-1 | TRAINING-PH-0031F | he is in uniform; he enlisted 1942-01-15 (R-13) | not before 1942-01-15 | if the uniform is from the service he entered on 1942-01-15 |
| C-2 | TRAINING-PH-0031F | his mother’s letter R-15 of 1944-06-12 sends “the picture Dad took by the barn on your furlough” | not after 1944-06-12 | if this is that picture |
| C-3 | TRAINING-PH-0031F | the stamp on the back, read on the master as PRINTED 4[?] | none | |
| C-4 | TRAINING-PH-0032 | the plaque reads “JUNE 1945” | not before June 1945 | |
| C-5 | TRAINING-PH-0032 | the society’s note of the donation | not after 2009-05-11 |
No photograph has a date range yet; stating them is your work in this lesson.
Switch to plan mode
Your AI tool is already open. Switch to plan mode now: Shift+Tab until it says plan, or /plan (the keys for each tool). In plan mode it usually reads your file, asks its questions and shows you a plan before it builds anything; the order can vary.
The conversation
Each message below is an example. Say it your own way.
Say what you want
Say what the files are, where your notes are, and what you want:
I'm cataloguing the photographs and scans in Walt's case: my notes are data/catalog.json, the images are in data/images. Help me build a page that shows where each came from and helps me date them. Ask me what you need first.Your AI tool reads your notes, looks at the images, and comes back with questions. It may also tell you what it noticed, for example that the brightened copy shows a sharp 3 where the master shows only a blur. A remark like that from your AI tool is one more opinion about the images. Reading them is your work, and the next sections take it step by step.
Answer its questions
Answer each in a sentence. These are questions AI tools often ask, with one way to answer each. Yours may ask them in a different order or show a list of choices:
| If it asks | You might say |
|---|---|
| Who is the page for? | Just me, for my own research. |
| Should you add things on the page, or only look at your notes? | Let me add clues and notes and state each date range myself, saved to a new file. |
| How should dating work? Should it record competing interpretations? | I’ll state each range myself. Show the clues and their conditions beside it. Nothing more for now. |
| Should it point out gaps in your notes? | Yes, point out gaps, but never fill them in. |
| Should it point out differences between the images? | No. I’ll compare the images myself. |
| Which comparison matters most? | The master beside its enhanced copy. |
| Would you like a timeline view? | Not now. |
| Will you open it by double-clicking, or is a small local server fine? (Either the page opens straight from its file, or a small program on this computer serves the page at a local address.) | Either is fine. Open it for me when it is built. |
Turn down any offer to read the images for you or to work out a date: the reading and the dating are yours.
If it asks several questions at once, answer the ones that matter to your research in a sentence, and for the rest say that its suggestions are fine. If it asks something not listed here, answer it the same way, in a sentence.
Read the plan
Next it shows you a plan: what it will build and how it will check it. Read it for six things:
- Every file shows where it came from: who holds the original, and how, when and by whom this file was made.
- The copy is tied to its master, with all its settings, and each file keeps its file state, master or enhanced copy.
- A reading stays on the master. The stamp is read as the master shows it,
PRINTED 4[?], and what you notice on a copy is kept as a note about that copy, apart from the reading. Each clue records which file it was seen on. - You state each date range yourself, from the clues, and it stays with the clues it rests on and their conditions. The page never puts a single date on a photograph or works one out from an image.
- Two scans of one exposure show together, as one photograph.
- Your notes and images are read and left as they are. What you add is saved somewhere else.
A first plan often leaves one of these out, most often the two scans. Say so in a sentence, in your own words, for example:
Show the two scans of one exposure together, as one photograph scanned twice.When the plan has all six, approve it: if your AI tool offers a choice to go ahead, pick it; otherwise say “Yes, go ahead and build it.” In Codex, press Shift+Tab first to leave plan mode. In Copilot, saying it brings up a choice to go ahead; pick that. Let it build. When it has finished, ask it: “Did you install anything, and where?” Nothing, or something inside this lesson’s folder, is fine for these lessons. If it names anywhere else on your computer, ask it what that is for, and to remove it if you do not want it there. You can tell a place is inside this lesson’s folder because it starts with ~/archive-playbook/10-photo-catalog (your AI tool may write the ~ out as your home folder’s full name, such as /Users/yourname).
Look at what it built
Ask it to start the page:
Start the catalog page and open it in my browser.Your AI tool may open the page straight from its file, or start a small program on this computer that serves the page at a local address, one ending in a number, such as http://127.0.0.1:8000/ (127.0.0.1 is an address that means this computer); either is fine. If it gives you an address without opening it, copy the address into your browser’s address bar and press Enter. If it says the address is already in use, say: “Something else is using that address. Don’t stop it. Use a different address for my page.” Leave the program running while you work; when you are done, ask your AI tool to stop it. If your AI tool does not take a message after opening the page, wait a minute. If it still does not, close the terminal window, open a new one, type this lesson’s folder line again, start your tool, and say: “Start the page again so it keeps running while we talk.” The page and your saved work are files in the folder, so nothing is lost. Your page will be laid out in its own way.
Before you change anything, check two things: all seven images are on the page, and no photograph has a date range yet.
As you work, your additions are saved to a new file, not to catalog.json. The page may save as you go, or have a button such as Save notes; press it after each step. If saving downloads a file, find its name in the browser’s list of downloads and tell your AI tool, for example: “My saved notes, research-notes.json, are in my Downloads folder. Move that one file into the data folder here.”
Read the stamp and date the photographs yourself
Keep the catalog page open beside this lesson. Each step below is work you do in the page.
-
The back of the print and its copy. Find
TRAINING-PH-0031B, the master. The stamp runs off the left edge of the print, and afterPRINTED 4there is only a soft grey blur where the next digit should be. Your notes read itPRINTED 4[?]: the 4 can be read, the next digit cannot.Now find
TRAINING-PH-0031B-E01, the copy made from it the next day. Your page may show the two side by side. On it a crisp 3 sits right after the 4. Look at the list of what was done to make the copy: the changes made to it, each written down so the copy could be made again. You do not need to understand each setting, only that each one is recorded. Here they are: black point 18 and white point 230 push the darkest greys to black and the lightest to white, gamma 1.15 shifts the middle tones, and the unsharp mask (radius 1.5 px, amount 80 %) makes edges look sharper. None of these can put back a stroke the print does not hold. They can make a faint mark darker and harder, and the eye then reads a figure into it. A clean 3 where the master shows only a blur is more than these settings could make on their own; on a real copy, that would be a reason to ask whether a step went unlogged.So the reading stays on the master,
PRINTED 4[?], and what you see on the copy goes on the copy, as a note about the copy. Write your own note onTRAINING-PH-0031B-E01. One example: “The faded digit after the 4 looks like a 3 on this copy. Not a reading of the print; not used as a clue.” Any good note says it is about this copy, what the copy seems to show, and that the master does not show it. If your page has no place for a note on one file, tell your AI tool: “Give me a place for a note on each file.” -
The photograph’s range. Go to
TRAINING-PH-0031F, the front of the print. Its clues give two bounds and one non-bound. C-1, the uniform, says not before the day he enlisted, if the uniform is from that service. C-2, the letter, says not after the day his mother sent “the picture Dad took by the barn”, if this is that picture. C-3, the stamp, gives no bound, because the digit that would give one cannot be read. State the range those two bounds give on the page, say that it rests on C-1 and C-2, and keep both conditions with it, for example: “1942-01-15 to 1944-06-12, if the uniform is from the service he entered on 1942-01-15 (C-1) and if this is the picture letter R-15 sends (C-2).” Do not pick a year in the middle, and do not take the letter’s date as the day the picture was taken. If this print is not the picture the letter means, C-2 falls away and so does the latest bound. If your page has no place to say which clues a range rests on, tell your AI tool: “Let me say which clues each range rests on.” -
The plaque. Go to
TRAINING-PH-0032. Read C-4 and C-5 and state its range yourself, with the clues it rests on. The plaque’s own words say when it was put up; they say nothing about when someone photographed it. -
Two scans, one photograph. Find the two scans of exposure
TRAINING-AER-A-0412. They share an exposure id and an exposure date, 1945-02-04, and differ only in when they were scanned (2026-02-02 and 2026-02-09) and in one small dark dot on S2, which your notes call a dust speck on that scan only. Together they are one photograph: anything both show was seen once, and a mark on one scan is a fact about that scan.TRAINING-AER-B-0077-S1is a different exposure, taken on 1945-04-18.
Check it for these
TRAINING-PH-0031B-E01is marked as an enhanced copy made on 2026-01-21 fromTRAINING-PH-0031B, with all five settings: black point 18, white point 230, gamma 1.15, unsharp mask radius 1.5 px and amount 80 %.TRAINING-PH-0031Bis marked as the master.- On
TRAINING-PH-0031Bthe stamp still readsKETTLE FORD DRUG CO. / PRINTED 4[?], and your note about the 3 sits onTRAINING-PH-0031B-E01only. - C-3, the stamp, gives no bound.
- The range for
TRAINING-PH-0031Freads 1942-01-15 to 1944-06-12, rests on C-1 and C-2, and has both conditions in view. No single date appears for that photograph anywhere on the page. - The range for
TRAINING-PH-0032reads June 1945 to 2009-05-11 and rests on C-4 and C-5. - The two scans of exposure
TRAINING-AER-A-0412(1945-02-04) are shown together as one photograph scanned twice, the dust speck noted on S2 only.TRAINING-AER-B-0077-S1stands apart. - After you reload the page, your note and both ranges are still there. Ask “Show me what my saved notes say about the range for TRAINING-PH-0031F, exactly as stored.” The answer holds both dates and names C-1 and C-2.
- When you ask “Have my notes and images changed since the checkpoint?”, it compares them with the checkpoint and says no. It may mention the new file that holds your work; that is expected.
The page may show more than that, such as a list of gaps in your notes (no photographer recorded, a clue with no bound). Those are fine. If a line on the list is not true, tell your AI tool in a sentence what you see and what you expected, for example: “The list says C-1 has no bound, but my notes give it one. Take C-1 off the list.”
Notice what the page does with a reading from the copy
Before you read on: if someone wanted to date the photograph to 1943, which file would they point to?
The copy. Try it the way a hasty reader would. Add a clue to TRAINING-PH-0031F that says what it is, stamp reads PRINTED 43; the file it is seen on, TRAINING-PH-0031B-E01; where on that file, back, stamp; its bound, not after; its date, 1943; and why, the copy shows what looks like a 3. If your page has no way to add a clue, tell your AI tool: “Let me add a dating clue to a photograph on the page.” Save the clue, and look at it on the page.
What you should see is a warning on the clue that it was seen on an enhanced copy, naming TRAINING-PH-0031B as the master to read instead. If the page took it like any other clue, with no warning, it has just let a brightened copy give the photograph a date that nothing on the master supports, and the next range you state could rest on it without a word. Only if that is what your page did, tell your AI tool, in your own words:
The page took my clue from the enhanced copy like any other. When a clue is seen on an enhanced copy, warn me on the page and name the master to read instead.If you sent it, reload the page and look for that warning on the clue. Then read the master, as the warning says, and remove the clue from the page; if the page offers no way to remove it, tell your AI tool: “Let me remove a clue I added.” The stamp is already in your notes as C-3, read from the master, with no bound.
Enhancement is not recovered detail. A clue gives a range, not a date.
What you can say at this point, in the story’s late February 2026, once the plaque photograph has arrived (it came on 15 February): TRAINING-PH-0031F was taken within the range you stated, if the uniform is from his 1942 service and if it is the picture his mother sent; the stamp cannot narrow that; the plaque was photographed within its own range; and the two farm scans are one photograph, taken on 1945-02-04.
One real run
Here is part of what one AI tool answered when asked to show the saved range for TRAINING-PH-0031F exactly as stored, built with Claude Code on 10 November 2026. Yours will be stored in its own way; check it against the list above, not against this one.
"TRAINING-PH-0031F": { "range": "1942-01-15 to 1944-06-12, if the uniform is from the service he entered on 1942-01-15 (C-1) and if this is the picture letter R-15 sends (C-2)", "rests_on": [ "C-1", "C-2" ], ...}Fictional training example.
How real archives differ
Real archives and real copies work like this:
- In the evidence-analysis model taught by Elizabeth Shown Mills, “the concept of “original record” also extends to high-quality images of those originals”, and derivative records are “materials that offer alternate versions of the original”; “The best derivatives will preserve all the essential details of the original. Still, errors are frequent.” (Evidence Explained, QuickLesson 17). Your master scan stands in for the print in that sense; an enhanced copy is a derivative of it.
- At least one large archive finds aerial photographs by the exposure, not by the file you hold. For one large series, the US National Archives says: “To locate the photographs, you need a citation with the spot number and exposure number” (National Archives, RG 373 aerial photography). Keep the exposure’s own reference on every scan you make or receive.
- When you make a copy of your own, record the program and its version as well as the settings; without them, nobody can make the copy again exactly.
Keep going
Small changes do not need plan mode. Say each in a sentence:
- Your AI tool can work out each file’s fingerprint itself, as the register in lesson 02 did: “Show each file’s fingerprint, the code that shows a file is unchanged. Work it out from the file itself.”
- “Add an open question to TRAINING-PH-0031F: does the original negative envelope carry a processing date?”
- “When a copy is open, let me see it beside its master at the same size.”
- “Save a checkpoint.” Your AI tool saves a snapshot you can return to (people who use Git call this a commit).
A real image to practise on. Before your own family photographs, you can add one image from a source that states its rights. Read the rights note for each item yourself; not everything an archive holds is free to reuse. Add it as a new file with the source’s name, the item’s own reference and the date you downloaded it as its provenance. What each source says about reuse, as of 10 November 2026:
- The US National Archives Catalog (catalog.archives.gov): “The vast majority of the digital images in the National Archives Catalog are in the public domain. Therefore, no written permission is required to use them. We would appreciate your crediting the National Archives and Records Administration as the original source.” Check each record’s “Use Restriction(s)” field (National Archives FAQs).
- The Library of Congress, Free to Use and Reuse (loc.gov/free-to-use): “More than 100 sets of rights-free images are ready for you to explore and add to your own projects.” For its Prints and Photographs collections it adds that “it is the researcher’s obligation to determine and satisfy copyright or other use restrictions when publishing or otherwise distributing materials found in the Library’s collections” (rights research guide).
- USGS EarthExplorer aerial single frames (earthexplorer.usgs.gov): medium-resolution files download “at no cost”, and “USGS-authored or produced data and information are considered to be in the U.S. Public Domain”; USGS asks “that proper credit be given” (USGS copyrights and credits). That covers USGS-made material; the collection itself is imagery “acquired by Federal organizations” (USGS aerial single frames), so read each frame’s own note.
- Riksarkivet’s Digital Research Room (sok.riksarkivet.se/en/digitala-forskarsalen), the Swedish National Archives: its terms say, in Swedish: “Riksarkivets digitaliserade arkivhandlingar är till den övervägande majoriteten helt fria för användning och återanvändning” (the overwhelming majority of its digitized records are entirely free to use and reuse), and “Endast en mindre del av de fotografier och konstnärliga verk som är tillgängliga i den digitala forskarsalen är skyddade enligt lagen om upphovsrätt” (only a small part of the photographs and artworks there are protected by copyright) (terms of use). Material between 70 and 110 years old needs a free account, and material older than 110 years needs none (Riksarkivet FAQ).
- Wikimedia Commons (Commons licensing) accepts media “that are explicitly freely licensed, or” “that are in the public domain in at least the United States and in the source country of the work.” Read each file’s own licence line.
Your own photographs. When you have your own photographs and scans to catalog, use the finished catalog page. It runs on your real records by itself, with your AI tool closed. Do these steps in order; the first two happen now, while this folder still holds only practice data:
- Go through the data check, the questions in setup about what the material is, who decides how it is used, and which AI tool would see it. Go on only if it allows this use.
- While this folder still holds only the practice files, ask your AI tool: “How do I open this catalog page myself on notes and images in another folder, and save what I add there too?”
- Write down what it tells you.
- Ask your AI tool to stop the page’s program, then leave the tool: type
/exitand press Enter (if you use Antigravity, press Ctrl+D with nothing typed instead). - Keep your real files in a folder of their own, outside this course folder, and do what you wrote down. What you add is saved beside your real files, not in the course folder.
Try another case
Before the quiz, write two or three sentences for yourself. An aunt sends you a scan of a school photograph with “1931” pencilled on the back in a hand nobody recognises, and a cousin’s brightened copy of the front on which a banner seems to read “CLASS OF 32”. What would you record for each file, and what range, if any, could you state?
A good answer records the scan as the master and the cousin’s file as a copy made from it, keeps “CLASS OF 32” as a note about the copy until the master shows it, treats the pencilled year as a clue with a condition (who wrote it, and when), and states a range only from clues it names.
Key takeaways
- Ask briefly, and let your AI tool ask back. Say what the files are, where your notes are, and what you want; its questions fill in the rest.
- Every file has a provenance, and a copy points back to its master, with the settings that made it.
- Read on the master, note on the copy: what an enhanced copy seems to show is a note about that copy, and
[?]stays where the master cannot be read. - Clues give bounds, and you state the range, with the clues it rests on and their conditions in view. A range is an honest answer when that is all the evidence gives.
- Count exposures, not files: two scans of one frame are one photograph.
A cousin runs a scan of an old wedding photograph through an online 'restore' app and sends you the result. On the restored version, a wall calendar behind the couple clearly reads 1937. On your master scan, the calendar is a grey blur. What goes in your catalog?
What’s next
The two scans of aerial exposure A are one photograph, and one of them carries a speck the other does not. Next you put them to work in the Then-and-Now Comparer and Feature Register, which sets two aerial photographs of the same ground side by side and keeps a register of what each one shows, hides or does not cover.