diff options
author | Spartan322 <Megacake1234@gmail.com> | 2023-10-20 14:04:07 +0200 |
---|---|---|
committer | Spartan322 <Megacake1234@gmail.com> | 2023-10-20 15:42:39 +0200 |
commit | 20390a79dc35dd3990929e481cf39436c52180bc (patch) | |
tree | cf893bfaaf9668110ebf8c3e069af432f608cc42 | |
parent | 910d6cd73d7b1857ff481e1af060e780ec27d800 (diff) |
Add basic README.md
-rw-r--r-- | README.md | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..a2bc33b --- /dev/null +++ b/README.md @@ -0,0 +1,23 @@ +# OpenVic-Simulation +Repo of the OpenVic-Simulation Library for [OpenVic](https://github.com/OpenVicProject/OpenVic) + +## Quickstart Guide +For detailed instructions, view the OpenVic Contributor Quickstart Guide [here](https://github.com/OpenVicProject/OpenVic/blob/master/docs/contribution-quickstart-guide.md) + +## Required +* [scons](https://scons.org/) + +## Build Instructions +1. Install [scons](https://scons.org/) for your system. +2. Run the command `git submodule update --init --recursive` to retrieve all related submodules. +3. Run `scons` in the project root, you should see a openvic-simulation.headless file in `bin`. + +## Link Instructions +1. Call `ovsim_env = SConscript("openvic-simulation/SConstruct")` +2. Use the values stored in the `ovsim_env.openvic_simulation` to link and compile against: + +| Variable Name | Description | Correlated ENV variable | +| --- | --- | --- | +| `LIBPATH` | Library path list | `env["LIBPATH"]` | +| `LIBS` | Library files names in the library paths | `env["LIBS"]` | +| `INCPATH` | Library include files | `env["CPPPATH"]` | |