develop #17

Merged
coryab merged 50 commits from develop into main 2024-01-02 12:33:12 +00:00
2 changed files with 98 additions and 1 deletions
Showing only changes of commit 80cd9b9a65 - Show all commits

View File

@ -511,7 +511,7 @@ EXTRACT_PRIVATE = YES
# methods of a class will be included in the documentation. # methods of a class will be included in the documentation.
# The default value is: NO. # 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 # If the EXTRACT_PACKAGE tag is set to YES, all members with package or internal
# scope will be included in the documentation. # scope will be included in the documentation.

View File

@ -1,3 +1,100 @@
# Simulating the Schrödinger wave equation using the Crank-Nicolson method in 2+1 dimensions # 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
./<bin|debug>/<program-name> <args>
```
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/<script-name>
```
If you have any problems running the scripts, you might have to run this instead:
```shell
python3 python_scripts/<script-name>
```
## Credits
The Doxygen theme used here is
[doxygen-awesome-css](https://github.com/jothepro/doxygen-awesome-css).