CATIA-Systems / FMPy

Simulate Functional Mockup Units (FMUs) in Python
Other
429 stars 118 forks source link

No API documentation #660

Open steve-biggs-fox opened 6 months ago

steve-biggs-fox commented 6 months ago

There is no API documentation. There is a basic tutorial that shows how to print FMU info, run it and plot the results, but that is all. For anything else, it just says to see the examples. Really, this needs API documentation to say what functions are available, how to call them, what is returned, etc. For example, how do I run an FMU with non-default parameters? What is this SimulationResult object that is returned? How do I access specific output variables? etc. Sure, I might be able to work it out from the examples, but that is long and annoying. API documentation would get straight to the point. And sure, I can type help(function_name), but then I have to use auto-complete to see what's available, remember where all the different functions are, etc. which is difficult when you're new to a package. API documentation would provide an overview of everything for reference while learning. Plus, I think it would be easy to create since you already have the docstrings - you just need a package to parse that and auto-generate the docs (many such packages exist). Please consider creating API documentation. Thank you

Other than that, from what I've seen so far, this seems like a great package, so thanks for creating it :)