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

Add COBRArrow MATLAB API Tutorial #208

Merged
merged 1 commit into from
Oct 6, 2024

Conversation

fernweh-3
Copy link
Contributor

Description:

This PR introduces a comprehensive tutorial for the COBRArrow MATLAB API. The tutorial is designed to guide users through the key functionalities of COBRArrow, including environment setup, sending models to a remote server, fetching models, persisting models to a database, and optimizing models.

Key Sections Covered:

  1. Introduction:

    • Provides an overview of COBRArrow and its purpose in handling large-scale biochemical reaction models through remote procedure calls (RPC).
  2. Step 1: Environment Setup:

    • Detailed instructions for ensuring that MATLAB, Python, and the COBRA Toolbox are properly installed and configured.
    • Specific guidance on Python compatibility with MATLAB, with links to relevant MathWorks documentation.
  3. Step 2: Setting Up COBRArrow:

    • Instructions on initializing COBRArrow within MATLAB, including how to establish a connection to a remote server.
  4. Step 3: Sending and Optimizing a Model:

    • Demonstrates how to load a model, send it to the remote server, and run optimizations using remote resources.
    • Includes examples of setting solver parameters and handling potential errors, such as overwriting existing models on the server.
  5. Additional Methods:

    • Explains how to fetch models and specific fields from the server, persist models to a database, and list flight information on the server.
  6. Troubleshooting:

    • Provides common troubleshooting steps for issues related to sending models, running optimizations, and ensuring compatibility.
  7. Acknowledgments:

    • Notes on current limitations, such as the lack of support for parameter changes in the remote optimization service, and the importance of persisting models to prevent data loss.

Reviewers:

Please review the tutorial for:

  • Clarity and completeness of the instructions.
  • Accuracy of the examples provided.
  • Usability of the script as a learning tool for new users of COBRArrow.

Feedback on improving the tutorial content or identifying any gaps is welcome.

@rmtfleming rmtfleming merged commit 3ceafa0 into opencobra:develop Oct 6, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants