Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Propose some data structures for scattering model data #35

Open
gavinmacaulay opened this issue Jan 12, 2025 · 0 comments
Open

Propose some data structures for scattering model data #35

gavinmacaulay opened this issue Jan 12, 2025 · 0 comments
Labels
help wanted Extra attention is needed

Comments

@gavinmacaulay
Copy link
Collaborator

One of echoSMs objectives is to encourage the use of common data structures (and perhaps file formats) for organism shapes and properties. The aim is to make it easier to use (and reuse) organism data across multiple models and implementations.

Currently, echoSMs uses:

  • TOML-formatted files for:

    • Body shapes for the KRM model
    • Body shapes for the DWBA and SDWBA models
    • Benchmark model parameters given in the Jech et al paper
  • STL-formatted files for triangular surface meshes

  • CSV-formatted files for:

    • Model results for the Jech et al benchmarks
    • Model results for various KRM and DWBA test models

Previous examples of fisheries acoustics file formats indicate that specifying a data structure rather than a file format is a better long-term solution as it gives greater flexibility and ability to adapt to new file formats and to accommodate the varying requirements of institutional data policies and preferences.

Developing a data structure then requires information on:

  • the data required to run scattering models
  • whether storage of raw organism shape data is necessary (e.g., x-ray data)
  • metadata required to understand the model data (e.g., units, coordinate conventions, data source, attributions, etc)
  • relevant relationships between these data

File formats that can readily store proposed data structures should be kept in mind and examples provided. Use of existing file and data formats should be preferred over developing new ones (this significantly reduces the effort required to use those formats in programming languages).

@gavinmacaulay gavinmacaulay added the help wanted Extra attention is needed label Jan 12, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted Extra attention is needed
Projects
None yet
Development

No branches or pull requests

1 participant