ADAR / User guides

ADAR / Detailed user guide / 01

Literary & Corpus Stylistics

A practical guide for your first study—and for turning automated observations into careful, evidence-led interpretation.

For students, literary researchers, teachers, and corpus analysts. You do not need programming knowledge. Begin with one short, well-prepared text and a clear research question.

Open Literary & Corpus Stylistics Read the Corpus Builder guide

1. What this workspace does

Literary & Corpus Stylistics helps you locate textual patterns, inspect their exact evidence, compare selected texts, and record your interpretation. It combines close reading with reproducible corpus observations. It is not an academic-writing quality grader, an automatic literary critic, or a test of an author's merit.

A target is a text you want to investigate. A reference corpus is a deliberately chosen comparison set. A finding is a candidate observation: a repeated opening, for example, or a word that is relatively frequent in the target.

The workspace does not produce an overall foregrounding score. Counts cannot establish beauty, intentionality, reader response, or cultural meaning by themselves. Those claims need your contextual argument and, where appropriate, further research.

Two connected workspaces: use Corpus Builder to assemble, document, review, and reuse collections—including scanned PDFs. Use Literary & Corpus Stylistics to investigate selected texts and review the resulting evidence report. You can also add manageable documents directly to Stylistics.

You can explore the public Load read-only demonstration without signing in. Its review and export controls are disabled; it does not save work. Sign in to create and use your private workspace.

2. Your first study, step by step

  1. Sign in and open the workspace. Navigate to Literary & Corpus Stylistics from ADAR's home page or dashboard.
  2. Start small. Choose one poem, speech excerpt, or short prose passage you have permission to use. Preserve the punctuation, paragraphing, and line breaks you intend to study.
  3. Add the target. Under Add to corpus, paste the text, supply a useful title and metadata, select its language and the Target role, then choose Add document(s) to corpus.
  4. Inspect the saved text. Use Edit in the corpus library to check the source and metadata. Correct extraction problems before running a study.
  5. Optionally add a reference. Add an appropriate comparison text with the Reference role. You can begin without one, but cannot then establish deviation against an external corpus.
  6. Select the study. Under Prepare an analysis, enter a descriptive report title and select the intended target and reference documents. Do not rely on a document's role label alone; check the actual selections.
  7. Run it. Choose Analyze selected texts. Open the evidence, methodology, comparisons, warnings, and internal-validation information.
  8. Review a few findings carefully. Read the excerpt in its wider context, check its baseline, and save an accepted or rejected judgment with reasons.
  9. Export a record. Download the PDF or HTML report for reading, CSV for the coding sheet, and JSON for the fuller reproducibility record.

A deliberately small practice exercise

We will rebuild our homes.
We will rebuild our schools.
We will rebuild our future.
But who will rebuild us?

This is an invented teaching passage, not a historical quotation or an experimental result. Paste it as a target and investigate whether the repeated openings and final question are detected. Ask what changes between “homes,” “schools,” “future,” and “us.”

A defensible interpretation would connect exact wording and local sequence to a possible rhetorical effect. Do not claim that repetition proves persuasion or that an audience was moved. This tiny example is useful for learning the interface, not for reliable significance testing.

3. Frame a useful research question

Choose a question that links an observable feature to a context you can investigate. For example:

Write down why each text belongs in the study, the edition or source you used, the period and genre, and any exclusions. Avoid selecting only passages that support your preferred answer. Keep exploratory observations distinct from hypotheses specified before analysis.

For a reusable source library and a selection record that travels into the report, assemble the study in Corpus Builder first.

4. Prepare and add texts

Paste or upload

The direct workspace accepts DOCX, searchable PDF, TXT, Markdown, CSV, and JSON. Save legacy DOC files as DOCX first. You can select multiple files. If you both paste a document and upload files in one submission, check the library afterward: the pasted document can succeed even if the file batch fails.

Record a meaningful title, author, year, genre, language, and corpus role. Metadata is part of your research record; it does not automatically make a reference comparable or verify an attribution.

Inspect extraction

Check the beginning and end of the saved text, chapter boundaries, paragraph breaks, punctuation, columns, and verse lineation. Headers, page numbers, hyphenated line endings, tables, or editorial notes can create misleading patterns. Word formatting, text boxes, footnotes, and page layout are not guaranteed to survive conversion.

Scanned PDFs: the direct Stylistics uploader does not automatically recognize image-only pages. Use Corpus Builder's OCR and review workflow, or upload a reviewed searchable PDF. Do not assume that an invisible text layer is accurate.

CSV and JSON batches

