A6 Views and the choice of people

How the Strom app chooses which people to show and how each view shows them. Describes the app 3.21.2; changes from a later version carry its number.

A view is a different reading of the same choice of people. The choice is set by the central person (the one clicked) and the depth Ancestors and Descendants. Family, Descendants, Timeline and Map show the same surroundings of the central person. The Fan counts ancestors and descendants on its own by the number of generations (A6.4). The Table shows the whole tree (A6.7).

Views: Family, Descendants, Timeline, Fan, Map, Table.

A6.1 The surroundings of the central person in the Family view

The Family view shows the central person within their family, not the whole tree.

  • The choice includes:
    1. the central person and all their partners;
    2. their descendants down to the depth Descendants, with partners;
    3. direct ancestors through both parents up to the depth Ancestors;
    4. siblings, half-siblings too (their other parent is not added), with partners and descendants down to the depth Descendants;
    5. aunts and uncles (the parents' siblings) with partners;
    6. cousins, that is the children of aunts and uncles recorded in their union, with descendants down to the depth Descendants.
  • Limits: the ancestors of the central person's partner are never added. Whoever is not in the surroundings stays in the tree; the view just does not show them. A new central person shows them.
  • Depth: after a new central person is chosen, Ancestors and Descendants are set to the greatest depth the tree has for that person. The menu offers 1 up to that greatest depth. The partner's children from another union add one generation down.
  • Controls: a click on a person's card; the options Ancestors and Descendants in the view bar.
  • Since: app 1.0.0

A6.1.1 Default person and view

What a tree opens with is set by the tree setting Default person and view.

OptionChoices
personLast focused · Specific person: (chosen)
viewFamily · Last used (on this device)
  • Limits: without the setting the tree opens on the tree's first person. Reloading the page keeps the tree, the view and the central person.
  • Controls: tree management, at the tree Default person and view.
  • Since: default person app 1.0.0; the choice of view and reloading the page app 3.21.0

A6.1.2 Spacing: Normal and Dense

The option Spacing sets the gaps between cards and between generations in the Family and Descendants views. Dense makes them smaller, so more people fit on the screen. Normal is the default, on a phone too.

GapNormalDense
between cards side by side31 px20 px
between generations80 px48 px
between partners18 px14 px
  • After a switch the tree is redrawn at once and stays on the same person: on the central person's card when it is wholly visible, otherwise on the card nearest the centre. The tree behaves the same after a change of Card detail.
  • Marriage order: in Dense, instead of the pill “1. ∞ 1866” there is only a short “∞ 1” at the edge of the card, that is the order of this marriage. The whole order is shown by a bubble (with the mouse, the keyboard and a tap). A pill that has no room at the card is not drawn.
  • Export: the poster export has its own option Spacing (after the paper format and the orientation). When it differs from the screen, the image, the poster and the PDF in sheets are laid out again with the chosen spacing, with the same choice of people and the same cards; the screen does not change. Under each option is the number of sheets (“26 A4 sheets”) when the numbers differ. Printing (Ctrl+P) takes the spacing of the screen.
  • Limits: the option belongs to the device and is not saved with the tree. Timeline, Fan, Map and Table have their own layout and the option does not concern them; the poster export from the Fan and the Timeline has no row Spacing.
  • Controls: Settings → Person card → Spacing (after Card detail): Normal · Dense. On a small screen without the compact card, under the option stands “On a small screen, the Compact card helps too.” Export: Export poster → Spacing.
  • Since: app 3.27.0

A6.2 The Descendants view

The Descendants view shows only the central person and their descendants down to the depth Descendants: without ancestors, aunts, uncles and cousins.

  • Blood only (default): the central person's blood descendants.
  • Whole families: also the partners' other unions and their stepchildren, dimmed.
  • Controls: a switch in the view bar; the default is kept by the setting Descendants view.
  • Since: the view app 1.4.0; Whole families app 1.9.2

A6.3 Timeline

The Timeline shows the people of the view as life bars on an axis of years.

  • Only a person with a year of birth gets a row. The view counts the others and writes "N people without a birth year not shown". Placeholder persons (an empty place for an unknown parent) are left out.
  • The order of rows: year of birth, then the name without titles.
  • The bar of a living person reaches today. A deceased person without a date of death has a bar up to the last known event and an open end.
  • The year of a marriage is taken from the start date of the union. The axis is rounded to decades.
  • Under the axis of years runs a row of history for the central person (events of the time and the places of their life, symbols of kinds). Without the research or without such events there is no row.
  • Since: timeline app 1.5.0; the row of history app 3.19.0

A6.4 Fan

The Fan shows the central person's ancestors in circular segments, generation by generation.

  • Shape: Half circle · Full circle · Two-way (ancestors and descendants).
  • Generations of ancestors 3–10, default 5. In the shape Two-way, Descendants 1–5, default 3.
  • Numbering of ancestors: 1 is the central person, the father of person n has the number 2n, the mother 2n+1. The father's line is on the left. The numbers on the segments are turned on by the setting Fan chart "Show Kekulé (ancestor) numbers" (off by default).
  • The parents are the person's first two recorded parents. A relationship that is not biological (adoption, step, foster) is marked at the segment.
  • An ancestor who appears in the fan a second time is drawn again but not expanded further; legend ↻ repeats (pedigree collapse). The option Show first occurrence jumps to their first place.
  • Descendants (shape Two-way): unions in the order of marriages (date of marriage, then the order in the data), children by birth. An unknown partner gathers the children without a second parent. A union without children is shown only for the central person.
  • Colours: Gender · Lines (the four lines of the grandparents: father's father, father's mother, mother's father, mother's mother) · Family lines (A4).
  • Original person returns the fan to the person it started from.
  • Since: fan app 1.8.0; the new fan with shapes, colours and pedigree collapse app 3.20.0
  • From app 3.27.0: a union without a date of marriage is ordered by the latest date the marriage can have been: the earlier of the end of the union (a divorce) and the birth of the union's first child. A marriage “before 1982” comes before a marriage in 1982. A union without these dates comes after the others. The partners next to a person and the marriage-order marks (“1. ∞”) on the cards follow the same order.

A6.5 Map

The Map shows the places of people's events.

  • Scope: This view (default, the people of the view) · Whole tree.
  • Kinds: Births · Deaths · Marriages · Other events. All are on by default; the choice is remembered on the device.
    • A baptism counts as a birth, a burial and a cremation as a death.
    • An engagement, banns, a marriage licence and a marriage contract count as a marriage. The couple's other events are Other events.
  • The place of a marriage is shown when at least one of the partners is in the view.
  • A place is written in its most frequent spelling. A town is one point, house numbers included; a place with its own exact coordinates stays a separate point.
  • Since: map app 1.10.0; kinds of events and town points app 3.21.0

A6.5.1 Where the map gets a place's location

In a tree of its own (without the research) the app looks up the location of places itself, in the OpenStreetMap service (Nominatim). It sends only the name of the place as it is written in the tree, and only with consent. In a tree from the research, places are identified by the research (R4).

  • Limits:
    • before the first lookup the app asks (Look up coordinates online?). Only place names leave the app, no names of people, dates or relations. At most one request about every second;
    • the coordinates are saved into the tree: each place is looked up once, and the map then works offline too;
    • the automatic lookup takes the service's first result for the written name. Up to app 3.23.0 it did not tell apart towns of the same name: a place could thus land in a town of the same name elsewhere. A location that does not fit the tree is marked Check (R4.4.1);
    • only a place with a house number that the service did not find is looked up by its town. Of the towns of that name, the one nearest the tree's other places is chosen (“Several towns have this name; the one nearest the tree’s other places was chosen.”); the place shows Located by the town of …;
    • from app 3.24.0 the nearest town is chosen for every place: when two or more towns are named exactly like the written place (regardless of letter case and diacritics), the one nearest the centre of the tree is taken, not the first result. The centre is the median of the locations set by hand or confirmed with Keep, when there are at least 3; otherwise the median of all the tree's locations and of the places the lookup found without doubt. A place with a further detail (“Lhota u Kolína”, “Lhota 16”), a single town or a tree without locations gets the first result as before. It is still one request per place;
    • the place check says how many towns of that name the map found (“The map found 3 towns with this name and took the one nearest the tree’s other places.”); from app 3.24.0, formerly always “two”;
    • a location already in the tree is not moved: the lookup looks up only places without a location. Not even a merge with another tree or a GEDCOM file overwrites a location set by hand or confirmed with Keep; it only adds missing ones. A wrong older location can be moved only by hand;
    • what is not found stays without a location. The app guesses nothing: “check the spelling, or add the country”.
  • Controls: app: Settings → Look up places online; in the places window Wrong spot? Fix this place, Search for this place under another name (only the location is attached, the entry in the tree does not change), Use for the other house numbers in … too, Clean orphaned places (n).
  • Why: looking up places is the only part of the app that sends anything out; therefore only with consent, only names, and each place once (a comment in the code). The limit of one request per second is a condition of the service.
  • Since: app 1.10.0; Wrong spot? Fix this place 1.10.1; Clean orphaned places 2.1.0; the location by the town 3.21.0; the nearest town of the same name for every place and the number of towns in the check 3.24.0

A6.5.2 Looking up places off the map in the research

For a tree with a research, the map's status bar offers the places without a location for looking up in the research (R4.4). The button opens the Places window with a preview; places go to the research's queue only after Queue.

  • Limits:
    • before the map's lookup the bar has In the research beside the map's own lookup. After the lookup, when the map did not find some places, the bar shows "N places on the map · K not found by the map" and Look up in the research (K), possibly "N to confirm ›" (opens Waiting in the research panel);
    • the button is there only for a tree with a research and only when something can be looked up: a place without a location or not identified that is not in the queue yet, not being worked on and not waiting for an answer;
    • the Places window shows the preview "Look up N places not on the map in the research". Nothing is queued before Queue N places, and no place is queued twice;
    • when the research runs on another computer, or on a phone, the app says instead of the window where the lookup works: "Look up and check work in the research on the computer where it runs. Place states come here with the tree.", on a phone "Look up and check work on the computer with the research. Questions about places can be answered here too, in Waiting." An older research: "This version of the research does not look up places yet.";
    • while following the research on the map (S4.1.3) the line "… – no position on the map" offers Look up in the research: it queues that one place at once, without a preview; the queuing can be undone in the notice.
  • Controls: app: the map → the status bar → In the research, after the map's lookup Look up in the research (K) → the Places window → Queue N places.
  • Since: app 3.25.0

A6.6 A family line in the view

A view can highlight one family line (A4): its members fully, wives and husbands who married into it more faintly, the others subdued. This holds in the views Family, Descendants and Fan.

  • The choice is remembered for each tree on the device. A family line that is no longer in the tree is cancelled silently.
  • When no member of the family line is drawn in the view:
    • Family and Fan move the central person to the nearest member of the family line (through parents, children and partners; on a tie to the older one), and when the person is not connected to one, to the founder of the family line;
    • Descendants always moves the central person to the founder;
    • the bar offers ↩ Back.
  • Limits: restoring the choice from memory does not move the central person.
  • Controls: Family lines in the bar; in the person's menu Only the … line (the person's own family line by birth comes first); the end through × on the label or Show the whole tree.
  • Since: app 3.21.0

