Skip to content

πŸš€ SFPPy - Python Framework for Food Contact Compliance & Risk Assessment 🍏⏩🍎

Choose a tag to compare

@ovitrac ovitrac released this 07 Mar 17:41
· 98 commits to main since this release

SFPPy v1.3 Releases 🍏⏩🍎


About SFPPy

SFPPy is a Python-based framework for π“Œ‰β—―π“‡‹ compliance testing of food contact materials and πŸŽ’βŒ¬β™»οΈ recycled plastic safety assessment. It supports regulations from:

  • πŸ‡ΊπŸ‡Έ US FDA regulations
  • πŸ‡ͺπŸ‡Ί European Union (EFSA, EU 10/2011, etc.)
  • πŸ‡¨πŸ‡³ Chinese GB standards
  • 🌍 Other international guidelines

πŸ“Œ SFPPy integrates well-established chemical migration models into Python, offering object-oriented and scalable capabilities. It includes a comprehensive collection of scenarios πŸ—ƒ for various applications.

πŸ”” Starting from version 1.3, the computational engine βš™οΈ automatically selects the best model πŸ€” to predict πŸͺ„ diffusivities and partitioning from molecular structures ⌬.

Diffusivity in polymer ($D$)
πŸŽοΈπŸ’¨, πŸš—πŸ’¨πŸ›»πŸ’¨πŸš›πŸ’¨
Henry-like coefficients ($k$):
Chemical affinity 🧲
πŸ“Œ Dpiringer - Legacy overestimation model (many polymersπŸ–‡, temperature effects🌑️) πŸ“Œ kFH - Flory-Huggins model for polymers and adhesives (many polymers πŸ–‡)
πŸ“Œ DFV - Hole Free-Volume model = Accurate for recycled plastics ♻️ and decontamination processes πŸ’¦ πŸ“Œ kFH - Flory-Huggins model for food simulantsπŸ₯« with entropic correction
πŸ“Œ Dwelle - Refined model for PET and PS above and below $T_g$ πŸ“Œ Combined rules considering texture effects 🍯

πŸš€ No Python Knowledge? No Problem! πŸ§‘β€πŸ”¬πŸ‘©β€πŸ”¬ SFPPy is designed for scientists, engineers, and food packaging experts without programming experience. You can simulate mass transfer or analyze results using πŸ”Ή simple commands and πŸ”Ή pre-built functions that handle complex calculations internally.


πŸ“¦ Download & Installation

SFPPy is available in two versions πŸ—œοΈ β”Š Compatible with πŸͺŸ Windows, 🐧 Linux, 🍎 macOS.

The light version does not include the private installation of Toxtree, which is used in patankar.loadpubchem.migrantToxtree for advanced risk assessment. However, patankar.loadpubchem.migrant remains fully functional for routine simulations.

If needed, Toxtree can be manually installed in patankar/private/toxtree/ as described in patankar/private/toxtree/README.md.

  • Full version 80 MB π“‹° Includes: πŸ§ͺ Toxtree βΊβ‚Š πŸ“š Full documentation
    πŸ“₯ Download SFPPy

  • Light version 17 MB π“‹° Includes: βΊβ‚Š πŸ“š Full documentation
    πŸ“₯ Download SFPPymin

❗ Toxtree requires a Java runtime environment (JRE) if Java β˜• is not already installed.


πŸ“‚ Example Files

SFPPy includes four example scripts to help you get started:

Example file (located in the root folder 🏠) Description (see πŸ” Wiki Pages)
example1.py Monolayer materials
example2.py Recycled bottles with functional barriers
example3.py Chained simulations with variations
example4.py Fitting experimental curves to extract diffusion and partition coefficients

✨ All scripts in the root folder 🏠 can be executed directly without modifying the Python path.
If running from another location, use the CLI:

sfppy example1.py  # Replace example1.py with your script

πŸ› οΈ Running SFPPy from Anywhere 🌐

To test releases effortlessly:

# Navigate to the extracted SFPPy folder
cd /path/to/SFPPy  # 🏠 Unzipped folder

# Install SFPPy in editable mode (dependencies included)
pip install -e .

# Run example1 from anywhere
sfppy example1.py  # Replace example1.py with your script

For detailed installation instructions, refer to the installation guide πŸ§‘β€πŸ”§.


πŸš€ Quick Start & Exploration

πŸ“š Read the Online Documentation:

πŸš€ Try SFPPy now and streamline your food safety assessments!


πŸ”— Additional Resources

πŸ“– Publication:
AIChE Journal - SFPPy Migration Modeling

πŸ“Œ GitHub Pages:
https://ovitrac.github.io/SFPPy/


🍏⏩🍎 SFPPy for Food Contact Compliance and Risk Assessment
*Contact* Olivier Vitrac *for questions |* Website *|* Documentation