Skip to content

opencobra/COBRA.tutorials

Repository files navigation

COBRA Tutorials

Tutorials are here to get you started with using The COBRA Toolbox. The tutorials are grouped according to the src/ folder structure:

All tutorials are provided in 4 formats: .mlx, .m, .pdf, and .html.

Contribute a new tutorial or modify an existing tutorial

A template for generating a new tutorial is provided here.

There are two ways to contribute to the tutorials:

A) Contribute using the MATLAB.devTools

You can use the MATLAB.devTools to submit your tutorial.

B) Contribute using git (via command line)

Fork and checkout your branch

  1. Fork the COBRA.tutorials repository on Github.

  2. Clone the forked repository to a directory of your choice:

    $ git clone [email protected]:<userName>/COBRA.tutorials.git fork-COBRA.tutorials.git
  3. Change to the directory:

    $ cd fork-COBRA.tutorials.git/
  4. Set the upstream to the opencobra/COBRA.tutorials repository:

    $ git remote add upstream [email protected]:opencobra/COBRA.tutorials.git
  5. Fetch from the upstream repository

    $ git fetch upstream
  6. Checkout a new branch from develop:

    $ git checkout -b <yourBranch> upstream/develop
  7. Now, make your changes in the tutorial in MATLAB.

Submit your changes and open a pull request

  1. Once you are done making changes, add the files to your branch, where tutorial_<yourFile> is the name of the tutorial. Make sure to add the .m and the .mlx files.

    $ git add tutorial_<yourFile>.m
    $ git add tutorial_<yourFile>.mlx
    $ git commit -m "Changes to tutorial_<yourFile>"
  2. Push your commits on <yourBranch> to your fork:

    $ git push origin <yourBranch>
  3. Browse to your fork on https://www.github.com/<yourUserName>/COBRA.tutorials, where <yourUserName> is your Github username.

  4. Click on Compare & Pull Request.

  5. Change the target branch develop.

  6. Submit your pull request.

  7. Wait until your pull request is accepted.