A6.7 Table

The Table shows the whole tree in rows: each person, each union, each event or each source, with the facts in columns. It serves for finding gaps, contradictions and findings of the check across the tree. It does not depend on the depth Ancestors and Descendants. The Table view is based on a table by Ondřej Chrpa.

  • Rows: the switch Rows: People · Unions · Events · Sources. Each row type has its own columns, filter and sort.
    • People: one row per person of the tree; placeholder persons (an empty place for an unknown parent) are left out.
    • Unions: one row per union that has at least one real partner. Partner 1 is the one of the couple who is a blood relative of the home person; otherwise the union's first partner.
    • Events: one row per event of the tree (A6.7.10).
    • Sources: one row per source of the tree (A6.7.11).
  • The home person is the central person of the tree (A6.1). From them the column Relationship to home person and the chip Blood relatives are counted: the home person's ancestors (the home person too) and all their descendants. Partners who came into the family by marriage are not among them.
  • Generation 1 is the oldest generation of the tree; a partner has the generation of their partner.
  • Living (a column, the value “living”) is counted as for the privacy of living people (A7.1).
  • Above the table are the count (“42 of 120 people”) and the sort (“Sort: …”). The field Search person... in the bar selects the person's row in the table and scrolls to it; the central person does not change.
  • The central person between views: after a switch to the Table the central person's row is the active row and the table scrolls to it (a selected row that concerns them stays; when the filter or the search leaves the person out, there is no active row). After a switch from the Table the central person is the person of the active row: for a union the partner who already is the central person, otherwise Partner 1; for an event the central person when they are among its people, otherwise the first person; a source row does not change the central person.
  • Limits:
    • highlighting a family line (A6.6) is not used in the table; a family line can be chosen with the chip Family line (A6.7.6);
    • the research's columns, chips and views are only in a tree from the research (A6.7.14);
    • a read-only tree (a followed tree, a tree saved by a newer version of the app, a locked tree) the table only shows: “Read only: edits and “Not an error” are not available here.” Browsing, filter, sort and CSV and XLSX export work; a view cannot be saved, renamed or deleted;
    • the arrows ↩ ↪ in the bottom left corner (the previous and the next central person) and Alt+← / Alt+→ are not in the Table: the table neither shows the central person nor changes it while working.
  • Controls: Table in the view bar (after Map); in a narrow window and on a phone More → View → Table. The view is remembered like the others (A6.1.1).
  • Since: app 3.27.0