CSV requires a text column. Optional columns include title, author, year, genre, language, and role. Quote cells containing commas or line breaks. Use en or other for language and target or reference for role.

title,text,author,year,genre,language,role
Practice passage,"We will rebuild our homes. We will rebuild our schools.",Teaching example,2026,speech,en,target

JSON accepts an array of document objects, or an object with a documents array. Use valid JSON; a reference role is not a bibliographic reference.

{"documents": [
  {"title": "Practice passage", "text": "We will rebuild our homes.",
   "language": "en", "role": "target"}
]}
Before editing or deleting: download reports you need to retain. Saving source edits or deleting a direct-workspace document invalidates dependent reports and their manuscript drafts. Do not treat this workspace as your only source archive.

5. Choose targets and references deliberately

The question determines the comparison. Match—or explicitly justify differences in—genre, period, language, medium, topic, audience, and edition. A speech compared with fiction may reveal genre differences rather than an individual speaker's distinctive style.

Keep targets and references separate. Do not use the same source, another edition of it, or a heavily overlapping excerpt as its own comparison. Equal corpus size is not mandatory because rates are normalized, but extreme size imbalance, sparse evidence, and unequal diversity still affect interpretation.

Record the number of original works as well as token counts. Chapters cut from one novel are not independent authors or independent works.

6. Run and manage a report

In Prepare an analysis, confirm the target and reference selections, give the report a useful title, and check Analysis language. This is a default; each document retains its recorded language. Choose Analyze selected texts.

Wait for the saved report rather than treating an input page or an error response as success. The report should display findings and report details. You can open saved reports from the workspace, review them, and export them. A saved report can also be opened using its report link.

Local stylistics analysis is separate from the main ADAR analysis pipeline and does not consume its analysis allowances. Importing an existing ADAR document brings available results into the study; it is not a fresh run of that pipeline. Owner manuscript generation is a separate provider-backed action.

7. Read the report in the right order

  1. Check the study identity. Confirm titles, document counts, target/reference selection, language, and analyzed word counts.
  2. Read methodology and warnings. Understand which rules, linguistic resources, and baselines were available.
  3. Inspect the analytical narrative. Treat it as a synthesis of the measured findings and current reviews, not as an independent source of truth.
  4. Open exact evidence. Check quotation, document, location, source offsets, contextual passage, baseline, and proposed interpretation.
  5. Compare alternative explanations. Repetition may be a meaningful pattern, a genre convention, a quotation, a heading, or an extraction error.
  6. Review and export. Your decisions should remain visible beside the machine-generated candidates.

A large number of findings can reflect text length, repetition, segmentation, or extraction artifacts. It is not a ranking of literary quality. Few findings do not mean that a text lacks stylistic interest.

8. Understand candidate findings

ObservationWhat to inspectWhat not to assume
Repeated openings or endingsRepeated wording, unit boundaries, placement, and variation. Decide whether anaphoric or end-position repetition is a useful description.Every repeated opening is intentional foregrounding.
Recurrent phrases and lexical patterningExact recurrence, distribution, surrounding words, and genre expectations.Frequency alone establishes importance, originality, or collocation strength.
Local length or structural departuresThe quoted unit and the report's stated local baseline; paragraph and sentence segmentation.A short or long unit is automatically an error or an aesthetic achievement.
Punctuation and capitalizationSource typography, rhetorical position, acronyms, editorial conventions, and OCR artifacts.Capital letters always mean emphasis or ellipses always mean hesitation.
English contrast-pair or grammatical observationsThe exact pair or tagged pattern, its context, language setting, and tagger availability.A general semantic-anomaly detector or perfect grammatical analysis is available.
Recurring attached ADAR functionsEvidence overlap, the existing ADAR label, its provenance, and recurrence across distinct units.The label establishes a new cultural classification by itself.

Keep phonological interpretation, broad semantic claims, author intention, and audience effects separate unless you have the additional evidence needed to support them. The software does not replace those investigations.

9. Understand corpus comparisons

Comparisons use pooled target and reference tokens. They answer questions about relative lexical occurrence in the selected material, not about the whole language or a population of writers.

