S3 What the research knows

The chapter describes what the app shows about a person from the research: the dialog What the research knows with the sections Above the person, Conflicts, Hypotheses and Searched, and the section of the same name in the research panel. Describes the Strom app 3.21.2 (and the research 1.25.2). Changes from a later version carry its number.

S3.1 What the research knows only reads what the research sent

For each person the research adds special blocks to the family tree for the app: conflicts, hypotheses, searched sources and the edge of the tree above the person. The app only shows them. Nothing in them changes in the app and the app does not send them back; they live in the research. The dialog's header carries the date of the research "as of …".

• Where from: from the bridge (the family tree the app loads from the running research, see S1) or from the file output/tree-strom.ged. Both come from the same export of the research.
• What the dialog does not show:
  • levels of certainty of facts (R3.1) and evidence (R3.8);
  • Awaiting action (R6);
  • directions and the queue as a whole (S4); the person's directions and tasks are only in the section Above the person (S3.3).
• Limits:
  • A family tree from another program and a copy without the research's blocks do not have the dialog.
  • Conflicts may be taken from a newer version of the research that the app has read but not loaded yet (S2). A conflict decided from the app disappears at once, even before the new version is loaded. The dialog can thus differ from the loaded data.
• Controls: app: nothing to set. Terminal: the file is created at every write of the research.
• Since: app 3.4.0 with research 1.6.0

S3.1.1 When the research sends the blocks

The research adds the blocks only to the family tree for the Strom app, and only when the app can show that part. It follows the version of the app it knows.

• Limits: an unknown version of the app and another copy of the app (its own address of the app) are taken as current.
• Since: research 1.6.0

S3.2 Where What the research knows opens

The dialog opens from the person menu, submenu Research → What the research knows. The item is there only when the research knows something about the person: at least one conflict, hypothesis, searched source, or the section Above the person. It carries open conflicts as a number, e.g. "2 conflicts".

• Other ways into the dialog (each opens it at its own place):
  • the mark conflict › at a field when editing a person (at the date and place of birth and death, the name, sex, title and name suffix): a single conflict that can be decided by a side opens the conflict card, otherwise the dialog;
  • the person menu, the block of signals "n conflicts · n hypotheses" with the link What the research knows ›;
  • the stub of the research edge above the card opens the section Above the person (S3.3);
  • at a link shown in the view only, What research knows about the link, and the line label "unproven" (S3.5.1);
  • the conflict card, More in What the research knows ›;
  • a row of the section in the research panel (S3.7).
• Limits:
  • Reading works everywhere: on a phone, in a locked family tree and in a read-only one.
  • Buttons that open the research are only on a computer (a device without a touch pointer), with Strom Research on this computer on, and only those the research announced (S1).
  • An island alone (a family outside the tree) does not add the item to the menu.
• Controls: app: person menu → Research → What the research knows.
• Since: app 3.4.0
• From app 3.22.0: at the top of the submenu Research are the directions the person is in.

S3.3 Above the person shows where the tree ends and what comes next

The section is at a person above whom the tree does not continue: the person has no parents, only one, or no record supports the parents. It says why the search stops here and what happens next.

• Why it ends: e.g. "Father not named in the entry", "The registers did not survive", "Known registers begin 1784", "A gap in the registers", "Searched, not found", "An archive remains", "Partly searched", "Not searched yet", "Birthplace unknown", "The parents are not documented by a record". A limit of the direction replaces it: "The direction's limit ends here", "The direction is paused", "The direction has ended", "Probably living, not researched" (R2.1.2).
• What next: "The agent is working on it right now", "Waiting for an answer", "In the queue as no. 3", "A task will be added with the next session", "Waiting outside the queue (paused direction)", "Strom has nothing more to suggest. A decision is needed.", "Nothing is planned". The app computes it live from what the research is doing right now.
• Timeline "Baptism 1780–1800": the years where a baptism is searched for, with the legend searched, not found / no registers / not searched and an estimate of the year of birth (▲, e.g. "estimate 1790 from the marriage 1815").
• Known birth registers with access: free online, online, login, reading room, on request, not preserved.
• Tasks: the position in the queue, or why it stands (paused direction, ended direction, family outside the tree, put off until …); finished ones under Tried tasks · n.
• Work: the number of searches, the number of the agent's sessions with the cost, "last …". In an archive there are neither sessions nor cost.
• Hypotheses: a possible link to another person, a family outside the tree ("family outside the tree, 4 people"), how many tasks are waiting, which tasks test the hypothesis.
• The link "2 open conflicts ↓" scrolls to the section Conflicts.
• Limits: "as of …" is in the section header only when the research is older than today.
• Controls: app: Settings → Tree view → Research edge (Off / To decide / All) controls only the stubs above the cards, not this section. The option is only for a family tree from the research. To decide is missing for a copy that has no queue. Terminal: strom edge.
• Since: app 3.6.0 with research 1.9.0; several families outside the tree from app 3.13.0 with research 1.16.0

