figran

Testing a figure legend in both directions

By Figran Team

A legend can sound clear and still fail to describe the marks in a figure. This worksheet turns one small legend into two checks, so a reviewer can identify exactly which direction fails and what the source permits them to repair.

The cards, statuses, and border styles below are invented teaching examples. They are not research data, experimental findings, or evidence of a successful classroom intervention. You can work through the exercise on paper or in any diagram editor; no Figran account or generated image is needed.

1. Separate the source record from the drawing

For this exercise, the source records only two review states: Checked and Draft. A state says what has been recorded about the review process. It does not establish that a statement is scientifically correct, complete, or supported by evidence.

The local drawing convention is:

All and only cards recorded as Checked use a double border. Cards recorded as Draft use a single border.

This convention belongs to this fictional worksheet. It is not a general meaning of borders, a universal diagram standard, or a claim about Figran's features.

Here is the starting source-and-render record:

Card Recorded source state Border shown in the draft
A Checked Double
B Draft Double
C Checked Single
D Draft Single

Keep the source-state column fixed while you review the drawing. The border column describes the draft, including its mistakes; it is not a second source of truth.

2. Read the legend in two directions

“All and only” creates two separate obligations.

Direction one: double border to Checked. Select each card with a double border. Its recorded source state must be Checked. This asks whether the mark is being used for a card outside the stated category.

Direction two: Checked to double border. Select each card whose source state is Checked. Its shown border must be double. This asks whether a card in the category is missing the required mark.

Write the two sentences out before inspecting the rows. A vague note such as “the legend is inconsistent” does not tell the next editor which case needs repair.

If a different source specified only one direction, do not silently add the other. For example, “every Checked card has a double border” alone does not say that every double-bordered card is Checked. Our fixture explicitly specifies both directions, so both checks apply here.

3. Find the smallest counterexample

For direction one, inspect A and B because those cards show double borders. A is recorded as Checked, so it satisfies the condition. B is recorded as Draft, so B is a counterexample to double border implies Checked.

For direction two, inspect A and C because those cards are recorded as Checked. A has a double border, so it satisfies the condition. C has a single border, so C is a counterexample to Checked implies double border.

A and D match the complete local convention. B and C fail it in different ways. A correct row does not cancel an incorrect row, and one direction passing would not prove that the other passes.

Use a short review note for each failure:

  • B: “Recorded Draft, rendered double; the mark wrongly signals membership in Checked.”
  • C: “Recorded Checked, rendered single; the required Checked mark is missing.”

These are observations about the fictional source and drawing. They do not describe the quality of the underlying scientific content.

4. Repair the marks from the source

With this source and convention held fixed, the permitted drawing repair is straightforward:

Card Source state retained Border in the corrected drawing
A Checked Double
B Draft Single
C Checked Double
D Draft Single

Change B's border from double to single, and C's from single to double. Retain A and D as they are. Then repeat both checks against the corrected drawing.

Do not change B's recorded state to Checked or C's recorded state to Draft just to make the original borders appear consistent. A source-state change needs a separate, documented source decision. It is not an ordinary visual repair.

Likewise, changing the legend to excuse a mistaken drawing changes the convention. If the author wants that change, record the new decision and review all affected cards against it. Do not make it quietly during this exercise.

5. Handle a missing state without guessing

Now consider an additional invented card E. It shows a double border, but its source state is blank.

E is unresolved. You cannot confirm that it satisfies the convention, but the blank is not proof that E is Draft. Do not assign a state from its border, assume a missing value means Draft, or announce a proven counterexample without a recorded state.

An appropriate review question is: “What review state should the source record for E, and who is responsible for confirming it?” Keep E marked as unresolved in the review record until that source decision is available. Once the state is recorded, apply the same two-direction check and choose the appropriate border.

If all cards must have a known state before release, E prevents this fixture from being signed off. That is a completeness issue in the source record, separate from the demonstrated border errors on B and C.

6. Reject a stronger meaning that the source cannot support

Suppose an editor proposes the legend “Double border means scientifically correct.” That statement exceeds the fixture. The source records review states, not correctness, evidence strength, or confidence.

Retain the modest meaning Checked review state and keep a visible text label alongside the border if the figure needs a text route to the state. This worksheet does not establish an accessibility result or a performance improvement; it simply avoids relying on an unexplained mark to carry the entire label.

7. Use a revision record someone else can audit

For a proposed pair-review activity, one reader can check double-border to Checked and another can check Checked to double-border. Compare the specific rows each reader identifies, then repeat both directions after repair. This is an activity proposal, not a report of a tested teaching method.

Copy this blank record into your review notes:

  • Source record or version:
  • Exact local convention:
  • Direction checked:
  • Card and recorded state:
  • Border observed:
  • Decision: matches / counterexample / unresolved:
  • Visual repair or source question:
  • Result after repeating both directions:

The useful output is a traceable reason for an edit. “Looks better” cannot substitute for the card, source state, convention, and changed mark.

8. Check your reasoning

Why is B a counterexample in one direction? Its double border requires Checked under the fixture, but the source records Draft.

Why is C a different counterexample? The source records Checked, which requires a double border, but the drawing shows single.

Does E prove the legend wrong? No. Its recorded state is missing. It remains unresolved until the source is clarified.

Can we fix the exercise by calling Checked “scientifically correct”? No. That would add a claim absent from the source. The state remains a recorded review state.

Authorship and reuse

This original teaching worksheet was prepared by Figran Team, affiliated with Figran. Figran is a commercial AI-assisted scientific figure tool. AI assisted the drafting of this text. The exercise is tool-independent and makes no claim about generated-figure accuracy, research validity, or measured learning outcomes.

Public contact: support@figran.net.

The teaching text and fictional fixture in this article are offered under Creative Commons Attribution 4.0 International. Attribute Figran Team, link to this article and the license, and indicate changes. This permission covers the article's teaching content only; it does not license Figran software, logos, trademarks, or third-party material.