preservationeval 0.3.0

A Python implenentation of the calculations and evaluations done by the Dew Point Calculator found at https://www.dpcalc.org/.

preservationeval

A Python implenentation of the calculations and evaluations done by the Dew Point Calculator found at https://www.dpcalc.org/.

Details

The preservation evaluation code was taken from the Dew point calulator created by the Image Permanence Institute. For details of the calculations see:

• http://www.dpcalc.org/howtouse_step2.php
• http://www.dpcalc.org/dp.js

Installation

pip install preservationeval

Usage

Basic Examples

from preservationeval import pi, emc, mold

# Calculate Preservation Index
pi_value = pi(20, 50)  # temperature=20°C, RH=50%
print(f"Preservation Index: {pi_value}")

# Calculate EMC (Equilibrium Moisture Content)
emc_value = emc(20, 50)
print(f"EMC: {emc_value}%")

# Calculate Mold Risk
mold_risk = mold(20, 50)
print(f"Mold Risk: {mold_risk}")

Interpreting Restults

TBD

Development

Setup

# Clone the repository
git clone https://github.com/petter-b/preservationeval
cd preservationeval

# Install development dependencies
pip install -e ".[dev]"

Development Tools

• black: Code formatting
• ruff: Linting and code quality
• mypy: Static type checking
• pytest: Testing framework
• pre-commit: Git hooks for code quality

Common Tasks

# Format code
black .

# Run linter
ruff check .

# Type checking
mypy .

# Run tests with coverage
pytest --cov

Testing

Validation Testing

The package includes a validation framework that compares our Python implementation against the original JavaScript implementation from dpcalc.org.

Requirements

• Node.js and npm must be installed (download)
• Python test dependencies: pip install -e ".[test]"

Test Data Setup

The test framework automatically:

• Creates the tests/data directory (git-ignored)
• Downloads the JavaScript reference implementation
• Generates and saves test cases
• Caches results for future test runs

You can manually trigger this setup:

# Download JavaScript reference implementation
# This happens automatically when running tests, or manually:
python -m tests.validate_core

# Run all tests
pytest

# Run only validation tests
pytest tests/test_validation.py

# Run with verbose output
pytest -v tests/test_validation.py

# Generate new test cases (ignore cached)
pytest tests/test_validation.py --force-update

Code Quality

Automation

Development Notes

This project was developed with assistance from Claude AI (Anthropic) and to some extent GitHub Copilot. All code has been validated and tested for accuracy.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

See CHANGELOG.md for all changes and versioning details.