From 80cd9b9a6503e5b8a9f0fdcc2cfb7986850e0286 Mon Sep 17 00:00:00 2001 From: Cory Date: Mon, 1 Jan 2024 15:56:51 +0100 Subject: [PATCH] Stuff --- Doxyfile | 2 +- README.md | 97 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 98 insertions(+), 1 deletion(-) diff --git a/Doxyfile b/Doxyfile index 21a8b6e..c59f28d 100644 --- a/Doxyfile +++ b/Doxyfile @@ -511,7 +511,7 @@ EXTRACT_PRIVATE = YES # methods of a class will be included in the documentation. # The default value is: NO. -EXTRACT_PRIV_VIRTUAL = NO +EXTRACT_PRIV_VIRTUAL = YES # If the EXTRACT_PACKAGE tag is set to YES, all members with package or internal # scope will be included in the documentation. diff --git a/README.md b/README.md index a0fa25f..62e9bb2 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,100 @@ # Simulating the Schrödinger wave equation using the Crank-Nicolson method in 2+1 dimensions +[Repo](https://github.uio.no/FYS3150-G2-2023/Project-5) +[Documentation](https://pages.github.uio.no/FYS3150-G2-2023/Project-5/) + +## Requirements + +### Operating systems + +- Linux + - Has been tested on [Fedora 38](https://fedoraproject.org/) + - Will most likely work on other Linux distributions +- macOS + - Will most likely not work due to the use of getopt, which is GNU specific. +- Windows + - Will most likely not work + +### Libraries + +- Python + - [matplotlib](https://matplotlib.org/) + - [numpy](https://numpy.org/) + - [seaborn](https://seaborn.pydata.org/) + +- C++ + - [Armadillo](https://arma.sourceforge.net/) + +## Compiling + +The commands shown here should be run from the root of this project. + +### Normal binaries + +Compiling regular binaries is as easy as running this command: + +```shell + make +``` + +The binaries will then be inside the **bin** directory. + +### Debugging binaries + +If you want to debug the code, then use this command: + +```shell + make debug +``` + +The binaries will then be inside the **debug** directory. + +## Running programs + +### C++ binaries + +To run any of the programs, just use the following command: + +```shell + .// +``` + +If you need help with any of the programs, you can use the **-h** or **--help** +flag to show you how to use the programs. Here is an example: + +```shell + ./bin/main --help +``` + +### Python scripts + +#### Install libraries + +Before running the scripts, make sure that all libraries are installed. +Using pip, you can install all requirements like this: + +```shell + pip install -r requirements.txt +``` + +This recursively install all the packages that are listed in **requirements.txt**. + +#### Running scripts + +For the Python scripts, run them from the root of the project: + +```shell + python python_scripts/ +``` + +If you have any problems running the scripts, you might have to run this instead: + +```shell + python3 python_scripts/ +``` + +## Credits + +The Doxygen theme used here is +[doxygen-awesome-css](https://github.com/jothepro/doxygen-awesome-css).