Skip to content

Commit

Permalink
[Documentation] Use raw url for image assets (#26)
Browse files Browse the repository at this point in the history
  • Loading branch information
youwuyou authored Jul 26, 2024
1 parent 653396c commit 0bc227b
Show file tree
Hide file tree
Showing 5 changed files with 14 additions and 10 deletions.
4 changes: 4 additions & 0 deletions docs/src/concepts/architectures.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,10 @@ For advanced users, we provide a function `activate!(arch; priority)` for specif

Our distributed architecture builds upon the abstraction of having GPU clusters that build on the same GPU architecture. Note that in general, GPU clusters may be equipped with hardware from different vendors, incorporating different types of GPUs to exploit their unique capabilities for specific tasks.

!!! warning "GPU-Aware MPI Required for Distributed Module on GPU backend"
The `Distributed` module currently only supports [GPU-aware MPI](https://juliaparallel.org/MPI.jl/stable/usage/#CUDA-aware-MPI-support) when a GPU backend is selected for multi-GPU computations. For the `Distributed` module to function properly, any GPU-aware MPI library installation shall be used. Otherwise, a segmentation fault will occur.


To make the `Architecture` object aware of MPI topology, user can pass an MPI communicator object and dimensions of the Cartesian topology to the `Arch` constructor:

```julia
Expand Down
2 changes: 1 addition & 1 deletion docs/src/concepts/bc.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ The following figure showcases a 2D square domain $\Omega$ with different bounda
- The left and right boundaries (green) are Neumann boundary conditions where $\frac{\partial u}{\partial y} = 0$.

```@raw html
<img src="../assets/mixed_bc_example.png" width="60%"/>
<img src="https://raw.githubusercontent.com/PTsolvers/Chmy.jl/main/docs/src/assets/mixed_bc_example.png" width="60%"/>
```

To launch a kernel that satisfies these boundary conditions in Chmy.jl, you can use the following code:
Expand Down
6 changes: 3 additions & 3 deletions docs/src/concepts/fields.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
With a given grid that allows us to define each point uniquely in a high-dimensional space, we abstract the data values to be defined on the grid under the concept `AbstractField`. Following is the type tree of the abstract field and its derived data types.

```@raw html
<img src="../assets/field_type_tree.svg" width="70%"/>
<img src="https://raw.githubusercontent.com/PTsolvers/Chmy.jl/main/docs/src/assets/field_type_tree.svg" width="70%"/>
```

## Defining a multi-dimensional `Field`
Expand Down Expand Up @@ -50,11 +50,11 @@ set!(C, grid, (x, y) -> exp(-x^2 - y^2))
```

```@raw html
<img src="../assets/field_set_ic_random.png" width="50%"/>
<img src="https://raw.githubusercontent.com/PTsolvers/Chmy.jl/main/docs/src/assets/field_set_ic_random.png" width="50%"/>
```

```@raw html
<img src="../assets/field_set_ic_gaussian.png" width="50%"/>
<img src="https://raw.githubusercontent.com/PTsolvers/Chmy.jl/main/docs/src/assets/field_set_ic_gaussian.png" width="50%"/>
```

A slightly more complex usage involves passing extra parameters to be used for initial conditions setup.
Expand Down
8 changes: 4 additions & 4 deletions docs/src/concepts/grids.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,11 +53,11 @@ grid = UniformGrid(arch;
- [grids_3d.jl](https://github.com/PTsolvers/Chmy.jl/blob/main/examples/grids_3d.jl): Visualization of a 3D `StructuredGrid`

```@raw html
<img src="../assets/grid_2d.png" width="50%"/>
<img src="https://raw.githubusercontent.com/PTsolvers/Chmy.jl/main/docs/src/assets/grid_2d.png" width="50%"/>
```

```@raw html
<img src="../assets/grid_3d.png" width="50%"/>
<img src="https://raw.githubusercontent.com/PTsolvers/Chmy.jl/main/docs/src/assets/grid_3d.png" width="50%"/>
```

## Location on a Grid Cell
Expand All @@ -67,13 +67,13 @@ In order to allow full control over the distribution of different variables on t
We illustrate how to specify the location within a grid cell on a fully staggered uniform grid. The following 2D example also has ghost nodes illustrated that are located immediately outside the domain boundary.

```@raw html
<img src="../assets/staggered_grid.png" width="80%"/>
<img src="https://raw.githubusercontent.com/PTsolvers/Chmy.jl/main/docs/src/assets/staggered_grid.png" width="80%"/>
```

In the following example, we zoom into a specific cell on a **fully-staggered grid**. By specifying for both x- and y-dimensions whether the node locates at the `Center` (C) or `Vertex` (V) along the respective axis, we can arrive in 4 categories of nodes on a 2D quadrilateral cell, which we refer to as "basic", "pressure", "Vx" and "Vy" nodes, following common practices.

```@raw html
<img src="../assets/staggered_grid_cell.png" width="50%"/>
<img src="https://raw.githubusercontent.com/PTsolvers/Chmy.jl/main/docs/src/assets/staggered_grid_cell.png" width="50%"/>
```

If all variables are defined on basic nodes, specified by `(V,V)` locations, we have the simplest non-staggered **collocated grid**.
Expand Down
4 changes: 2 additions & 2 deletions docs/src/getting_started.md
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ bc!(arch, grid, C => Neumann(); exchange=C)

```@raw html
<div style="text-align: center;">
<img src="assets/field_set_ic_random.png" width="50%"/>
<img src="https://raw.githubusercontent.com/PTsolvers/Chmy.jl/main/docs/src/assets/field_set_ic_random.png" width="50%"/>
</div>
```

Expand All @@ -142,6 +142,6 @@ After running the simulation, you should see something like this, here the final

```@raw html
<div style="text-align: center;">
<img src="assets/diffusion_2d_it_100.png" width="50%"/>
<img src="https://raw.githubusercontent.com/PTsolvers/Chmy.jl/main/docs/src/assets/diffusion_2d_it_100.png" width="50%"/>
</div>
```

0 comments on commit 0bc227b

Please sign in to comment.