Official Documentation • Reproducible Workflows

Bernoullli Documentation

A practical guide to connecting data, exploring trends conversationally, configuring statistical blueprints, selecting execution modes, and exporting reproducible research outputs.

Foundations

Product Identity & Positioning

Bernoullli is an AI-assisted statistical research copilot designed to help students, academic researchers, and quantitative analysts conduct methodologically sound data analyses.

📌 What Bernoullli Is — and What It Is Not

  • Bernoullli IS: A statistical assistant that inspects dataset structure, explores patterns conversationally, formulates explicit blueprints, runs reproducible R code, reports assumption diagnostics, and formats structured statistical reports.
  • Bernoullli IS NOT a thesis writer: It does not generate entire dissertation chapters, fabricate literature reviews, or replace scholarly critical thinking. The researcher retains full intellectual ownership, authorship, and responsibility for defending their results.
  • No LLM Math Hallucinations: Standard language models frequently invent p-values or approximate arithmetic. In Bernoullli, reasoning guides strategy, but all calculations are performed by an actual statistical runtime in R.
Workflow

The End-to-End Workflow

A typical research session moves cleanly through four sequential stages:

1

Connect & Audit Data

Upload your CSV dataset. Bernoullli reviews column types, missing value distribution, and basic sample properties.

2

Brainstorm & Explore

Ask exploratory questions, inspect distributions, review summary tables, and examine generated charts conversationally.

3

Formulate & Approve Blueprint

Define hypotheses, select target variables, and choose your preferred execution mode (e.g. Check & Run vs Run Analysis).

4

Execute & Export

Execute models in the R sandbox, review diagnostic plots and tables, and export the formatted Word report and standalone R code.

Input Requirements

Data Formats & Structuring

Clean data inputs prevent computational failures and mathematical singularities. Follow these practical structuring principles:

Supported Input File Format:

Comma-Separated Values (.csv). Ensure UTF-8 character encoding to preserve scientific symbols and special characters.

