Transport Aircraft and the Environment System OPTimization (TASOPT) implemented in Julia. Originally based of Mark Drela's FORTRAN code of the same name.
The easiest way to run TASOPT.jl
would be to add the package using the julia package manager using the github repository.
You can do this by starting a Julia session and then activating the package manager by typing ]
and then entering:
pkg> add "git@github.mit.edu:LAE/TAESOPT.jl.git"
You can then import TASOPT
as you would with any Julia package:
julia> using TASOPT
If you are going to develop the source code of TASOPT.jl
you might benefit from a local clone of the git repository which
can then fit into a workflow using Revise.jl
for example.
Step 1: Clone the git repo locally
git clone git@github.com:MIT-LAE/TASOPT.jl.git
Step 2: cd
to the folder where TASOPT is cloned
Step 3: Use Pkg
to install/ develop the package
pkg> dev .
You should now be able to import TASOPT from within any Julia script in your base environment.
Note: If you clone another version of TASOPT, using TASOPT
will always use the directory where dev .
was used.
If you are using Revise.jl
be sure to first import Revise
before importing TASOPT
using Revise
using TASOPT
Important
Before submitting a new pull request (PR), go to the test
folder and run the tests by doing
using TASOPT, Pkg
Pkg.test("TASOPT")
If there is an error, it is your responsibility to edit your code and make it work. The PR will not be reviewed if the regression or unit test fails. If you find that the tests do not capture the right behavior or are flawed, please raise an issue.
Don't commit anything to the main branch. Here's how you create your own fork and branch.
First create a fork of this repo by clicking on "fork" on the top right hand of the github page. This creates a copy of this repo that is separate form this one. This ensures that any chagnes made to your fork will not affect other's forks.
You will now need to clone your forked version of the repo to your machine where you will be writing code. This page has a good overview of how to do this whole process.
After this I highly recommend using branches within your own fork and I prefer the git command line interface over the web interface.
Use this command to create a new branch for example dev_prash
git checkout -b <name_of_branch>
as you add files, use the following command to tell git to track your file
git add <path to file, or use . to track all files>
once you are happy with the edits you have made, you have to commit the edits by doing
git commit -a -m "COMMIT MESSAGE"
make your commit messages useful. These messages along with frequent commits will create a rich history to the repo so as this grows you will be able to track changes and debug more efficiently
After committing to your local machine, you need to push these changes to the remote github server. The first time you do this for each branch you need to tell the remote repo what to track
git push -u origin <name_of_branch>
for subsequent pushes, you only need to do git push
.
Keep syncing your fork to this repo regularly so that you have all the latest bug fixes and changes that others have done.
To sync your fork, cd
into the right folder on your terminal and do the following
git fetch upstream
This fetches all the changes made to the main repo. Then switch to your main branch (you should be working in branches even in your own repo)
git checkout main
Once you are in your main branch do:
git merge upstream/main
This brings your fork's main
branch into sync with the upstream repository, without losing your local changes.