search

rom-py / rompy

Relocatable Ocean Modelling in PYthon (rompy) combines templated cookie-cutter model configuration with various xarray extensions to assist in the setup and evaluation of coastal ocean model
https://rom-py.github.io/rompy/
BSD 3-Clause "New" or "Revised" License
2 stars 9 forks source link

Add Entity relationship diagrams to assist in understanding object model #38

Open pbranson opened 1 year ago

pbranson commented 1 year ago

Suggestion to use erdantic: https://erdantic.drivendata.org/stable/ to generate relationship diagrams for inclusion in the docs - probably buried a little under the API documentation.

Example from erdantic docs:

import erdantic as erd
from erdantic.examples.pydantic import Party

# Easy one-liner
erd.draw(Party, out="diagram.png")

# Or create a diagram object that you can inspect and do stuff with
diagram = erd.create(Party)
diagram.models
#> [PydanticModel(Adventurer), PydanticModel(Party), PydanticModel(Quest), PydanticModel(QuestGiver)]
diagram.draw("diagram.png")