aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
author George L. Albany <Megacake1234@gmail.com>2023-07-28 01:01:41 +0200
committer GitHub <noreply@github.com>2023-07-28 01:01:41 +0200
commite941573f47fb867ff75c8a2cf78302b754ffbeee (patch)
tree806f6040d1d36e2be037967fbe330e3c9926513d
parent4ed1e471b318fe065964131bb44eb70d9363d701 (diff)
parent4302f0cfe2537ca39fb715044d69a92bd30c8a90 (diff)
Merge pull request #3 from OpenVicProject/add/a-readme
-rw-r--r--README.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b5cd108
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# OpenVic-Dataloader
+Repo for the OpenVic-Dataloader 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 build_ovdl_library=yes` in the project root, you should see a libopenvic-dataloader file in `bin`.
+
+## Link Instructions
+1. Call `ovdl_env = SConscript("openvic-dataloader/SConstruct")`
+2. Use the values stored in the `ovdl_env.openvic_dataloader` 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"]` |