Skip to main content

Print pictures with living micro-organisms!

Project description

GitHub CI build status https://coveralls.io/repos/github/Edinburgh-Genome-Foundry/bioprinter/badge.svg?branch=master

Bioprinter (webpage here) is a Python package for producing living art. It transforms an image into files that a liquid dispenser can use to print the image to a plate using pigmented yeast or bacteria.

Here are two examples of bio-art:

https://raw.githubusercontent.com/Edinburgh-Genome-Foundry/bioprinter/master/docs/_static/images/bioprint_dolly.jpeg

Dolly drawn with baker yeast (white), violacein-producing yeast (black), and carotene-producing yeast (orange).

https://raw.githubusercontent.com/Edinburgh-Genome-Foundry/bioprinter/master/docs/_static/images/bioprint_england.jpeg

British flag drawn with 3 different strains of the bacterium E. coli.

These bio-prints (and many others!) were presented at the University of Edinburgh’s SynthSys Open days 2016 (strain selection and acoustic printing by Paulina Kanigowska).

Bioprinter is released on Github under the MIT license (Copyright 2015 Edinburgh Genome Foundry, University of Edinburgh), everyone is welcome to contribute!

Bioprinter was written at the Edinburgh Genome Foundry by Zulko after an original idea and Matlab code by Mike Shen (project on Github).

Installation

If you have PIP installed:

pip install bioprinter

Usage

The image file to be printed can have any resolution, but note that the width/height ratio of the plate the image is printed on is 1.5. Ensure that a specific color is used to mark the un-pigmented background of the image, here we use blue:

https://raw.githubusercontent.com/Edinburgh-Genome-Foundry/bioprinter/master/docs/_static/images/dolly.jpeg

Run the following code in Python or save in dolly.py:

from bioprinter import bioprint

bioprint(
    image_filename="/path/to/image/dolly.jpeg",
    output_filename="dolly.csv",
    bg_color=[0, 0, 255],  # blue background represents empty wells
    pigments_wells={"A1": [0, 0, 0],        # black yeast in source well A1
                    "A2": [250, 120, 10],   # orange yeast in well A2
                    "A3": [255, 255, 255]}, # white yeast in well A3
    quantified_image_filename="dolly_preview.jpeg"
)

The saved script can be executed in a terminal with python dolly.py. This will produce a dolly.csv file as well as a preview image of the final printing (so that you can check if the image looks good at this low resolution).

Prepare a source plate with the right pigmented yeasts in wells A1, A2, A3, use an agar plate as the destination plate, and feed dolly.csv to the Labcyte Echo Acoustic Liquid Handler (tested with Labcyte Echo 555 Series). Once the printing is finished, incubate 2 days at 30C (it would be one day at 37C for bacteria). Enjoy the result!

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

bioprinter-0.1.6.tar.gz (6.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bioprinter-0.1.6-py3-none-any.whl (8.0 kB view details)

Uploaded Python 3

File details

Details for the file bioprinter-0.1.6.tar.gz.

File metadata

  • Download URL: bioprinter-0.1.6.tar.gz
  • Upload date:
  • Size: 6.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for bioprinter-0.1.6.tar.gz
Algorithm Hash digest
SHA256 33bb717a87a7541eff7a767f515e6691dd7b5128f5837c594ac4ffe1c62f04e0
MD5 d35c6ad6e7b622212b8f8d9707b904fa
BLAKE2b-256 12b0848c0f6376007570466df35ebdcf0fe9ff05a9f0b95c28742d00f0d25684

See more details on using hashes here.

Provenance

The following attestation bundles were made for bioprinter-0.1.6.tar.gz:

Publisher: publish.yml on Edinburgh-Genome-Foundry/bioprinter

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file bioprinter-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: bioprinter-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 8.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for bioprinter-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 ed9d2bf963324573053093f6821d76a69787e2e7fe8e6eecf3012b11f258e1d9
MD5 43ed946f8fef0dda2b8a2a6bd9023060
BLAKE2b-256 a0cebfb4476c60a6fd932590d3d25c6e935b65ce774e072bc3b586b59ad0c21d

See more details on using hashes here.

Provenance

The following attestation bundles were made for bioprinter-0.1.6-py3-none-any.whl:

Publisher: publish.yml on Edinburgh-Genome-Foundry/bioprinter

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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