Skip to content

Commit

Permalink
docs update
Browse files Browse the repository at this point in the history
  • Loading branch information
adamslc committed Nov 18, 2024
1 parent 1917652 commit cee6c9d
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 16 deletions.
2 changes: 1 addition & 1 deletion docs/make.jl
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,4 @@ makedocs(;
pages = ["Home" => "index.md", "API Reference" => "api.md"],
)

deploydocs(; repo = "github.com/adamslc/PlasmaFormulary.jl", devbranch = "main")
deploydocs(; repo = "github.com/JuliaPlasma/PlasmaFormulary.jl", devbranch = "main")
20 changes: 5 additions & 15 deletions docs/src/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,10 @@ CurrentModule = PlasmaFormulary

# PlasmaFormulary

A Julia package for plasma physics formulas. This package implements a subset of the formulas found in the [NRL Plasma Formulary](https://www.nrl.navy.mil/News-Media/Publications/NRL-Plasma-Formulary/).
A Julia package for plasma physics formulas.
This package implements a subset of the formulas found in the [NRL Plasma Formulary](https://www.nrl.navy.mil/News-Media/Publications/NRL-Plasma-Formulary/), as well as some additional formulas taken from the [PlasmaPy](https://docs.plasmapy.org) project.

We use Julia's dynamic dispatch to handle arguments. As a result, arguments can be given in any order for most functions, since the unit (type) of each argument is often unique. See [@permutable_args](@ref) for implementations of permutable arguments.

For functions that take a `ParticleLike` as an argument, we use [ChargedParticles.jl](https://github.com/Beforerr/ChargedParticles.jl) to handle particle properties. One could provide a symbolic particle name or string or a `Particle` object for the argument. Also, mass number and charge number can be specified as keyword arguments for these functions.
In the future, the package will support providing particle properties using the [ChargedParticles.jl](https://github.com/Beforerr/ChargedParticles.jl) package.

## Quick Example

Expand All @@ -22,21 +21,12 @@ plasma_frequency(1e19u"m^-3") # electron plasma frequency
gyroradius(0.1u"T", :p, 1e6u"K") # proton gyroradius at 1 million K
```

One does not need to care the order of the arguments, we automatically handle them for you. 🥳

Common particle names are also supported. 🫡

```@repl share
gyroradius(0.1u"T", :e, 1e6u"K") ==
gyroradius(1e6u"K", "electron", 0.1u"T") ==
gyroradius("e+", 1e6u"K", 0.1u"T")
```

## Related packages

- [PlasmaPy](https://docs.plasmapy.org) : `plasmapy.formulary` subpackage provides theoretical formulas for calculation of physical quantities helpful for plasma physics.
- [FusionFormulary.jl]{https://github.com/JuliaFusion/FusionFormulary.jl}

## Index

```@index
```
```

0 comments on commit cee6c9d

Please sign in to comment.