onedani 0.1

A package to convert your Jupyter Notebook

onedani

This library facilitates educators to help students understand 1D wall conduction problems through a simple 1D visualization animation.

:package: Installation

pip install onedani

:rocket: How to use

You can build a simple animation with the following code:

from onedani import animation.onedproblem

# Setup the wall elments, by material, and thickness of each material
wall = onedproblem(
    ['plywood','rockwool','osb','airgap','plaster'],
    [0.01,0.1,0.012,0.02,0.02]
)
# You can set the time
wall.setup_grid(50,time=30,fps=60) # 30 seconds of 24fps
# Add probed to measure the temperature
wall.add_probe(x=sum([0.01,0.1,0.012]),type='Temp')
# Add probe to measure the heat flux
wall.add_probe(x=sum([0.01,0.03]),type='Heat')
# Run the 1D problem
wall.run_problem()
# Build the animation
wall.build_animation(scale="C",filename='animation_10.mp4')

:memo: Features

• Build animations based on simple materials.
• Specify animation length, we will ensure it will always reach steady state at the end of the time.
• Add temperature and heat flux probes to show the results on the animation.

:eyes: Watch out

• This package is build on a (very) simple numerical solver and schema, this means there will be some numerical error.
• This is especially true for heat probes:
  • it's reduced by increasing the number of x-nodes
  • or making sure the heat probe is somewhere in the center of a material.

:new: Versions

Version 0.1

• Initial public release, the students enjoyed seeing the temperature evolve through the wall.

:pray: Acknowledgement

I would like to the thank Dr. Ralph Evins from the Energy in Cities group for the opportunity to teach in his CIVE 295 - Building Science Fundamentals class. The problem here and the questions from the students resulted in me repurposing some code I made in my PhD to make this animation.