A6.7.1 Unions in the People table

A person with two or more unions has a row of their own in the People table and under it a sub-row for each union (“Union 2 of 3”). The person's row has a count in the column Partner (“3 unions”) and the other union columns empty.

  • Unions follow the order of marriages as in the tree (A6.4): Union 1 is the one with the mark “1. ∞” on the card. A union without a wedding date is placed by the latest the wedding can have been (the earlier of a divorce and the birth of the first child); a union without these dates comes after the others. On a tie, the order of the person's unions in the data decides. An empty stand-in family (“?”) goes last in the order of entry.
  • Collapsed: the person's row shows the first union and the number of the others. The default is expanded; the built-in view Gaps has the unions collapsed.
  • A filter in a union column is judged for each union separately. The person stays when at least one union matches; the others are hidden under the row “2 unions outside the filter · show”. Those shown are dimmed until the next change of the filter.
  • Sorting by a union column takes the first union that matches the filter.
  • A person with one union has its facts directly in their own row.
  • A union sub-row carries only the findings of its union. The person's findings (such as the mother's age at the birth) and the strips of collapsed groups stay in the person's row.
  • Controls: Expand unions / Collapse unions (on a phone in the menu ⋯); the keys → and ← in the column Full name, * for all people; the row menu. The state is saved with the view (A6.7.7).

A6.7.2 Columns

The columns are in groups. Which are visible and in what order is part of the view (A6.7.7).

RowsGroups of columns
PeoplePerson · Birth and baptism · Parents · Unions · Divorce · Death and burial · Events · Sources · Reliability and research · Checks
UnionsCouple · Marriage · Divorce · Children and sources
  • Full name (for unions Partner 1) is pinned on the left and sorts by surname, then by given name. It is made of the parts of the name, so there is a separate column First name (hidden by default) that can be edited in the cell (A6.7.15). Surname is the married surname, otherwise the birth surname; Birth surname is the recorded surname.
  • Research ID shows only the person's number from the research (P…). Ref. number is the person's reference number (REFN) as the GEDCOM file brought it (and as it goes back into one); it sorts and filters as text.
  • Open question, ⇄ In another tree (the trees on this device the person is in) and Person status (the mark of documentation and reliability from the card, in words; sorted from the strongest; from app 3.27.0 by the reliability of the citations, S7.2) are in every tree. The group Research is only in a tree from the research (A6.7.14).
  • Events (Occupation, Residence, Religion, Military service, Emigration, Education) show each value once, the newest first.
  • The columns … reliability and Research certainty have a value only in a tree from the research (S7).
  • The columns First name, Ref. number, Open question, ⇄ In another tree and Person status are hidden by default.
  • Limits: a collapsed group is a narrow strip; it shows the highest level of a finding in its cells. On a phone the pinned name is narrower and the header can only be read, not changed.
  • Controls:
    • the panel Columns (“12 of 58”): Find a column, groups with the checkbox all, dragging the order, Coverage row, Reset to default, Done;
    • the menu in a column header: Sort ascending, Sort descending, Add to sort (Shift + click), Filter…, Pin left / Unpin, Move left / Move right, Hide column, Collapse group … / Expand group …; at a computed column “Computed from: …”;
    • the column width by dragging the edge of the header.

A6.7.3 Computed and substitute values

What is not written in the tree but can be counted from the data, the table computes. It writes nothing into the tree.

