Data

Tools

Indexes

Applications

Experiments

Open Source Science

compomix

A lightweight composite property calculator using Halpin-Tsai and Kelly-Tyson models for mechanical analysis of fiber-reinforced materials.

https://github.com/sepehr-sohrabi/compomix

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ✓
    CITATION.cff file
    Found CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ○
    Academic email domains
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (10.9%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

A lightweight composite property calculator using Halpin-Tsai and Kelly-Tyson models for mechanical analysis of fiber-reinforced materials.

Basic Info
  • Host: GitHub
  • Owner: Sepehr-Sohrabi
  • License: mit
  • Language: Python
  • Default Branch: main
  • Size: 9.77 KB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created 9 months ago · Last pushed 9 months ago
Metadata Files
Readme License Citation

README.md

Compomix

Compomix is a Python tool that calculates and visualizes the mechanical properties of fiber-reinforced composites using the modified Halpin-Tsai and Kelly-Tyson models. It's designed with silk-PGA biocomposites in mind but can be easily adapted for other fiber/matrix combinations.

Features

  • Estimates effective elastic modulus with random orientation correction.
  • Computes tensile strength using Kelly-Tyson equation.
  • Includes critical length estimation.
  • Outputs Poisson’s ratio and density.
  • Generates two clean plots for analysis.

How it works

  1. Input Parameters

  2. You will be prompted to enter: -Start and end silk fiber volume fractions (%) -Step size -Fiber length (cm) -Fiber diameter (μm) -Orientation correction factor K_o (e.g., 0.3 for randomly oriented short fibers)

  3. Outputs

  4. You'll get: -Terminal table with modulus, strength, density, and Poisson’s ratio -Two interactive plots for visual analysis

Customization

If you want to use it for other materials, just replace the values under # --- Material Properties --- in compomix.py.

Dependencies

  1. Python 3.x
  2. matplotlib

License

This code is completely open-source. Use it. Modify it. Abuse it. No credit required :)

Citation

If you use Compomix in your work, please cite it using the metadata in the CITATION.cff file, or use the following format: Sohrabi, Sepehr. Compomix: A Micromechanical Composite Property Calculator (v1.0.0), 2025. GitHub repository: https://github.com/Sepehr-Sohrabi/Compomix

Author Sepehr Sohrabi – MSc student in Biomechanical Engineering.

How to Use

  1. Clone the repo ```bash git clone https://github.com/sepehr-sohrabi/Compomix.git cd Compomix

Owner

  • Name: Sepehr Sohrabi
  • Login: Sepehr-Sohrabi
  • Kind: user

M.Sc. Student, Biomechanics Iran University of Science and Technology, Tehran, Iran

Citation (CITATION.cff) 

cff-version: 1.2.0
message: "If you use Compomix in your research or project, please cite it using the following metadata."
title: "Compomix"
authors:
  - family-names: Sohrabi
    given-names: Sepehr
    orcid: https://orcid.org/0009-0006-3872-5543
date-released: 2025-05-20
version: 1.0.0
license: MIT
repository-code: https://github.com/YOUR_USERNAME/Compomix
url: https://github.com/Sepehr-Sohrabi/Compomix
type: software

GitHub Events

Total
  • Push event: 2
  • Create event: 2
Last Year
  • Push event: 2
  • Create event: 2