S3.3.1 Actions at Above the person

• Limits: only for a person from the research, only where the research announced the link (S3.2). In an archive and in a research waiting for an agent there are none, because each leads to the agent.
• Controls: app: the buttons under the section.
• Since: app 3.6.0
• From app 3.22.0: Resume the direction resumes the direction right through the bridge when the research can do it, without the terminal.

S3.4 Conflicts

The section Conflicts shows the conflicts of the person and of the families where the person is a partner. Open ones come first, then decided ones with the row "decided: … (…)". The source can be opened in the source viewer. What a conflict is, where it is visible and how it is decided is described in R5.6. Deciding by a side from the app is described in R5.6.1.

• Limits: Decide in the research and Leave it to the agent are only for a person from the research and only where the research announced them. Leave it to the agent is missing in an archive and in a research waiting for an agent.
• Controls: see R5.6.
• Since: app 3.4.0 with research 1.6.0
• From app 3.22.0: a conflict that arose from an edit in the app carries the text "An edit made in the app differs from the research here; this is decided in the research." (until now always "The sources disagree here; this is decided in the research.").

S3.5 Hypotheses

The section Hypotheses shows the hypotheses that concern the person: the person is their subject, or some version names the person. Each hypothesis can be expanded. Under the title are the number and the state: open, decided for B, abandoned, the number of versions and a note. Open ones are expanded.