ValueHow it is counted
age (at a child's birth, at marriage, at death)from dates with a day exactly (“67”); from a year, month or range as a range (“28–29”); from a date with abt., bef. or aft. as an estimate (“≈ 67”)
substitute date and placewithout a birth the baptism (“bap. 3 May 1850”), without a death the burial (“bur. …”); an age from them is an estimate (≈)
Recorded age differenceby how many years the recorded age is outside the range of the age from the dates (“+3”, “−2”); an age in words and an age with abt., bef., aft. is not compared
Length of unionfrom the marriage to the divorce, otherwise to the first death of the couple
Birth order, Siblings, Children, Number of unions, Sourcesfrom the links and sources of the tree
  • Dates have the word of precision before them (abt., bef., aft.). An uncertain date is underlined with dots; it is not a finding. A date sorts by its start.
  • Limits: an age is not counted when the end comes before the start. The death columns have Does not apply for a living person (for Death completeness “living”). Father’s/Mother’s age at birth without a recorded parent is Does not apply.
  • Controls: the hint at a cell (“Baptism, birth unknown”, “Burial, death unknown”); at a computed column in the header menu “Computed from: …”; the legend Marks (A6.7.13).

A6.7.4 Completeness and the coverage row

The columns … completeness say how many of the tracked fields are filled in, in percent.

ColumnCounted from
Birth completenessdate, place, father, mother, source
Union completenessdate, place, partner, marriage source; for a union without a wedding (Partners, Separated) only the partner
Death completenessdate, place, source (not for a living person)
Overall completenessbirth, each union and death, weighted by the number of fields
  • A substitute value (baptism, burial) does not fill a field. The hint at a cell lists what is missing (“missing: birth place, birth source”).
  • The Coverage row under the header shows for each column what percentage of the rows has a value (“filled 64 %”, hint “77 of 120”). Under the columns … completeness it shows the average completeness of the rows (hint “average of 120”). It counts only the rows visible at the moment (after the filter and the search). Cells Does not apply are not counted; for union columns the unions that match the filter are counted. Under 50 % the number is bold; without a cell it would concern, it is “–”.
  • A union without a wedding (type Partners or Separated): the empty cells of the wedding (date, place, the age and recorded age of both, the recorded age difference, witnesses, Marriage reliability) have “–” with the hint “Does not apply: a union without a wedding” and are counted neither in the coverage row nor in the completeness. A value that is there anyway (the start of the relationship from the union form) is shown as before.
  • Controls: Coverage row in the panel Columns (on a phone in ⋯); it is saved with the view.

A6.7.5 Findings of the check in the cells

The table shows the findings of Data quality (A5) right at the fact they concern: the cell is shaded and has a mark of the level. The check runs over the whole tree in the background when the app is idle.

LevelMark in the legend
error“The facts contradict each other.”
to check“An unusual value worth checking.”
lead“A lead for the research, not an error.”
unusual (☆)“A finding marked “Not an error”.”
  • A finding goes into the cell of its fact: a parent's age at birth into Father’s/Mother’s age at birth at the child, a finding about a marriage into the age and date of marriage, a recorded age into the recorded age and its difference, a death before birth into both dates and the age, an event into the event's column, the age difference of partners into the partner, a possible duplicate into the name, the spelling of a place into the cells with that place. A finding without a cell of its own is only in the check columns.
  • The columns of the group Checks: Findings (the count; “…” while the check runs), Highest level, Unusual, checked (the number of findings marked Not an error).
  • A finding marked Not an error (A5.7) stays in the cell as unusual (“Unusual, but checked”) and is not counted among the findings.
  • Limits: a read-only tree does not allow marking a finding (“The tree is read-only: findings cannot be marked.”).
  • Controls: a click on the mark opens a bubble (on a phone a bottom panel): the level, the text of the finding, “Finding 1 of 2” and
    • Not an error (the notice “Marked: not an error” with Undo); for an unusual one Report again;
    • Data quality › opens the Data quality dialog at the group of this finding; for an unusual one at the list of marked findings.

    The cells Findings and Highest level open the list of all the person's findings (click, Enter, tap; on a phone a bottom panel): for each the level, the text and whom or what it concerns; reported ones by level, those marked Not an error at the end.

    The legend Marks (“Marks in the cells”) also explains the uncertain date, reliability, a substitute value, a computed value and Does not apply. What each mark looks like: A6.7.13.

A6.7.6 Filter, search and sort

The filter chooses the rows, the search narrows them further, the sort sets the order.

  • Chips of the People table (unions have no chips, events and sources have their own, A6.7.10, A6.7.11): Living, Deceased (they exclude each other), Blood relatives, Family line (a choice of family lines), Generation (a range), Several unions, No birth date, Uncertain date (birth or death), No source, With findings (error or to check; not a lead), Unusual, Unconfirmed research (only a tree from the research). The finding chips wait for the check (“Once the checks finish”). What does not fit is in More (n).
  • A filter in a column (Filter… in the header) by the kind of column:
    • values from a list (sex, union status, level of a finding, family line …);
    • a range from–to (for a date Year, for an age, count and percentage a number);
    • text: contains · starts with · is · is not (regardless of letter case and diacritics; the chip “Column = value ×” or “Column ≠ value ×”; quickly from the cell menu, A6.7.15);
    • for each Only empty · Only filled.
  • All filters apply at once. The number of filters is on Filters (n), Clear filters cancels all. Without a row: “Nothing matches the filter”.
  • Search the table: from 2 characters, regardless of letter case and diacritics, in the visible columns and in the union sub-rows too; matches are highlighted, their number is above the table.
  • Sort: a click on a header sorts ascending, another click descending, a third cancels the sort; it sorts only by that column. Shift + click adds the column as a further key (another click turns it, a third removes it). The arrow ↑ ↓ at the header has the number of the key's order. Empty values are always at the end, in both directions. Numbers in text sort as numbers.
  • Limits: the search is not saved into the view (A6.7.7).

A6.7.7 Table views

A view is a saved setting of the table under a name. The built-in views are ready readings of the tree; a person saves a custom view.

Built-in viewRowsWhat it shows
Overview (default for people)peoplename, date and place of birth, date of death, age at death, partner, date of marriage and age at it, findings, overall completeness; sorted by date of birth
Births and parentspeoplebirth and baptism, parents, their age at the birth, birth completeness; sorted by date of birth
Marriages (default for unions)unionsthe couple, date and place of marriage, age and recorded age of both, status, witnesses, divorce, children, length, sources, completeness; sorted by date of marriage
Deathspeopledeath, cause, burial, age and recorded age at death, death completeness; the chip Deceased; sorted by date of death
Sources and citationspeoplenumber of sources, documentation, reliability of birth and death; from the fewest sources
Gapspeoplecompleteness overall and by parts, birth, parents, sources; from the least complete; unions collapsed
Checkspeoplelevel and number of findings, dates, the parents' age, marriage; the chip With findings; from the highest level, then the number of findings
All events (default for events)eventstype, person or couple, date, place, age at the event, godparents, witnesses, officiant, source; sorted by date
All sources (default for sources)sourcestitle, archive, book and reference, online, people, facts, read by the research, transcript; sorted by title
  • A view saves: the row type, the columns (order, widths, pinning, collapsed groups), the coverage row, the filter, the sort and the expanding of unions. It does not save the search, the selected row or the scroll.
  • A changed view has the label changed and the options Save, Save as new, Discard changes. A built-in view does not change and cannot be renamed or deleted; its changes can only go Save as new. A custom view: Rename…, Delete (with a confirmation). Custom views are sorted by name.
  • The table's work in progress is remembered by the app for each tree on this device; after the page is reloaded or the app is updated, the table is as it was left. It includes the unsaved changes of every view, also of one switched away from: back in it, the view still has the label changed. Save, Save as new and Discard changes settle them. A damaged part of the work in progress is left out.
  • Saved views are part of the tree (data version 17): saving, renaming and deleting have a step back and an entry in the change history. They go with the tree into the backup (JSON) and, when a part of the tree is separated, into the new tree too. GEDCOM does not carry them; a tree from the research keeps them when a new version is loaded. A damaged view is left out when loading.
  • Limits: an older app (from 3.19.0) opens a tree saved by app 3.27.0 read-only and never saves it; after the app is updated the tree can be changed again.
  • Controls: the menu View in the table's bar (Built-in, Custom, Save as new…, Rename…, Delete).

A6.7.8 Row actions and edits

A click selects a row (a union sub-row too); the arrows, Page Up/Down and Ctrl+Home/End move the selection, Esc cancels it.

ActionWhat it does
Show in treeswitches to the Family view with the person as the central person, centred and highlighted
Open person (Enter)opens the person's page
Edit… (double click)opens editing of the person; at a union sub-row and in the Unions table the person's relationships on that union
  • In the Unions table the actions concern the person Partner 1.
  • In the Events table they concern the first person of the row and Edit… opens editing of that event (A6.7.10); in the Sources table there is Open source (A6.7.11).
  • After an edit the notice “Saved: …”, the row flashes briefly and the rows keep their order. A row that no longer matches the filter stays with the label “no longer matches” until the next change of the sort, filter or view. A change from the research is announced by “Research changed 3 facts: …”.
  • One fact can also be edited right in the cell (A6.7.15).
  • Limits: in a read-only tree there is no Edit….
  • Controls: buttons at the selected row, the row menu (right button; expanding unions too). On a phone a tap on a row opens a panel with the actions and the unions (“Union 1: … · Edit ›”).

A6.7.9 CSV and XLSX export

The export saves the table as it is seen into a file for spreadsheet programs: CSV or XLSX (an Excel workbook).

  • What goes out: the visible columns in the table's order (the columns of a collapsed group whole) and the rows after the filter, search and sort. The values are as the table writes them: dates in the app's notation, “abt. …”, “≈ 67”, “bap. …”, “–”.
  • Rows: without a filter and search all rows go out (“Everything shown · 120 people”). With a filter or search there is a choice:
    • Shown (default): only the rows the table shows, with the count and a reminder of the filter (“Shown · 28 of 866 people (filter: …)”);
    • All … without the filter (“All people without the filter · 866”): all rows of that type in the order of the sort, without the filter and the search.

    A row with the label “no longer matches” (A6.7.8) does not belong among those shown.

  • A person with two or more unions: the first union that matches the filter is in their row, each further one in a continuation row with the person's facts empty. After the name is the column Union (“1 of 3”).
  • CSV: text, UTF-8 with a BOM mark, the separator a semicolon, line ends CRLF; a cell that a spreadsheet program would run as a formula is neutralised. The marks of findings and the colours are not exported.
  • XLSX: one sheet named after the view.
    • Row 1 holds the groups of columns (merged cells), row 2 the header, row 3 the coverage row (A6.7.4). The table's pinned columns and these three rows are frozen in the sheet.
    • Each group of columns is an outline: it can be collapsed, its first column stays. The continuation rows of unions are one level lower under the person's row (level 2 of the row outline).
    • A cell with a finding error or to check is shaded and has the findings in a comment. A lead and unusual have neither colour nor comment.
    • Counts, ages in whole years and completeness are numbers (completeness and coverage as a percentage); the rest is text as the table writes it (also “≈ 67”, “28–29”, dates). Text never becomes a formula. A source's link is a link in the cell.
  • File: {tree}_{view}_{YYYY-MM-DD}.csv or .xlsx, without diacritics.
  • Controls: Export ▾ in the table's bar (on a phone in ⋯): Format “CSV · for Excel and Google Sheets” or “XLSX · groups, frozen panes, check colours”, Rows, Download CSV / Download XLSX; the notice “Downloaded: …” with the number of people, rows and columns.
  • Limits: the export from the tree menu (Person table (CSV), A7) is a different file with fixed columns.
  • Since: app 3.27.0

A6.7.10 Events in rows

The Events table has a row for each event of the tree: who, when, where, at what age and who was present.

  • What a row is:
    • each event of a person (baptism, occupation, residence, military service …) and each event of a couple;
    • birth and death from the person's facts, when something is recorded for them (date, place, address, source; for a death also the cause or the age);
    • the marriage of a union: for a marriage always, for another relationship (“Start of the relationship”) only with a recorded fact; the divorce (“End of the relationship”), when the union is divorced or its end is recorded.
  • A shared event (residence, military service, emigration, immigration, naturalization, a custom event) recorded the same way at several people is one row with all those people. The same way means the same type, date, place, address, note and sources; the date must be recorded, and with it a place or a source. A baptism, occupation or title always belongs to one person only.
  • Columns in the groups Event · Participants · Source:
    • Type, Person or couple (for a couple the blood relative of the home person first), Date, Place;
    • Age at the event as elsewhere (A6.7.3); up to one year, from exact dates, in days (“12 d”); for several people the age of each in the order of the names (“–” unknown); for a birth Does not apply;
    • Value: the value of the event (occupation, title), otherwise the cause; for a death the cause of death;
    • Godparents, Witnesses, Officiant, Others present: the participants by role; a person of the tree is a link;
    • Source: the cited sources “title, reference”, several separated by a semicolon; Reliability of the fact.
  • Chips: Births and baptisms (also births from the person's facts), Marriages (also engagements, banns, licences, a contract), Deaths and burials (also cremations), Other events, No source.
  • Filter by participant: a click on a participant's name offers “Filter: godparent …” (for a person of the tree also Open person). The filter is the chip “Godparent: … ×” (Witness, Officiant, Present) and replaces the previous participant filter. A person of the tree is looked for by the person, a written name by its letters regardless of case, diacritics and spaces.
  • A godparent who keeps turning up (A5.5) is in the participant's cell as a lead.
  • Controls: the built-in view All events; the row actions (A6.7.8) concern the first person of the row. Edit… opens, for an event of a person, editing of the person at that event (for a shared one at the first copy), for a birth and death editing of the person, for an event of a couple its dialog, for a marriage and divorce the person's relationships on that union.
  • Limits: placeholder persons have no rows; a birth and death without a recorded fact have no row.
  • Since: app 3.27.0

A6.7.11 Sources in rows

The Sources table has a row for each source of the tree (Actions → Sources, A3.1) and tells how much the source documents in the tree.

  • Columns in the groups Source · Use:
    • Title, Archive, Call number, Folio/page, Image, Other location (A3.9), Online (the address of the source, otherwise the page of its first excerpt, without https://; a web address is a link ↗ into a new window, only http and https; one written without a scheme (“www.…”) opens via https; a click on the link does not change the row selection);
    • People: how many people have a fact that cites the source; a fact of a union documents both partners;
    • Facts: how many facts cite the source. A fact is one list of citations: the person's citation, birth, death, each event of the person, marriage, divorce and each event of the couple;
    • Read by the research: how many readers read the transcript (“1 reader”, “2 readers”: a person in the app and the research), otherwise “no”;
    • Transcript: yes / no; the catalogue of columns also has Record date.
  • Default columns: Title, Archive, Call number, Folio/page, Image, Other location, Online, People, Facts. Read by the research and Transcript are only in the panel Columns.
  • An older source has its whole location in Other location and the new cells empty. Call number, Folio/page and Image sort naturally (9 before 10, 57–58 after 34), empty ones last in both directions; they filter as text.
  • Above the table there can be the offer Split as suggested… (A3.9.1).
  • Citations of placeholder persons and sources of a story are not counted.
  • Chips: No person (no person cites it), Unread, With transcript, Online (the same as the column Online, also with an address without https://).
  • Controls: the built-in view All sources. At a row Open source and Edit…: both open the source manager at that source; Show in tree is not here.
  • Limits: in a locked tree the source is only shown, without edits.
  • Since: app 3.27.0; Call number, Folio/page, Image and Other location (before, Book, reference, folio) also 3.27.0

A6.7.12 Citations and godparents in the People table

The People table has columns that show from which source the birth, marriage and death come, and who was a godparent.

  • Citations (group Sources): Birth: archive, Birth: call number, Birth: folio/page, Birth: image, Birth: other location, Birth: URL and the same for Marriage and Death, in this order; they are not default. The cell shows the value of the first cited source; further sources are in the button “+N”. An older source has its whole location in … other location. The bubble Other citations, the row panel of a source on a phone and the source column in the Events table also give the call number, folio and image. A web address in the column … URL is a link into a new window, as in the column Online (A6.7.11).
    • Birth takes the citations of the birth, then of the events of birth and baptism; death the citations of the death, then of the events of death, burial and cremation; marriage the citations of the union (at a union sub-row of that union). Each source once.
    • Sources from the origin of a fact in the research are not counted, only citations in the data.
    • For a living person the death columns have Does not apply.
    • Sorting and filtering go by the first source.
  • From app 3.27.0: columns of the call number, folio/page, image and other location (… reference showed the whole location before).
  • Godparents (group Birth and baptism): the godparents of the events of birth and baptism, each once; a person of the tree is a link. A godparent who keeps turning up (A5.5) has the mark lead in the cell.
  • Controls: the columns are switched on one by one in the panel Columns (A6.7.2). A click on “+N” opens the bubble Other citations (on a phone a bottom panel); a click on a source opens it in the source manager.
  • Since: app 3.27.0

A6.7.13 Marks in the cells

An overview of everything the table uses to mark a cell or a row. The legend Marks ⓘ at the top right of the table (the bubble “Marks in the cells”, on a phone a panel from below) shows the first two tables: the four levels of a finding and the five kinds of value; in a tree from the research also a third, the research marks.

Findings of the check (A6.7.5). The mark stands at the end of the cell after the value; a click on a cell with a finding opens the finding's bubble.

MarkWhat it looks likeWhat it means (legend)Where it appears
errora solid red circle with a white “!”; the cell tinted red“The facts contradict each other.”the cell of the fact the finding is about; Findings, Highest level; a collapsed group
to checka solid amber square with rounded corners and “?”; the cell tinted amber“An unusual value worth checking.”as for error
leada small hollow grey ring; the cell not tinted“A lead for the research, not an error.”as for error; a godparent who recurs (A6.7.10, A6.7.12)
unusuala grey hollow star “☆”; the cell not tinted“A finding marked “Not an error”.”the cell of the fact; Unusual, checked; Highest level when all the person's findings are marked
  • The circle and the square differ in shape and sign, not only in colour. A screen reader reads the mark as the level and the text of the finding.
  • Findings has the mark of the highest level after the number; Highest level has it before the word. A person without a finding has a faint “0” in the column Findings.
  • A collapsed group of columns (a narrow band) shows the highest mark of its cells.

Kinds of value. None of them is a finding.

MarkWhat it looks likeWhat it means (legend)Where it appears
uncertain datethe date underlined with dots; the word abt., bef. or aft. in smaller grey type before the date“About, before, after or a range; not a finding.”date columns (A6.7.3)
reliabilitythe step's name in grey (in the legend Confirmed): Confirmed, Proven, Probable, Possible, From family tree, Lead, No source“In the Reliability and research columns; for unions in the Marriage group, for events in the Source group.”Name reliability, Birth reliability, Death reliability, Marriage reliability (people, unions), Reliability (events); the steps: S7.1
substitutethe abbreviation bap. or bur. in a small frame before the value, the value in italics; the tooltip “Baptism, birth unknown”, “Burial, death unknown”“A baptism for the birth, a burial for the death.”date and place of birth and death (A6.7.3)
computedgrey type; “≈ 67” an estimate, “28–29” a range“A range from an inexact date, ≈ from an estimate.”ages, the difference of the recorded age, length of the union, counts, generation, completeness; in the header “Computed from: …”
does not apply“–” in grey italics, the same in the legend; the tooltip “Does not apply”“Does not apply to the person.”death for a living person (in Death completeness “living”), the father's or mother's age without a recorded parent, union columns of a person without a union, the wedding's cells of a union without a wedding (hint “Does not apply: a union without a wedding”, A6.7.4), Age at the event for a birth
  • The columns … reliability sort from Confirmed to No source in the order of the table.

Research marks (A6.7.14), only in a tree from the research. The research circle has a rim around it, so even without colour it differs from the error circle (no rim) and the to-check square. The legend adds: “A circle with a rim means research. The research’s ! and ? stand only in the Research columns; a fact’s cell carries only ≠.”

MarkWhat it looks likeWhat it means (legend)Where it appears
waitinga solid amber circle with a rim and “!”“The research is waiting for a decision.”Research, Awaiting decision
waiting on othersa hollow amber ring with “!”“An answer from outside is awaited (a letter, an archive); there is nothing to decide.”Research, Awaiting decision
conflicta solid amber circle with a rim and “≠”“The sources disagree. This is not an error in the data: the question is which source to trust.”before the value in the cell of the fact (no tint, a click opens the conflicts); Research, Conflicts
questiona solid amber circle with a rim and “?”“An open question or a hypothesis.”Research, Hypotheses
agenta turning arc (with reduced motion it stands still)“The agent is working on the person right now (only while following).”Research, Agent; a vertical bar of 3 px at the person's name
done“✓”“The agent has finished its work (for 4 s).”after the name, Agent
  • In the column Research a person in the agent's queue has a grey dot “·” with “in the queue”; “+2” after the mark are further kinds of signal. New from research has the dot “•” in its column.
  • A column that has a value only while following the research has, without following, “–” with the label “live” (the tooltip “Only while following the research”). From app 3.27.0 only when the research bridge does not answer either (A6.7.14).

Other marks (the legend does not show them):

MarkWhat it looks likeWhat it meansWhere it appears
“…”three faint dots; the tooltip “Checks are running…”the check of the tree is still runningFindings, Highest level, Unusual, checked
“◌ Checks are running…”a hollow ring and text at the top right of the tablethe same for the whole table; the finding chips wait for nowabove the table, next to Marks ⓘ
a percentage with a bara number and a short bar whose filled part is the valuecompleteness (A6.7.4)the columns … completeness
a bold number, “–”in the coverage rowcoverage under 50 % (under the completeness columns an average under 50 %); “–” a column with no cell it would apply toCoverage row (A6.7.4)
“+2”a number in an oval frame after the first citationfurther cited sources; a click opens Other citationscitations of birth, marriage, death (A6.7.12)
“↗”after an underlined web addressa link into a new windowOnline, the citations “… URL” (A6.7.11, A6.7.12)
cell outlinea thin outline of 1 pxthe active cell (A6.7.15)a cell of the selected row
text cursoron hovering with the mousethe cell can be edited in place (A6.7.15)editable cells
●○, ●●one or two solid dots before “1 reader”, “2 readers”; the tooltip says who read the transcripthow many readers read the transcriptRead by the research (A6.7.11)
“12 d”a number with “d”an age under one year in daysAge at the event (A6.7.10)
▾, ▸a triangle before the namethe person's unions expanded, collapsed (A6.7.1)Full name of a person with two or more unions
“3 unions”for a collapsed person in an oval frame after the name; for an expanded one in the column Partner in grey italicsthe person's number of unionsthe person's row
“└ Union 2 of 3”an indented sub-rowone union of the personthe union sub-row
“2 unions outside the filter · show”a button in an indented rowunions that do not match the filter; those shown are dimmedunder the union sub-rows
“no longer matches”the whole row faint, the text in italics at the endthe row no longer matches the filter after an edit (A6.7.8)until the next change of sort, filter or view
highlightthe matching text with a backgrounda match of the search (A6.7.6)visible columns
↑, ↓ (↑1, ↓2)an arrow in the header, with a number for several keysthe direction and order of a sort key (A6.7.6)the column header
−, +a sign by the group's namecollapse, expand a group of columns (A6.7.2)the row of groups above the header
  • Limits: the CSV export carries neither marks nor colours; XLSX carries only the tint and a comment for error and to check (A6.7.9).
  • Controls: Marks ⓘ at the top right of the table.
  • Since: app 3.27.0

A6.7.14 The research in the Table

In a tree from the research (S1) the table also shows what the research knows about the people: what is awaiting a decision, conflicts of sources, hypotheses, the agent's work, the lines and the exchange with the tree. It writes nothing into the tree.

  • Columns of people (the group Research, hidden by default; the checkbox all switches on Research, Awaiting decision, Conflicts, Hypotheses and Agent):
    ColumnWhat it shows
    Researchthe person's most urgent signal in the order waiting › conflict › question or hypothesis › agent › in the queue; “+n” further kinds
    Awaiting decisionthe count and the first item; when waiting on others “from outside: …” (letter sent, a query in the family …)
    Conflictsthe number of open conflicts and the facts (“· birth, …”); “· can be decided in the app” where that is possible (S2)
    Hypothesesthe number of open hypotheses; “decided by agent”
    Research tasksthe person's tasks in the queue (“2 · next no. 3 in the queue”, “1 · running now”)
    Agent“working: {task}”, “in the queue”, “done”
    Linethe person's place among the lines (below)
    Materials, Tree ends here, Searched, nothing found, Exchange with research, Originally in the family tree, Story, Where it is handled, New from research, Source availability, Parish (research), Estimated birthwhat the research knows about the person's materials, about the edge of the tree, about the exchange with the tree, about sources and places
  • Unions: Research ID (F…), Line (by the partner from the line), Agent (“working on the couple: …”) and Conflicts (conflicts about the marriage and the divorce for both partners). Sources: Research ID (S…) and Scan: “on the research’s computer”, “scan missing on the research’s computer” (highlighted), “online (archive)”.
  • Line: in a line (the partner of a person from the line “· partner”; a side branch added to a line belongs to that line), “side branch: {name}”, “island”, “off the lines”. Off the lines are side branches not added to a line, islands and the rest (R2.3). The table takes the lines live from the research, otherwise from the research's file; they are sorted in the order of the research's lines, then branches, islands and off the lines, within them by generation. The column and the line chips are only for a research with lines.
  • Conflict on a fact: the cell of a fact with an open conflict of sources has “≠” before the value, without a tint. A click on “≠” opens the bubble with the conflicts; a screen reader reads “{value}, sources disagree: {fact}”. The research's marks “!” and “?” are only in the research columns (A6.7.13).
  • Chip Research ▾: one chip with a menu in the sections Signals, Lines, Exchange, sources and places, More research chips and New from research; “A choice opens the Research block in the row.” Chips: Awaiting decision, With conflicts, With questions, Agent working / queued, one for each line and Off the lines (with counts), Not sent, Changed by research, To decide here, Waiting on others, New from research (last 24 h, last 7 days, since the last opening), Reading room only, Place unidentified, Decided by agent, Paused / postponed, Tree ends here. On a phone the section Research is in the panel Filters, the less frequent chips under More research (n).
  • Built-in views (the section Research in the menu View; like the other built-in ones they do not change, A6.7.7):
    ViewWhat it shows
    Researchpeople with a signal: name, Research, Awaiting decision, Conflicts, Hypotheses, Agent, Research tasks, birth, death; sorted from the most urgent, then by name
    Line: {line} (for each line) and Off the linesname, Line, generation, Research, birth, death, Conflicts, Agent; the line chip; sorted by line
    Exchange with researchpeople with an exchange: name, Exchange with research, Originally in the family tree, New from research, Conflicts, birth

    The unions are collapsed in them and the coverage row is on. An empty view says “The research needs nothing right now” or “The tree and the research are in sync”.

  • Research bubble: a click on a research cell opens a bubble (on a phone a bottom panel) with sections according to what the person has: Awaiting decision · n (Compare versions ›, Awaiting action ›), Waiting on others, Source conflicts · n (Decide ›), Hypotheses or Open question (What the research knows ›, S3.5), Agent working (Follow the research ›), Research tasks in the queue (Open the task in the research), Materials ›, Line or Off the lines (Show the line in the tree, Change in the research), Originally in the family tree (Restore the family tree value, only with the research on this computer) and Source availability. An action that is confirmed in the research has a mark as elsewhere (S4.5.1).
  • Live: while the research is followed only the cells the change concerns change; the order of the rows stays. At the name of a person the agent is working on a vertical bar runs. Above the table stands “● Following the research live”, otherwise “Research: as of {when}”.
  • Export: CSV and XLSX carry texts and counts (“waiting; conflict (1)”, “1: birth”, without a conflict “0”), without marks. Without following (from app 3.27.0 only without an answer from the bridge), Agent and Research tasks are empty and the notice says “Agent and Research tasks are empty: the research is not being followed.” The coverage row has “–” for the research columns.
  • Limits:
    • without an agent (Strom archive) and in a read-only tree there are no Awaiting decision, Research tasks and Agent, nor the chips Not sent and To decide here; the view Exchange with research is only in a research with an agent that can be changed;
    • Agent and Research tasks have a value only while the research is followed, otherwise “–” with the label “live”; the chip Agent working / queued does not filter without following. From app 3.27.0 both hold only without an answer from the bridge (below);
    • in a read-only tree the bubble has no actions: “Read-only: conflicts cannot be decided here.”
  • Without following, with the bridge: when the research bridge on this computer answers, Agent and Research tasks (also the bar by the name, the chip Agent and the export) take the agent's work and the queue from a regular ask of the bridge and look as while following. An empty bridge queue leaves the cells empty. The table redraws when the bridge's answer changes. A phone does not ask the bridge. The Research overview without following works the same way (S4.1.5).
  • Controls: the panel Columns → the group Research; the chip Research ▾; View → the section Research; Marks ⓘ.
  • Since: app 3.27.0 with research 1.31.0

A6.7.15 The active cell, the cell menu and editing in place

A click on a cell selects the row and makes the cell the active cell (a thin outline); the arrows move it. The active cell can be copied, the table filtered by its value and the fact in it edited right in the table.

  • Copy: Ctrl/Cmd+C without selected text copies the text the active cell shows, without marks, icons and pills. Text selected by hand is copied as usual.
  • Cell menu: the row menu (right button, Shift+F10) and on a phone the row panel (a tap on the cell) begin with the cell's choices Copy, Only “{value}” and Without “{value}” (the value shortened to about 24 characters with “…”); under them are the row actions (A6.7.8). The menu opens at the cell, also when another row was selected.
    • Only and Without set the column filter is / is not (A6.7.6), the chip “{Column} = {value} ×” or “{Column} ≠ {value} ×”; the comparison ignores letter case and diacritics. A cell with a person's name compares the person: Only “{father}” in the column Father shows the siblings, not the children of a namesake.
    • An empty cell offers Only empty and Only filled, a cell with a list of values sets the value filter. A cell without one value to compare (a research mark, several names, completeness, the number of unions) offers only Copy; the row's own name or title has only the row actions.
    • The filter is saved with the view (A6.7.7).
  • Editing in place: a cell can be edited when it stands for one fact of the tree:
    • First name, Surname (when it shows the married surname, it edits that), Birth surname, Married surname;
    • Sex by a choice (Male, Female, Unknown) and Ref. number;
    • the date and place of birth, baptism, death and burial, Cause of death and Recorded age at death;
    • Occupation, as long as the person has at most one;
    • the union's facts (the Unions table, a union sub-row, the row of a person with one union): Union status by a choice (Married, Partners, Divorced, Separated, as in the union form), the date and place of the marriage, each partner's recorded age at the marriage (Recorded age at marriage, Partner’s recorded age, Recorded age 1 and 2), Divorce date and Divorce place. An empty cell creates the union's fact as the union form creates it. In a union without a wedding (A6.7.4) the wedding's cells are not edited.

    Full name is not edited in the cell (it is made of several parts), nor are computed cells, checks, research, citations, counts and relationships; a double click on them opens Edit….

  • The field covers the cell. Enter saves, Esc cancels, Tab and Shift+Tab save and go to the next or previous editable cell of the row, a click elsewhere saves. In a choice a click with the mouse saves the value at once; after choosing with the arrows, Enter, Tab or a click elsewhere saves it. The date is read as in the person form; an unreadable one stays in the field with the error “The date cannot be read (e.g. 1880-05-15, 1880, about 1880)”. The place offers the places of the tree. Without a first name and a surname nothing is saved: “A first name or a surname has to stay”.
  • Saving goes the same way as the person form (the union's facts as the union form) and is one step back (Ctrl/Cmd+Z), also when an empty cell created the fact. Baptism and burial edit the first such event (its other facts and citations stay), or add one; an empty field deletes only that fact. Then the row flashes, stays in place and the notice says “Saved: {name}”.
  • Limits: editing in place is not possible in a read-only or locked tree, in the Strom archive, on a phone and for a locked person. On a phone a fact is edited via the row panel → Edit….
  • Controls: a double click, F2, Enter on the active cell (for a cell with a finding Enter first opens the finding's bubble), in the row menu Edit cell (F2). An editable cell has a text cursor on hovering with the mouse.
  • Since: app 3.27.0