Data

Tools

Indexes

Applications

Experiments

Open Source Science

textomos

Automated generation of synthetic tomograms of woven composite materials.

https://github.com/johan-friemann/textomos

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 (11.7%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

Automated generation of synthetic tomograms of woven composite materials.

Basic Info
  • Host: GitHub
  • Owner: Johan-Friemann
  • License: bsd-3-clause
  • Language: Python
  • Default Branch: main
  • Size: 267 KB
Statistics
  • Stars: 1
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created about 2 years ago · Last pushed 7 months ago
Metadata Files
Readme License Citation

README.md

textomos

Automated generation of synthetic labeled tomograms of woven composite materials. The pipeline is primarily based on TexGen and gVirtualXray. The name TexTomoS is a portmanteau of Textile, Tomography, and Segmentation.

Requirements

This software requires an NVidia GPU, Docker, and the NVidia container toolkit to run as intended. It is definitely possible to run without an NVidia GPU, and without using a container, but this requires the installation of several dependencies manually. This is not recommended and is not documented.

Installation

Clone the repo, navigate to the repository root directory, and run docker compose up. This will pull the required docker base image and install or build all dependencies. When the container is finished building, an X-terminal will be launched.

Basic usage

To test the entire data generation pipeline: inside the X-terminal execute python3 ./textomos/main.py. Note that the textile generation step takes a while. For a custom simulation create an input json file inside /textomos inputs that for example is called my_input.json and run python3 ./textomos/main.py ./textomos/inputs/my_input.json.

Batch run

If you want to create a large dataset you can use the batch run shell script. Inside the X-terminal run bash ./textomos/batch_run.sh -b [BATCH] -p [NUM_PROC] -s [CHUNK] [PATH] [NUM]. [PATH] is the path to a directory where you want the data to be saved to, and [NUM] is the requested number of data points. [BATCH] is the path to the base configuarations, [NUM_PROC] is the number of parallel processes that are allowed (currently only textile geometry generation is parallelized), and [CHUNK] is the number of data points per file that will be saved in the database. All the dash flags are optional and will default to the base input, 10 processes, and a chunk size of 20.

Owner

  • Name: Johan Friemann
  • Login: Johan-Friemann
  • Kind: user
  • Location: Gothenburg, Sweden
  • Company: Chalmers University of Technology

I'm a PhD student at the Division of Material and Computational Mechanics, Department of Industrial and Materials Science, Chalmers University of Technology

Citation (CITATION.cff) 

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: Textomos
message: >-
  Automated generation of synthetic tomograms of woven
  composite materials. 
type: software
authors:
  - given-names: Johan
    family-names: Friemann
    email: johan.friemann@chalmers.se
    affiliation: Chalmers University of Technology
    orcid: 'https://orcid.org/0000-0002-5697-7916'
repository-code: 'https://github.com/Johan-Friemann/textomos'
abstract: >-
  Automated generation of synthetic labeled tomograms of
  woven composite materials. The pipeline is primarily based
  on TexGen and gVirtualXray. The name TexTomoS is a
  portmanteau of Textile, Tomography, and Segmentation.
keywords:
  - Computed Tomography
  - Segmentation
  - 3D-textile
  - Carbon Fiber Reinforced Composites
  - Simulation
license: BSD-3-Clause

GitHub Events

Total
  • Watch event: 3
  • Delete event: 6
  • Push event: 7
  • Pull request event: 8
  • Fork event: 1
  • Create event: 4
Last Year
  • Watch event: 3
  • Delete event: 6
  • Push event: 7
  • Pull request event: 8
  • Fork event: 1
  • Create event: 4