sciencii 0.1.5

ASCII art generator for science-themed visuals

Sciencii

A Python package that generates science-themed ASCII art — DNA helices, pipettes, periodic table element cards, test tubes, and molecule-style text captions.

PyPI: https://pypi.org/project/sciencii/

Team

• Ami
• Ethan
• Lily
• Luca
• Rohan

Installation

pip install sciencii

Usage

dna_helix(length)

Generates an ASCII DNA double helix. length is the number of 5-line cycles to repeat.

from sciencii import dna_helix

print(dna_helix(1))

O---o
 O-o
  O
 o-O
o---O

pipette(volume, max_volume)

Draws an ASCII pipette filled proportionally. volume is the current fill level, max_volume is the capacity.

from sciencii.pipette import pipette

print(pipette(5, 10))

        \   \-                                              
         \   \                                              
          \   \                                             
           \   \                                            
            \   \                                           
             \   \-                                         
              \   \                                         
               \   \                                        
                \   \                                       
                 \   \                                      
                  \~~~\-                                    
                   \~~~\                                    
                    \~~~\                                   
                     \~~~\                                  
                      \~~~\                                 
                       \~~~\-                               
                        \~~~\                               
                         \~~~\                              
                          \~~~\                             
                           \~~~\                            
                            \ \                             
                             \ \                            
                              \ \                           
                               \                            
                                \                           
                                 \                          
                                  \                         
                                   o                        

   5/10

get_element(name)

Looks up an element by name, symbol, or atomic number and shows its ASCII art card. Pass "table" for the full periodic table.

import sciencii.periodic_table as periodic_table

periodic_table.get_element("He")

+------------+
|  2         |
|     He     |
|   Helium   |
|   4.0026   |
+------------+

periodic_table.get_element(79)

+------------+
| 79         |
|     Au     |
|    Gold    |
|   196.97   |
+------------+

periodic_table.get_element("table")

Calling periodic_table.get_element("table") prints the full ASCII periodic table.

molecule_caption(text, style)

Draws text in a science-themed ASCII style. style can be "flask", "beaker", "atom", or "bond".

from sciencii.molecule_caption import molecule_caption

print(molecule_caption("H2O", "flask"))
print(molecule_caption("NaCl", "beaker"))
print(molecule_caption("Fe", "atom"))
print(molecule_caption("CO2", "bond"))

   ||
   ||
  /  \
 /    \
/  H2O  \
+-------+

+--------+
|        |)
|  NaCl  |
|        |
+--------+

 .------.
({  Fe  })
 '------'
  ~~~~~~

[C]-[O]=[2]

test_tube(fill_level, label)

Draws an ASCII test tube filled proportionally. fill_level is a number from 0 to 100 representing the percentage filled, and label is a string displayed below the tube.

from sciencii import test_tube

print(test_tube(75, "Sample A"))

|   |
|   |
|   |
|###|
|###|
|###|
|###|
|###|
|###|
|###|
|___|
Sample A

Example Program

See example.py for a runnable program that demonstrates every function.

python example.py

For Developers

Setup

Requires Python 3.9+ and pipenv (pip install pipenv).

git clone https://github.com/swe-students-spring2026/3-package-red_panda.git
cd 3-package-red_panda
pipenv install --dev

Run tests

pipenv run pytest

Build the package

pipenv run python -m build

Environment variables

No .env file or secret credentials are required to run or test this project.