MeasurePlain-language meaningResearch caution
Raw countHow often a term occurs in the selected material.Larger corpora naturally permit larger counts.
Normalized rateOccurrence adjusted for corpus size. Use the scale displayed in the report.Comparable rates do not fix differences in genre, sampling, or document dependence.
Smoothed log2 ratioA directional relative-frequency contrast. Positive values favor the target; negative values favor the reference.Read it with actual counts and the smoothing rule. A large ratio based on rare terms is unstable.
G² (log-likelihood statistic)A measure of departure from an equal-relative-frequency expectation for the selected counts.It does not identify the literary cause of that departure.
Exploratory p-valueAn asymptotic statistical quantity under the comparison's assumptions.It is not the probability that your literary interpretation is true. Sparse counts can make the approximation unreliable.
BH q-valueA multiple-testing adjustment using the Benjamini–Hochberg procedure.It does not remove sampling bias, dependence, or an unsuitable reference corpus.
Document frequencyHow many documents or recorded original works contain a term, according to the report's grouping.Repeated chapters from one work are not independent evidence from many authors.

Always inspect the actual concordance and original-work distribution. A contrast concentrated in one long document is different from a pattern recurring across several independent texts. Avoid reporting statistical significance as aesthetic significance.

No reference selected? Local observations can still be useful. However, “frequent here” is not the same as “unusually frequent compared with comparable texts.” The latter requires a defined external baseline.

10. Review and annotate evidence

Use the evidence filters to narrow by search text, category, document, or review status. Open each relevant candidate and read the source context, not just the highlighted words.

  1. Check that the quotation and location match the source.
  2. Check that the stated rule or baseline actually applies.
  3. Choose Accept candidate, Reject candidate, or leave it Unreviewed.
  4. Use the notes field for your rationale, ambiguity, extraction concerns, or an alternative explanation.
  5. Use the interpretation field for your evidence-grounded reading, then choose Save review.

Acceptance records your adjudication; it does not turn an exploratory observation into a universally validated claim. Rejection is useful research data, especially when explaining false positives or genre conventions. Review changes regenerate the analytical narrative and can mark an existing manuscript as needing revalidation.

Example review note: “Accept the repeated-opening observation: the first three units begin with the same phrase. Interpretive claim remains local; the final question changes the object of rebuilding. No audience-effect claim is made.”

11. Use concordance to test your reading

Enter a literal word or phrase in the concordance search and choose Search corpus. Read occurrences with their surrounding context and note which documents supply them.

The search is a literal substring search, not a lemma, whole-word-only, regular-expression, grammatical-pattern, or semantic search. A short search string can occur inside a longer word. Results show up to 250 occurrences; a visible result list is not proof that you have inspected every occurrence in a large corpus.

Search variants explicitly when needed. For a claim about “build,” for example, consider relevant inflections and compounds separately and explain your search procedure. Concordance supports close reading; it does not automatically calculate a formal collocation association measure.

12. Connect an existing ADAR analysis

  1. Run the relevant text through the main ADAR workflow.
  2. In the same authenticated browser session, open Literary & Corpus Stylistics.
  3. Choose Import current ADAR document.
  4. Confirm the imported text and metadata, then run or rerun the stylistics study.

Import requires an unexpired analysis belonging to the current browser session. An exact-text match updates the existing document rather than creating a duplicate. A report made before the import must be rerun to include the new attachments.

Existing schemata, speech acts, pragmemes, practs, culturemes, and lexical-cohesion information are linked only when their quoted evidence overlaps a stylistic passage. A plain upload has no attached ADAR classifications; missing layers are not invented.

13. Understand internal validation

New reports run internal validation automatically. Validate with ADAR reruns the checks on a saved report, including an older report.

The audit checks source quotations and offsets, reproduces supported rule detections and baselines, examines attached ADAR provenance, and recomputes corpus quantities and comparison statistics. Missing framework layers are marked unattached. Failed checks remain visible and block new owner manuscript generation.

“Internal checks: passed” is not an independent accuracy certificate. It indicates consistency with the stored source, implemented rules, and calculations. It does not prove an interpretation, validate every cultural attribution, certify OCR accuracy, or establish agreement with independent experts.

Researcher review and internal validation answer different questions. A source-consistent candidate may still deserve rejection as analytically unhelpful. An accepted interpretation must still have accurate source evidence and a defensible baseline.

14. Export and preserve your study

FormatUse it forKeep in mind
PDFA readable analytical report and evidence record for review or sharing.It is not a replacement for the structured research record or source archive.
HTMLA browser-readable analytical report.Review its content before circulation.
CSVA coding sheet with candidate evidence, baselines, review records, validation details, and available attribution.It is not a full copy of the source corpus.
JSONThe fuller reproducibility record, including report data and source-document information.It may contain copyrighted or private text. Store and share it appropriately; it is not a guaranteed one-click workspace backup importer.

Use filenames that identify the study and revision. Keep source files, corpus-selection criteria, any exclusion record, review decisions, and the final report together. If the study came from Corpus Builder, the report's pinned corpus snapshot records the selected versions and provenance.

