Skip to main content

For easily making chemical buffers and solutions

Project description

Welcome to buf!

Buf is a command line based toolkit for making chemical buffers/solutions. Tired of calculating how much of each chemical you need to add when making solutions? Buf can help. Specifically, buf:

  1. Allows you to develop a chemical library, saving the molar masses of frequently used chemicals.

  2. Allows you to use those chemicals to define recipes for your buffers/solutions, in which you specify the concentration of each ingredient required to make the buffer.

  3. Will ‘make’ those recipes for you, calculating how much of each ingredient you require to produce the volume of solution you specify.

For more information, visit buf’s homepage.

Installation

To install the buf toolkit, simply use pip install buf.

Getting Started

To introduce you to buf, let’s imagine that we want to make a solution containing 50mM NaCl, is 10% glycerol by volume, and contains a constant 5g of KCl, regardless of the volume of our solution. We want to make 5L of this solution.

Developing Our Chemical Library

In our recipe, we specify the concentration of NaCl with molarity. Before buf can calculate the mass of NaCl we will need to add to our buffer when we make it, we must first tell buf the molar mass of NaCl (58.44 g/mol) by adding the chemical to our library. This can be done with buf chemical -a 58.44 NaCl. We don’t need to tell buf about the molar masses of glycerol or KCl, since the amounts of those chemicals we will add to our buffer aren’t dependent on their molar masses.

Defining Our Recipe

Now that our chemical library has been defined, it is time to do the same with our recipe library. Here we will tell buf what we want to make. We define our recipe by giving it a name and listing its contents, using buf recipe -a best_recipe 50mM NaCl 10% glycerol 5g KCl. Now buf knows the ingredients of our solution; it’s finally time to make it!

Making Our Solution

To calculate how much of each chemical we’ll need for our 5L solution, all we need to use is buf make 5L best_recipe. Buf will use our stored chemical and recipe libraries to calculate the required amounts of each ingredient, and display the results.

Learning More

This tutorial only provides a brief overview of buf; for more details about the toolkit’s usage and functionality, see buf help. For specific information about a subcommand, see buf help <subcommand_name>. Alternatively, visit buf’s online documentation on Read the Docs here. You can also access the toolkit’s GitHub repository. Happy buffer making!

Version History

  • 1.0.0: Creation of documentation on Read the Docs! Repository commented and published on GitHub.

  • 1.0.0a11: Fixing README format.

  • 1.0.0a10: Deleting old buf/library directory (since library files are now stored outside the package), updating README to describe new changes.

  • 1.0.0a9: Chemical/recipe libraries no longer reset when upgrading the package. To those using older versions of buf who want to copy their libraries before upgrading, the library files can be accessed in the buf/library directory.

  • 1.0.0a8: Bug fixes.

  • 1.0.0a7: Improved documentation.

  • 1.0.0a6: First release to PyPI proper.

  • 1.0.0a1: First release of buf to Test PyPI!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

buf-1.0.0.tar.gz (17.2 kB view details)

Uploaded Source

Built Distribution

buf-1.0.0-py3-none-any.whl (20.6 kB view details)

Uploaded Python 3

File details

Details for the file buf-1.0.0.tar.gz.

File metadata

  • Download URL: buf-1.0.0.tar.gz
  • Upload date:
  • Size: 17.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.12.4 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.23.0 CPython/3.6.0

File hashes

Hashes for buf-1.0.0.tar.gz
Algorithm Hash digest
SHA256 b46b755d5d90ea9f1fa9584f7dc3665e75d635c099b1573a343786968515b94f
MD5 e2c8149455e117cde0a38b40e7f222cf
BLAKE2b-256 aed158bdc6fedba2f9347bdecc02c9b6511a3e4d9e06e5c28e3bf81fafe32963

See more details on using hashes here.

File details

Details for the file buf-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: buf-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 20.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.12.4 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.23.0 CPython/3.6.0

File hashes

Hashes for buf-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a066e6619c6fc23794bbd8055fe8aa800a3265956db5f496849d3d3e04fb4b51
MD5 42c0f2bfc8fc904faab3fe6831e1dea9
BLAKE2b-256 e02eb034a5e5d2009f866ac52982ce1732b373bc3e816d56ed804394699955ba

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page