• Row of a version: the letter and the claim (a long one expands) and what the version does with the tree: "shown · + 2 people · Find", "+ 2 people", "The tree records this already", "Text only, cannot be shown.", "no link to people in the tree", for a decided one chosen, "Now linked for real", "No longer valid: …".
• Which hypotheses the research sends: open ones; decided and abandoned ones only those whose versions carry links, and to an app that decides hypotheses (S3.5.2) also those that can be decided in the app, without a link too (so that they can be changed and reopened). Withdrawn ones never.
• Who decided: a hypothesis the agent decided (R10.3.2) carries decided by the agent with the day and Reason (the text of the decision in the research's language; a long one expands).
• Limits: a hypothesis can be decided from the app by choosing a version that the research terminal confirms (S3.5.2); otherwise it is decided in the research (R10.3.1). Who decides, a person or the agent, is a choice of the research (R10.3.2).
• The offer The AI decides: with The user decides saved and 10 or more open hypotheses in the tree, the sentence "N open hypotheses wait for a person to decide; with "The AI decides" the agent decides them itself, each with its reason." stands above the hypotheses. The switch is confirmed in the research; the app does not turn the AI on (R10.3.2).
• Controls: app: the switch Show at a version (S3.5.1); Choose at a version and the other choices (S3.5.2); Decide in the research, at a decided one Change in the research, opens the hypothesis in the research on this computer; Switch to "The AI decides" opens the research in the terminal, Hide hides the offer for this research.
• Since: app 3.11.0 with research 1.14.0 (versions, state, Show); the list of hypotheses from app 3.4.0
• From app 3.25.0: decided by the agent with the reason (with research 1.29.0), Decide in the research, Change in the research and the offer The AI decides.
• From app 3.27.0: with research 1.31.0 a decision by choosing a version right on the card (S3.5.2).

S3.5.1 Show: linked in the view only

The switch Show draws a version of a hypothesis into the tree as "Linked in the view only". The family tree's data do not change. The versions of one hypothesis exclude each other; at most one can be on, or none.

• Limits:
  • the switch is only at an open hypothesis and only at a version that can be drawn;
  • it is drawn only in the views Family and Descendants (A6);
  • the choice belongs to the device and the family tree; it goes with the backup of everything, not with a copy of the family tree;
  • with the bridge only when the research sends the links of hypotheses.
• Controls: app: Show in the dialog; at a drawn link the menu What research knows about the link.
• Since: app 3.11.0 with research 1.14.0

S3.5.2 Deciding a hypothesis in the app

The card of a hypothesis in What the research knows lets the hypothesis be decided: each version has Choose. Each choice opens the research terminal, where it is confirmed (R10.3.3); until it is confirmed nothing changes in the app.

• Card: versions with For: and Against: and Sources (n) (the sources the version names); the agent's proposal ("proposed by the agent: B") with Accept proposal B, for abandoning Accept: no version holds; under the versions No version holds and Leave open. A version that links 50 or more people has a pill ("links 214 people"). At a version there can be what it does with the tree: at a version that links no one, "The tree does not change; only the decision is recorded." (the same sentence as while waiting and in Awaiting action; it does not show when changing from a version with a link, the link leaves the tree), at a version whose links the tree already has, "The tree stays as it is; the research only records the decision." and at a version where the old link remains, "The tree stays as it is: the old link remains, further work stands on it."
• A hypothesis without a link: a hypothesis whose versions connect no one to the tree (where a person came from, say) is decided the same way. The tree does not change; the research only records the decision.
• Waiting: "Waiting for confirmation in the research" and "To be confirmed in the research terminal (Enter = yes): decide H0001 for version B. Then the terminal optionally asks for a reason. Nothing changes here until confirmed." At a version that connects no one and takes no link of an earlier decision off the tree it adds "The tree does not change; only the decision is recorded." After 10 minutes "Not confirmed by the research yet": "Waiting for over 10 minutes. The terminal may have been closed; “Open again” asks once more." with Open again and Stop waiting. When the research meanwhile decided otherwise: "Already decided in the research: A".
• After the confirmation the app loads the new version of the research (the research wrote the links) and the tree refreshes; the message "Hypothesis H0001 decided: B", on the card "decided in the app". When the research's version has other changes too, the app asks (Load, or Later: "the tree stays as it is for now"); before loading it saves a backup. After a decision the app turns Show (S3.5.1) off at the other hypotheses of the same person; after choosing a version that connects no one they stay shown.
• A decided hypothesis: "Holds since {day}: B" and earlier decisions ("before: A, …"). Change shows the versions again with Choose (Cancel the change; the terminal asks for the reason of the change). Reopen says what changes in the tree ("The link of 2 people leaves the tree.", "Nothing changes in the tree."). Where reopening is not possible, the reason stands instead of the button ("Cannot be reopened: further work stands on the link the decision wrote (2 links). Change is possible.") with the link Decide in the research.
• Awaiting action: hypotheses to decide are in the group Hypotheses to decide (chip Decisions, S4.4): "H0022 · question", the agent's proposal with Accept proposal B and Leave open, or the versions with Choose; More › opens the card at the person. With a research that accepts proposals at once: a checkbox at a hypothesis with a proposal, Select all with a proposal, "n selected." (at a large link "Large link: H0001 → B links 214 people.") and Accept proposals (n), at most 50 at once ("At most 50 at once."). The terminal confirms once; the message says how many proposals were accepted. At a hypothesis that cannot be decided here: "Only the research decides this one." When no choice of a row changes the tree, "The tree does not change; only the decision is recorded." stands under it once; when only some versions keep the tree, it stands at each of them.
• Edge of the tree: the bubble "?" at an edge with a hypothesis also has Choose at the versions.
• Limits:
  • the choices are only with a research on this computer that can do them; on a phone, a tablet and in a browser elsewhere the card only reads ("Decided on the computer with the research."), a read-only copy too;
  • a version that merges people or makes siblings: "Merging people is decided in the research.";
  • with an older research the card stays as before, with Decide in the research (S3.5).
• Controls: What the research knows → Hypotheses: Choose, Accept proposal …, No version holds, Leave open, Change, Reopen; Awaiting action → Hypotheses to decide. Choices that open the terminal carry its mark (S4.5.1).
• Since: app 3.27.0 with research 1.31.0

S3.6 Searched

The section Searched is a table of searches the research wrote for the person: Record, Years, Result (found / nothing). It is sorted by the first year. It includes searches from tasks whose subject is the person.

• Limits: the research tells apart more results than the app shows. found is only a found record. Everything else, a partial search or one without a conclusion too, is nothing. What a search without a result is, is described in R3.6.
• Controls: app: reading only. Terminal: the agent writes the searches.
• Since: app 3.4.0 with research 1.6.0

S3.7 The section What the research knows in the research panel

The research panel has the section What the research knows with the summary "3 conflicts · 1 hypothesis". It has a row for each open conflict ("Marie Vlková · birth: 1790 × 1791") and then for each open hypothesis ("Marie Vlková · Hypothesis: Father from the Horák mill"). A click opens the person's dialog at the given conflict or hypothesis.

• Limits:
  • the panel is visible only when following live a research that has not ended and belongs to the open family tree (S4);
  • without open conflicts and hypotheses the section is not there.
• Controls: app: the research panel, section What the research knows.
• Since: app 3.5.0