Skip to main content

Pepkio Molarity Solution Calculator

Python client for the Pepkio Molarity Solution Calculator API: powder mass, single-step dilution volumes, and serial dilution tables with hydrate and purity correction from scripts or notebooks.

What It Does

Preparing solutions at a defined molarity is routine in molecular biology, biochemistry, and cell culture. Researchers weigh solid reagents for stock solutions, dilute concentrated stocks to working concentrations, and plan serial dilution series for standard curves or dose–response experiments.

Spreadsheets and generic molarity calculators often ignore hydrate water in salts (for example CuSO₄·5H₂O), supplier purity on the bottle, or unit conversions between mM and µM. That can lead to under-weighed powder and solutions below the intended concentration.

This package calls the same Pepkio Tools calculation engine as the hosted web application. Use PepkioClient.run() from Python, Jupyter, or automation pipelines to obtain grams to weigh, stock and diluent volumes, serial step tables, plain-language protocol steps, and shareable run links.

Programmatic runs require a network connection and a Pepkio API key. Calculations are not bundled for offline use.

Features

  • Three modes: powder (mass from solid), dilution (C₁V₁ = C₂V₂), serial (multi-step concentration table)
  • Powder mode: anhydrous molecular weight, hydrate notation (e.g. ·5H₂O), and purity percent; returns corrected mass and effective hydrated MW
  • Dilution mode: stock and target concentration (M, mM, uM, nM); stock volume, diluent volume, and dilution factor
  • Serial mode: step count, final volume per tube in µL, concentration and transfer/diluent volumes at each step
  • Plain-language protocol_steps with every run
  • Manifest and named examples: get_manifest, list_examples, get_example_input
  • CLI: pepkio-molarity-solution-calculator manifest and run
  • Configuration via PEPKIO_API_KEY and PEPKIO_API_BASE_URL

Installation

pip install pepkio-molarity-solution-calculator

Set an API key with tools:run scope before calling run():

export PEPKIO_API_KEY="your-key"

Create a key in your Pepkio account API keys settings.

Quick Example

from pepkio_molarity_solution_calculator import PepkioClient

with PepkioClient() as client:
    inp = client.get_example_input("powder_cuso4")
    result = client.run(inp)
    print(result.result["result"]["mass_display"])
    for step in result.result["protocol_steps"]:
        print(step)

CLI:

pepkio-molarity-solution-calculator run --example powder_cuso4

Manifest inspection does not require an API key.

Typical Use Cases

  • Weighing hydrated salts for stock solutions (for example CuSO₄·5H₂O at labeled purity)
  • Diluting concentrated buffers (for example 10× PBS to 1× in a defined final volume)
  • Quick serial dilution estimates (for example 1 M to 1 µM in four steps)
  • Cell culture media and reagent stock preparation
  • Standard curve and qPCR template dilution planning before bench work
  • Scripting repeatable solution prep in notebooks or lab automation pipelines

Scientific Background

To prepare a solution from solid: mass (g) = M × V (L) × MW (g/mol). For hydrated salts, use the effective molecular weight that includes crystal water. Adjust mass upward when bottle purity is below 100%.

For a single dilution, C₁V₁ = C₂V₂ relates stock concentration, final concentration, and volumes. Dilution factor DF = C_stock / C_final.

In serial dilution with constant ratio DF per step, concentration after n steps is Cₙ = C₀ / DFⁿ. The serial mode returns ideal transfer volumes; for pipette-aware rounding and plate maps, use the Pepkio Serial Dilution Planner web tool.

Web Application

For researchers who prefer a graphical interface, an interactive Molarity Solution Calculator is available in the browser.

The web interface adds live results as you type, saved recipes for buffers you prepare regularly, shareable links that restore inputs, one-click handoff from powder result to dilution tab, printable worksheets, and warnings when serial volumes are below practical pipetting limits (with a link to the Serial Dilution Planner).

Documentation and Resources

Source code and issue tracking: github.com/pepkio/pepkio-molarity-solution-calculator

Web application: pepkio.com/tools/molarity-solution-calculator

About Pepkio

Pepkio develops software tools and provides bioinformatics analysis services for life science research. See https://www.pepkio.com for additional tools and services.

Keywords

molarity calculator, molarity solution calculator, solution preparation calculator, powder to solution, mass from molarity, hydrate correction, hydrated salt molarity, purity correction, C1V1=C2V2, dilution calculator, stock dilution volume, dilution factor, buffer dilution, serial dilution calculator, mM to uM dilution, standard curve preparation, qPCR dilution, cell culture media preparation, laboratory protocol, effective molecular weight, pepkio-molarity-solution-calculator, Python molarity API, lab automation solution prep, how much powder to weigh for mM solution, molarity calculator with hydrate correction, adjust mass for reagent purity, how to dilute 10x buffer to 1x, calculate stock and diluent volumes, make CuSO4 5H2O stock solution, quick serial dilution 1 M to 1 uM, Python script calculate powder mass molarity, API for laboratory solution preparation, shareable link restore solution prep parameters, common mistakes weighing hydrated salts

Metadata

Release files for pepkio-molarity-solution-calculator 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pepkio-molarity-solution-calculator 0.1.0
File Size Uploaded Provenance
pepkio_molarity_solution_calculator-0.1.0.tar.gz 35.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for pepkio-molarity-solution-calculator 0.1.0
File Interpreter ABI Platform
pepkio_molarity_solution_calculator-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 44.9 kB

Release files / pepkio_molarity_solution_calculator-0.1.0.tar.gz

Download URL pepkio_molarity_solution_calculator-0.1.0.tar.gz
Size 35.3 kB
Tags Source
SHA-256 checksum
How to use checksums
2d9a519afca6c7e983c99f24566326d4edfb79b1790f5343ad3de2d818c4bcd3
BLAKE2b-256 checksum
How to use checksums
bcff0b722887b474fbd26da9037a60e2f9efb1ce6f1b6cbc1014c5761fbfe35b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / pepkio_molarity_solution_calculator-0.1.0-py3-none-any.whl

Download URL pepkio_molarity_solution_calculator-0.1.0-py3-none-any.whl
Size 9.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9d2211bd408103e619d3851f6412e3c7c006fe5ab928458f784a12acc1f13688
BLAKE2b-256 checksum
How to use checksums
0e3fc366c18f1d3aa31602b2a4020455625a91e23047d9f39f6327828c3a17fa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for pepkio-molarity-solution-calculator 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page