Downloads

For Windows 10/11, Linux distributions

Install Miniconda3 (docs.anaconda.com/miniconda/install) if not installed already. Select your operating system. Any other installation giving access to the latest conda version (e.g. Anaconda, miniforge, etc.) is also OK.
Install MikTeX (miktex.org/download) [Windows] or TeX Live (www.tug.org/texlive) [Linux and other OS]. This will be needed to generate reports.
- For MikTeX, make sure to "install for yourself". Once the installation is complete, open MikTeX Console, click on "Check for updates". Click "Update now" if there is any update available.
- For TeX Live, the package texlive-full may have to be installed to avoid a "missing packages" error (more details below).
Open the conda enabled shell. (Instructions are available on the Miniconda3 installations page)
1. For Windows: Open the Anaconda Command Prompt or Anaconda PowerShell Prompt. These should be available from the start menu after installation.
2. For Linux: Open the terminal (use Ctrl+Alt+T)
Run the following command

conda create -n osdag-env osdag::osdag -c conda-forge

To run Osdag, from the same shell, run these two commands
```
conda activate osdag-env
```
```
osdag
```
This will open the Osdag main page. Note that running Osdag will create a folder "ResourceFiles" where this command is run. This folder will be used to store data for use in subsequent runs (for example input values for various modules).
Attempt a sample problem to make sure everything is working.
During the first run, when creating the design report, some LaTeX packages may have to be installed before the report can be compiled. MikTeX will generally attempt to do this right then, but may fail if it was installed as an administrator. TeX Live is generally installed as an administrator (i.e. with sudo), so you may have to install texlive-full first.
To run Osdag in the future, follow Step 5. This will not require an internet connection.
Occasionally, update Osdag as new updates may have been added since the install
```
conda activate osdag-env
```
```
conda update osdag
```

In case of issues during Steps 4 or 5, i.e. in case Osdag is not installed or does not run, you could try to use the alternative mamba solver

To activate the environment, run
```
conda activate osdag-env
```
The shell should now say (osdag-env).
Run
```
conda install mamba
```

Run

mamba install osdag::osdag -c conda-forge