gcs is a Python library for creating generalized cylindrical shells (GCS).

GCS are parameterized by 11 values:

c4 and c8 Relationship

• Adopted from Overvelde and Bertoldi, 2014

twist_linear, twist_amplitude, and twist_cycles Relationship

Download

gcs requires Python version 3.8 (or higher). To install, run the command:

pip install gcs-shape

Requirements

• bentley-ottmann (version: 7.3.0)
• mapbox_earcut (version: 1.0.0 or higher)
• numpy (version: 1.21.5 or higher)
• numpy-stl (version: 2.17.1 or higher)
• pandas (version: 1.4.1 or higher)
• scipy (version: 1.7.3 or higher)

Supported Operating Systems

gcs is operating system independent. The package has been tested on the following operating systems:

• MacOS Ventura 13.4.1
• Ubuntu 22.04
• Windows 10

Quickstart

import gcs

# Create a generalized cylindrical shell
shape = gcs.GCS(c4_base=0.3,
                c8_base=-0.2,
                c4_top=0.4,
                c8_top=-0.3,
                twist_linear=2,
                twist_amplitude=0.05,
                twist_cycles=3,
                perimeter_ratio=1.5,
                height=20,
                mass=2.1,
                thickness=0.48)

# Assert the shape is valid
print(shape.valid)

# Save shape to STL file
gcs.io.save_mesh(file='shape.stl', shape=shape)

Contributing

The contribution guidelines can be found in CONTRIBUTING.md.

Maintainers

• Sam Silverman - sssilver@bu.edu

Citation

@misc{Snapp2023,
      title = {Autonomous Discovery of Tough Structures}, 
      author = {Kelsey L. Snapp and Benjamin Verdier and
               Aldair Gongora and Samuel Silverman and
               Adedire D. Adesiji and Elise F. Morgan and
               Timothy J. Lawton and Emily Whiting and
               Keith A. Brown},
      year={2023},
      eprint={2308.02315},
      archivePrefix={arXiv},
}