Skip to content

Commit

Permalink
Deploying to gh-pages from @ 3f92f0b 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
Meakk committed Dec 31, 2024
1 parent ad6104c commit 151586c
Show file tree
Hide file tree
Showing 3 changed files with 3 additions and 3 deletions.
2 changes: 1 addition & 1 deletion assets/js/search-data.json
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@
},"11": {
"doc": "Getting Started",
"title": "Getting Started",
"content": "# Getting started guide This is a getting started guide, aimed to people that are not used to C++ programming, configuring and compiling. If you are already used to such processes, you may be looking for our [build guide](/doc/dev/BUILD.html). This guide will help you to compile your own version of F3D with required dependencies. Optional dependencies or covered in the build guide. - If you are using [Linux](#linux) - If you are using [Windows](#windows) - If you are using [macOS](#macos) ## Linux Note: The following steps were tested with Ubuntu 23 and ArchLinux but should work for other OSes as stated, as long as listed packages are available. ### Install dependencies First make sure your system is up-to-date, then install the required dependencies using the terminal. #### Debian/Ubuntu/Mint ``` sudo apt update sudo apt upgrade sudo apt install build-essential git git-lfs cmake libvtk9-dev ``` #### Fedora/Centos/RedHat ``` sudo yum update sudo yum install make automake gcc gcc-c++ kernel-devel git git-lfs cmake vtk ``` #### Arch Linux ``` sudo pacman -Syu sudo pacman -S base-devel git git-lfs cmake vtk nlohmann-json hdf5 netcdf fmt verdict openmpi glew ospray boost libxcursor ``` ### Compile F3D Open a terminal. ``` mkdir f3d cd f3d git clone https://github.com/f3d-app/f3d src mkdir build cd build cmake ../src make ``` You can then simply run F3D from the command line: ``` ./bin/f3d ``` ### Running the test suite ``` cmake -DBUILD_TESTING=ON ../src make ctest ``` ## Windows Note: The following steps were tested with Visual Studio Community 2022 using Windows 10, but should also work for other versions #### Install Dependencies * Download and install [git bash for windows][gitforwindows] * Download and install [cmake][cmake-download] * Download and install [Visual Studio 2022 Community Edition][visual-studio] #### Recover F3D sources * Open git bash ```sh cd C: mkdir dev cd dev mkdir f3d cd f3d git clone https://github.com/f3d-app/f3d.git src mkdir build ``` #### Install dependencies using vcpkg * Open git bash ```sh cd C:/dev git clone https://github.com/Microsoft/vcpkg.git cd vcpkg git fetch origin c9140a3b500812ad3206317885860d9553b93f13 ``` * Open cmd ```sh cd C:\\dev .\\vcpkg\\bootstrap-vcpkg.bat cmake -B .\\f3d\\build -S .\\f3d\\src -DCMAKE_TOOLCHAIN_FILE=C:\\dev\\vcpkg\\scripts\\buildsystems\\vcpkg.cmake ``` Note: Last command will take a while. It download, compile and install all dependencies, including many optional ones. #### Build F3D * Open cmd ```sh cd C:\\dev\\f3d\\build cmake . cmake --build . ``` #### Run * Double click on the `C:\\dev\\f3d\\build\\bin_Debug\\f3d.exe` executable ### Running the test suite ``` cmake -DBUILD_TESTING=ON . cmake --build . --config Release ctest -C Release ``` ## macOS Note: The following steps were tested with macOS Catalina using Xcode 12.4, but should also work for other versions ### Install Xcode There are different ways to install Xcode, you can use the AppStore or download it from apple developer website and then extract and install it. ### Install Homebrew Open a terminal. ``` /bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\" (echo; echo 'eval \"$(/opt/homebrew/bin/brew shellenv)\"') >> ~/.zprofile eval \"$(/opt/homebrew/bin/brew shellenv)\" ``` ### Install dependencies Open a terminal. ``` brew install git git-lfs cmake curl vtk git lfs install ``` Note: Homebrew is downloading, compiling and installing all vtk dependencies. This command may take a very long time. ### Compile F3D Open a terminal. ``` mkdir f3d cd f3d git clone https://github.com/f3d-app/f3d src mkdir build cd build cmake ../src make ``` You can then simply run F3D from the command line: ``` ./bin/f3d.app/Contents/MacOS/f3d ``` ### Running the test suite ``` cmake -DBUILD_TESTING=ON ../src make ctest ``` [cmake-download]: https://cmake.org/download [gitforwindows]: https://gitforwindows.org/ [visual-studio]: https://visualstudio.microsoft.com/vs/community/ ",
"content": "# Getting started guide This is a getting started guide, aimed to people that are not used to C++ programming, configuring and compiling. If you are already used to such processes, you may be looking for our [build guide](/doc/dev/BUILD.html). This guide will help you to compile your own version of F3D with required dependencies. Optional dependencies or covered in the build guide. - If you are using [Linux](#linux) - If you are using [Windows](#windows) - If you are using [macOS](#macos) ## Linux Note: The following steps were tested with Ubuntu 23 and ArchLinux but should work for other OSes as stated, as long as listed packages are available. ### Install dependencies First make sure your system is up-to-date, then install the required dependencies using the terminal. #### Debian/Ubuntu/Mint ``` sudo apt update sudo apt upgrade sudo apt install build-essential git git-lfs cmake libvtk9-dev ``` #### Fedora/Centos/RedHat ``` sudo yum update sudo yum install make automake gcc gcc-c++ kernel-devel git git-lfs cmake vtk ``` #### Arch Linux ``` sudo pacman -Syu sudo pacman -S base-devel git git-lfs cmake vtk nlohmann-json hdf5 netcdf fmt verdict openmpi glew ospray libxcursor ``` ### Compile F3D Open a terminal. ``` mkdir f3d cd f3d git clone https://github.com/f3d-app/f3d src mkdir build cd build cmake ../src make ``` You can then simply run F3D from the command line: ``` ./bin/f3d ``` ### Running the test suite ``` cmake -DBUILD_TESTING=ON ../src make ctest ``` ## Windows Note: The following steps were tested with Visual Studio Community 2022 using Windows 10, but should also work for other versions #### Install Dependencies * Download and install [git bash for windows][gitforwindows] * Download and install [cmake][cmake-download] * Download and install [Visual Studio 2022 Community Edition][visual-studio] #### Recover F3D sources * Open git bash ```sh cd C: mkdir dev cd dev mkdir f3d cd f3d git clone https://github.com/f3d-app/f3d.git src mkdir build ``` #### Install dependencies using vcpkg * Open git bash ```sh cd C:/dev git clone https://github.com/Microsoft/vcpkg.git cd vcpkg git fetch origin c9140a3b500812ad3206317885860d9553b93f13 ``` * Open cmd ```sh cd C:\\dev .\\vcpkg\\bootstrap-vcpkg.bat cmake -B .\\f3d\\build -S .\\f3d\\src -DCMAKE_TOOLCHAIN_FILE=C:\\dev\\vcpkg\\scripts\\buildsystems\\vcpkg.cmake ``` Note: Last command will take a while. It download, compile and install all dependencies, including many optional ones. #### Build F3D * Open cmd ```sh cd C:\\dev\\f3d\\build cmake . cmake --build . ``` #### Run * Double click on the `C:\\dev\\f3d\\build\\bin_Debug\\f3d.exe` executable ### Running the test suite ``` cmake -DBUILD_TESTING=ON . cmake --build . --config Release ctest -C Release ``` ## macOS Note: The following steps were tested with macOS Catalina using Xcode 12.4, but should also work for other versions ### Install Xcode There are different ways to install Xcode, you can use the AppStore or download it from apple developer website and then extract and install it. ### Install Homebrew Open a terminal. ``` /bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\" (echo; echo 'eval \"$(/opt/homebrew/bin/brew shellenv)\"') >> ~/.zprofile eval \"$(/opt/homebrew/bin/brew shellenv)\" ``` ### Install dependencies Open a terminal. ``` brew install git git-lfs cmake curl vtk git lfs install ``` Note: Homebrew is downloading, compiling and installing all vtk dependencies. This command may take a very long time. ### Compile F3D Open a terminal. ``` mkdir f3d cd f3d git clone https://github.com/f3d-app/f3d src mkdir build cd build cmake ../src make ``` You can then simply run F3D from the command line: ``` ./bin/f3d.app/Contents/MacOS/f3d ``` ### Running the test suite ``` cmake -DBUILD_TESTING=ON ../src make ctest ``` [cmake-download]: https://cmake.org/download [gitforwindows]: https://gitforwindows.org/ [visual-studio]: https://visualstudio.microsoft.com/vs/community/ ",
"url": "/doc/dev/GETTING_STARTED.html",

"relUrl": "/doc/dev/GETTING_STARTED.html"
Expand Down
2 changes: 1 addition & 1 deletion doc/dev/GETTING_STARTED.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
</code></pre></div></div> <h4 id="fedoracentosredhat"> <a href="#fedoracentosredhat" class="anchor-heading" aria-labelledby="fedoracentosredhat"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Fedora/Centos/RedHat </h4> <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo yum update
sudo yum install make automake gcc gcc-c++ kernel-devel git git-lfs cmake vtk
</code></pre></div></div> <h4 id="arch-linux"> <a href="#arch-linux" class="anchor-heading" aria-labelledby="arch-linux"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Arch Linux </h4> <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo pacman -Syu
sudo pacman -S base-devel git git-lfs cmake vtk nlohmann-json hdf5 netcdf fmt verdict openmpi glew ospray boost libxcursor
sudo pacman -S base-devel git git-lfs cmake vtk nlohmann-json hdf5 netcdf fmt verdict openmpi glew ospray libxcursor
</code></pre></div></div> <h3 id="compile-f3d"> <a href="#compile-f3d" class="anchor-heading" aria-labelledby="compile-f3d"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Compile F3D </h3> <p>Open a terminal.</p> <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mkdir f3d
cd f3d
git clone https://github.com/f3d-app/f3d src
Expand Down
2 changes: 1 addition & 1 deletion doc/dev/GETTING_STARTED.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ sudo yum install make automake gcc gcc-c++ kernel-devel git git-lfs cmake vtk

```
sudo pacman -Syu
sudo pacman -S base-devel git git-lfs cmake vtk nlohmann-json hdf5 netcdf fmt verdict openmpi glew ospray boost libxcursor
sudo pacman -S base-devel git git-lfs cmake vtk nlohmann-json hdf5 netcdf fmt verdict openmpi glew ospray libxcursor
```

### Compile F3D
Expand Down

0 comments on commit 151586c

Please sign in to comment.