Download essential records before deleting reports or modifying source documents. Deletion confirmations are consequential, not merely cosmetic.

15. Owner-only manuscript studio

This section applies only to ADAR's designated owner with the required administrator role. Ordinary users and other administrators do not receive access simply by opening a report.

  1. Open a saved report and resolve failed internal checks.
  2. Accept at least one verified evidence candidate.
  3. Supply a research topic, research question, and one bibliography entry per line. A target-journal field is optional.
  4. Choose a target of 3,000–8,000 words and request generation.
  5. Review the actual word count, evidence identifiers, citations, argument, and limitations. Edit and save the draft as needed.
  6. Export DOCX, PDF, text, or HTML only after authorial review.

Generation sends measured results, accepted evidence, and supplied references to the configured manuscript provider. It is not a purely local action. Supplied bibliography entries and journal claims are unverified. Do not include confidential material unless its transmission is permitted.

The workflow uses the owner's supplied academic voice guidance for manuscript prose, not to rewrite quoted literary evidence. Short or incomplete outputs can be rejected rather than presented as complete. Review changes can require manuscript revalidation.

A draft is not a guarantee of indexing, journal acceptance, accurate references, scientific validity, or publication readiness. The author remains responsible for claims, disclosure, permissions, and journal requirements.

16. Languages, limits, and troubleshooting

Current workspace limits

These are the limits of this dedicated research workspace, not a description of the main ADAR speech-analysis route. For long works, Corpus Builder can retain larger originals and prepare bounded, source-preserving analysis parts. The selected study still has its own limits; no unlimited-size claim is implied.

Language coverage

Set each document's language correctly. English grammatical observations use an offline English tagger when available; its absence is disclosed. Other-language texts retain supported Unicode lexical and positional observations but do not receive English grammatical or semantic rules. Tokenization is not designed for unsegmented Chinese or Japanese. Cross-language lexical comparisons need particular caution.

ProblemWhat to do
Analyze is disabledAdd valid documents and select at least one target. Confirm that the selected study is within the limits.
PDF cannot be readCheck whether it is scanned, locked, oversized, or has empty pages. Use Corpus Builder OCR for scans, and review the result.
Unexpected repetition or punctuation findingsInspect headers, line breaks, page numbers, transcription, and OCR. Correct the source, then rerun; preserve earlier exports if needed.
No corpus comparisonSelect suitable reference documents. A role label alone does not establish a study selection.
No attached ADAR elementsUse Import current ADAR document in the same session after a successful, unexpired main analysis, then rerun the report.
A report disappeared after editingDependent reports are invalidated when their direct source documents change. Run a fresh report; use previously downloaded exports for the earlier study.
An internal check failedRead the failed-check details and verify source text, offsets, provenance, and selections. Do not conceal the failure or claim the report is validated.
A save reports a conflictAnother tab or request may have changed the workspace. Reload, inspect the latest version, and reapply your intended change carefully.
Owner generation is unavailableCheck designated-owner access, the saved report, internal checks, and accepted evidence. Other administrators cannot bypass the owner restriction.

17. Before you present or publish a study

  • I can identify the source, edition, rights, and selection criteria for every text.
  • I inspected extraction and preserved relevant literary lineation.
  • I can justify my reference corpus—or explain why no external comparison is claimed.
  • I distinguish original works from artificial analysis parts.
  • I checked the evidence and recorded decisions for the findings I discuss.
  • I distinguish internal validation from independent accuracy or expert agreement.
  • I report raw counts, corpus sizes, distribution, statistical cautions, and limitations where relevant.
  • I do not infer reader response, intention, or cultural meaning from a count alone.
  • I exported the analytical report and structured research record and checked permissions before sharing.

18. Plain-language glossary

Baseline: the expectation against which an observation is compared; it may be local or based on a reference corpus.

Candidate: a detected observation that still requires contextual review.

Concordance: occurrences of a search string shown with surrounding text.

Foregrounding: interpretively significant prominence or deviation; not something established by a frequency count alone.

Keyness: a relative-frequency contrast against a specified comparison corpus, not an automatic measure of literary importance.

Provenance: the recorded origin and processing history of evidence.

Source offset: a recorded position in the analyzed text used to locate exact evidence.

Target / reference: the material being investigated / the selected comparison material.

Token / type: an occurrence of a word-like unit / a distinct unit under the tokenizer's rules.

Validation / review: automated internal consistency checks / the researcher's recorded assessment and interpretation.

Next: open the Stylistics workspace, or use the Corpus Builder guide to prepare a documented collection.