This is a collection of "quality of life" improvements for using the Python client for the Model Management System (MMS).
The purpose of the MMS-Python adapter is to wrap the complex REST API functions into easy to use Python functions allowing users to interact with a system model in a familiar tool. Access to model elements can allow users to run analyses or even model in Python.
Initializing a project object allows the user to set the server, reference ID, and project ID then run methods on that project.
This method prompts for the users MMS credentials (username/password) then requests and stores a ticket to allow the user to run operations without having to log in constantly. Note the username and password are destryed once the ticket is retrived.
This function clears any stored tickets.
This function returns True if the user is logged in and False otherwise.
Returns an Element() object (defined in the MMS client) with the given ID. This is a dictionary
of the attributes of the retrived element and can be used to get the elements name, ID,
documentation, etc. The depth parameter is an optional input and its default value is set to '0'.
Note: depth= -1
is the same as recurse=true
Sets the given elements documentation to content.
Sets the given elements name to name.
Posts a table to the given elements documentation. Here, table should be an HTML table.
Sets the given elements default value to content. Note, content must be JSON which contatins all appropriate fields for default value (not just the one to be updated).
for pip: pip install mms-python-adapter
Ensure Conda is updated to its latest version on the BASE environment in order to prevent dependency discrepancies. Enter via terminal:
conda update conda -y
The mms-python-adapter conda package will be on conda-forge. In order to pull and install the package onto a desired platform, such as JupyterLabs, first add the channel via Terminal:
conda config --add channels conda-forge
After the channel has been added, install the mms-python-adapter package with:
conda install mms-python-adapter -y
Within your python script, import the adapter with:
from mms_python_adapter import MMSAdapter
Note: Although the package is named "mms-python-adapter", the base script is "adapter," and the actual functions are called through the "Adapter" class.
Finally, the Adapter is initialized with:
- Server
- ProjectID
- RefID
adap = MMSAdapter(server, projectID, refID)
The functions are listed above under "Classes."