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

Module Interface Specification #29

Open
smiths opened this issue May 9, 2022 · 1 comment
Open

Module Interface Specification #29

smiths opened this issue May 9, 2022 · 1 comment
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@smiths
Copy link
Owner

smiths commented May 9, 2022

To understand the design we want to divide the system into modules (documented in the module guide #28) and we want to sketch out the interface for each module.

I have a template MIS, but I think this is too much work to begin with. All we need for each module is the following:

  • the type of module (record, library, abstract object, abstract data type, generic) (most of your modules will likely be abstract data types)
  • the list of access programs
  • the list state variables (sometimes this list is empty)
  • the list of environment variables (often empty, except for modules for input and output)
  • if the purpose of an access program won't be obvious from the name, a brief natural language description will help

We can follow the MIS Format I used in SE 2AA4.

Examples can be found in the SE 2AA4 notes for A2 and A3 each year. For instance, the chemistry example.

Another examples is the MIS for the solar water heating system and for the slope stability analysis program.

@EmilSoleymani
Copy link
Collaborator

First version of our MIS added in #59

@EmilSoleymani EmilSoleymani added the documentation Improvements or additions to documentation label May 18, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants