User guide / Develop an analysis
Plan an analysis with help
Discuss your objective, add assay data, and prepare an editable configuration for your review before running an analysis.
Who can use this: Team workspace with active access; owner, administrator or member role. Work on your own setup. Reviewers cannot create drafts. Personal workspaces support manual configuration.
Before you start
Know what you want to determine or compare. You can discuss the objective before choosing a model or adding data. To propose a configuration, you will need assay measurements and the information that gives them meaning: samples, standards or reference, concentrations, units, dilutions and replicates.
Use only material your organization permits you to share with the assistance service. Have the relevant procedure or supporting documentation available to check the proposed settings.
Assay data can be CSV, TSV, TXT or a supported static XLSX workbook. Supporting PDF or DOCX documents provide context, not measured assay data. PDF support uses extracted text and tables; it does not perform OCR or let the assistant visually interpret pages. Inspect the original PDF yourself when needed.
Prepare a configuration
- Select the intended Team workspace and open New analysis, then select Start conversation. Under Plan your analysis, enter your objective in Message and select Send. For example: “I want to compare the potency of my test samples with a reference.” If an existing setup opens, check that its objective and inputs belong to the work you intend to continue.
- Use Message and Send to discuss the task, supply missing facts or ask about supported approaches. Read the response. Send continues the conversation. It does not change your saved settings or run the analysis.
- Open Add files and supporting context. Under What are you adding?, choose Assay data, select the Assay data file and select Add input. Check that the file appears in the added inputs. Select the appropriate supporting input type to add documents or notes in the same way; confirm a Delimiter for supporting tabular files if requested. Selecting a file alone does not add it.
- In Current analysis brief, use Choose analysis family and then Confirm analysis family if the family is still unselected. Choose Relative potency to compare a test preparation with a reference, or Concentration determination to estimate unknown concentrations from a calibration curve. Discussion can help you decide; you confirm the family.
- Finish adding selected inputs and save or discard any objective changes. Send or clear any unsent Message. Select Propose configuration when the family is confirmed and assay data is present. The assistant prepares and saves a draft for you to review.
- If a question appears, supply the missing facts and select Answer and continue preparation. That answer continues the requested preparation and may save the draft. To discuss alternatives or change inputs first, select Pause preparation. Do not invent missing concentrations, units or procedure details just to proceed.
- When the editor opens, inspect the saved configuration and its evidence. Use Back and Continue to review source selection, mapping, model, units, dilutions, transforms, weighting and suitability settings. Check cited material and assumptions against your actual procedure. A saved proposal is ready for your review; it is not an approved scientific method.
Recognize the result
When the proposal is ready, it opens in the analysis editor. You can check and edit the settings, read their sources and see whether your changes have saved. The analysis has not run yet.
You can edit manually or describe a change and select Update configuration in the editor. Send still requests discussion. Review the resulting settings and any unsaved edits before choosing Run analysis. Running, interpreting results and retrieving reports are separate tasks.
Change the objective or family
Before a proposal is saved, edit Analysis objective and choose Save objective, or choose Discard objective changes. Saving an objective change keeps files and context but clears earlier proposed settings and questions.
To change family, use Current analysis brief: select Change family, choose New analysis family, then select Change analysis family. Your conversation and files remain available. Earlier proposed settings and pending questions are cleared, so request Propose configuration again. A previously saved analysis and its results stay unchanged; the new proposal creates a separate draft.
Recover when you cannot continue
If Propose configuration is unavailable, confirm the family, add assay data, finish or clear selected inputs, save or discard objective edits, and send or clear your message. An active preparation must be answered, resumed or paused before starting another.
If the response is interrupted, use Check same request when shown. This checks whether your original request finished and saved a draft. Use Open saved analysis when offered. Do not repeatedly submit a new proposal to recover an uncertain request. Other displayed recovery controls include Retry saved request and Reload conversation; follow the message beside them.
If a file cannot be read or used, read the message, correct the problem and add it again. For a scanned PDF, supply an appropriate text-based source or the necessary facts with a clear basis. Do not assume unreadable evidence informed the proposal.
If assistance is unavailable, check that you are in an active Team with a role that can create drafts. Contact the Team owner for access problems. To proceed manually, confirm a family and choose Configure manually. Manual setup starts separately; saved conversation and files stay in the assisted setup, and unsaved text or unuploaded files are not transferred.
If the draft changes while an update is being prepared, review the latest saved settings and decide which edits to keep before requesting another update.
What to do next
Review the draft against your procedure before running it. Use the walkthroughs below to practice the same inputs with manual setup or assistance. For help with your workflow or documentation, contact Provenarium.
Edition and printing
Provenarium User Guide · PROV-USER-GUIDE · Edition 1
Published 2026-09-20
These instructions apply to the product releases listed below.
Applicable product releases: release-2026.09.20.1
Instructions checked: 2026-09-20 · Software revision cbee590c9fac5ff117db4333ffa0404e9d1d8082