Dataset Hygiene Checklist:

  • Tidy Structure: Each column represents a single variable; each row represents a single subject or observation.
  • Single Header Row: Column names must appear strictly on Row 1. Do not use merged header rows or subtitle banners.
  • Clear Column Names: Use alphanumeric snake_case (e.g. plant_height_cm, water_treatment). Avoid punctuation (# % $ / ), spaces, or leading numbers.
  • Missing Values: Represent missing values consistently with empty cells or NA. Avoid mixing placeholder strings (such as "missing", "N/A", "999", or "-").
Exploration

Conversational Brainstorming Mode

Before committing to a formal statistical test, researchers often need to understand empirical distributions and relationships. In Brainstorming Mode, you can interact with your dataset conversationally:

Ask Data Questions

Inquire about subgroup means, medians, dispersion, variable counts, or potential imbalances across categories.

Instant Exploratory Visuals

Request preliminary scatterplots, frequency histograms, or interaction bar plots rendered directly in the chat.

Shape Hypotheses

Refine your research question before formalizing the mathematical model equation in the blueprint.

Pre-Execution Contract

The Statistical Blueprint

A core innovation of Bernoullli is the Statistical Blueprint. Rather than executing an opaque analysis immediately, Bernoullli generates an explicit methodological specification for you to review and approve:

Components of a Bernoullli Blueprint:

1. Research Objectives & Hypotheses:

States formal Null ($H_0$) and Alternative ($H_1$) hypotheses aligned with your study goals.

2. Variable Factor Mapping:

Explicitly assigns Dependent ($Y$), Independent ($X$), Covariates, or Blocking factors.

3. Mathematical Model Formula:

Displays the exact R formula (e.g. Plant_Height ~ Variety * Water_Regime).

4. Assumption Check Matrix:

Outlines specific statistical tests planned to verify the validity of the model.

Blueprints can be saved to your Blueprint Library, cloned for related experiments, or modified before execution.

Execution Flexibility

The 4 Execution Modes

Different research stages require different levels of diagnostic rigor. Bernoullli provides four distinct execution modes:

Check & Run

Recommended Default Mode

Conducts formal assumption diagnostics (normality, homoscedasticity, multicollinearity) first. If assumptions hold, it executes the primary inferential model. If violations occur, it highlights them in the report and presents relevant caveats or non-parametric alternatives.

Run Analysis

Direct Computation Mode

Executes the primary statistical model directly without executing the preliminary diagnostic test suite. Useful when you have already validated assumptions independently or are reproducing established literature benchmarks.

Check Assumption Only

Diagnostic-Only Mode

Runs the verification suite exclusively (Shapiro-Wilk tests, Levene's tests, Q-Q plots, residual plots, VIF scores). Outputs diagnostic conclusions without running the main inferential hypothesis test.

Check Structural Only

Design & Pre-Flight Verification Mode

Verifies structural balance, cell counts per factor level, presence of empty cells, degrees of freedom adequacy, and absence of rank-deficient columns prior to analytical execution.

Methodology Reference

Supported Statistical Methods

Bernoullli executes standard mathematical algorithms from peer-reviewed R libraries. Results report test statistics, p-values, degrees of freedom, and relevant effect sizes:

Category Statistical Method R Engine / Function Primary Outputs
Comparison of Means Two-Sample Independent t-test / Welch's t-test stats::t.test() $t$-statistic, $df$, $p$-value, mean difference, 95% CI
Paired Measurements Paired-Samples t-test / Wilcoxon Signed-Rank t.test(paired = TRUE) Mean difference, $t$-stat, $p$-value / $W$-statistic
Factorial Experiments One-Way & Multi-Way Factorial ANOVA stats::aov(), car::Anova() $F$-ratio, Sum of Squares, $df$, $p$-value, $eta^2$ effect size
Non-Parametric Mann-Whitney U / Kruskal-Wallis wilcox.test(), kruskal.test() Rank sums, $U$-statistic / $H$-statistic, asymptotic $p$-value
Post-Hoc Comparisons Tukey HSD / Bonferroni / Benjamini-Hochberg emmeans::emmeans() Estimated marginal means, adjusted $p$-values, contrast estimates
Linear Relationships Simple & Multiple OLS Linear Regression stats::lm() Coefficients ($eta$), standard errors, $R^2$, Adj $R^2$, $F$-model
Correlation Pearson ($r$) & Spearman ($ ho$) Correlation stats::cor.test() Correlation coefficient, 95% CI, significance level
Time Trends Autoregressive Integrated Moving Average (ARIMA) forecast::auto.arima() Model orders $(p,d,q)$, AIC/BIC information criteria, residual ACF
Rigorous Verification

Assumption Diagnostics Suite

When executing in Check & Run or Check Assumption Only modes, Bernoullli evaluates the underlying mathematical assumptions governing your model:

1. Distributional Normality

Evaluated using the Shapiro-Wilk test alongside empirical Quantile-Quantile (Q-Q) plots. Note that a non-significant result ($p > 0.05$) indicates insufficient evidence to reject normality, rather than mathematical proof of a normal distribution. For small samples exhibiting marked skewness, non-parametric alternatives or power transformations are suggested.

2. Homogeneity of Variance (Homoscedasticity)

Tested across groups using Levene's test (median-centered for robustness against non-normality). If variances differ significantly across groups, Welch's correction is applied to protect against inflated Type I error rates.

3. Multicollinearity in Regression

For multi-predictor linear models, Bernoullli computes the Variance Inflation Factor (VIF). Predictors with $ ext{VIF} > 5.0$ are flagged for potential collinear redundancy, which can artificially inflate coefficient standard errors.

4. Influential Outliers & Leverage

Diagnostic residuals and Cook's Distance are plotted to help researchers identify potential data entry errors or highly influential points that unduly pull regression slopes.

Visual Accessibility

Accessible Color & Scientific Charts

Bernoullli adopts research-oriented visualization practices designed for accessibility and clarity:

The Okabe–Ito Categorical Palette:

Color-vision deficiencies affect ~8% of men and 0.5% of women. Bernoullli employs the scientific Okabe–Ito palette as its default for discrete comparative groups:

Orange

#E69F00

Blue

#0072B2

Bluish Green

#009E73

Reddish Purple

#CC79A7

No Red–Green Treatment Pairings: Red and green collapse into indistinguishable tones under deuteranopia and protanopia. Bernoullli assigns distinct, distinguishable colors consistently across all figures in a session.

Canvas & Formatting Integrity:

  • Solid White Canvas: Plots are always rendered with opaque white backgrounds (bg = 'white') to prevent transparent image inversion when viewed in Microsoft Word Dark Mode.
  • Solid Baseline Axes: Coordinate boundaries feature clean, dark baseline axes (#1e293b) to ground the visual data.
  • Clear Error Bar Specifications: Charts explicitly declare whether error bars represent Standard Error ($Mean pm 1 SE$), Standard Deviation ($Mean pm 1 SD$), or 95% Confidence Intervals.
Outputs

Word Report & R Code Export

Bernoullli analyses produce transparent research deliverables:

Structured Word (.docx) Report

Formatted statistical document with analytical summaries, model equations, assumption check outcomes, APA-styled tables, and embedded high-resolution figures.

Reproducible R Script (.R)

Standalone R script containing data loading steps, factor level encodings, model calls, and diagnostic code that you can inspect, edit, and run directly in your own RStudio environment.

Ethics & Authorship

Academic Integrity & Authorship

User Responsibility & Academic Judgment:

Bernoullli assists in computing statistical models and evaluating mathematical assumptions, but it does not replace scientific expertise or domain judgment:

  • Authorship: You are the author of your research. You must verify that the chosen statistical methodology appropriately addresses your research question.
  • Data Accuracy: Bernoullli computes results based on the data you supply. Erroneous data inputs or improperly measured variables will yield mathematically valid but substantively meaningless conclusions.
  • Institutional Compliance: Ensure your use of statistical software tools complies with your department's thesis guidelines and journal disclosure requirements.
Common Questions

Frequently Asked Questions

Does Bernoullli write my thesis or research paper for me?

No. Bernoullli is an analytical assistant. It executes statistical calculations, checks diagnostic assumptions, formats tables, and drafts structured results descriptions. You must review, contextualize, and integrate these results into your overall thesis or manuscript.

What is the difference between "Run Analysis" and "Check & Run"?

Run Analysis executes the statistical model directly without diagnostic checks. Check & Run conducts a formal verification of underlying statistical assumptions (e.g. normality, variance homogeneity) before estimating the model and reporting conclusions.

Can I review the R code that produced my results?

Yes. Standalone R scripts are provided for generated analyses, listing package dependencies, data transformations, and model syntax so you can inspect and reproduce every calculation independently.

How should I cite Bernoullli in my methods section?

You can state in your methodology:
Statistical analysis and assumption diagnostics were conducted using Bernoullli (v3.2, 2026), executing computational routines in R (stats, car, emmeans, ggplot2).

Start your analysis

Upload your CSV dataset and explore your data conversationally today.