Skip to content

Commit

Permalink
update docs to install from registry
Browse files Browse the repository at this point in the history
  • Loading branch information
chrisdjscott committed Sep 17, 2024
1 parent 82f0e25 commit dabc545
Show file tree
Hide file tree
Showing 6 changed files with 23 additions and 24 deletions.
31 changes: 17 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,22 @@
# DACE.jl

**Work in progress**
DACE.jl is a Julia interface to the [DACE](https://github.com/dacelib/dace) library.

Julia interface to [DACE](https://github.com/dacelib/dace).

Documentation is [here](https://a-ev.github.io/DACE.jl/).
Documentation can be found [here](https://a-ev.github.io/DACE.jl/).

## Example usage

Install dependencies:
DACE.jl can be installed using the Julia package manager. From the Julia REPL,
type `]` to enter the Pkg REPL mode and run

```
$ julia --project
(DACE) pkg> add https://github.com/a-ev/DACE.jl.git
pkg> add DACE
```

Note: the `add` command above may not be needed if you are
running from the directory containing this file.

Run an example:
Run a simple example:

```
$ julia --project examples/sine.jl
$ julia examples/sine.jl
x
I COEFFICIENT ORDER EXPONENTS
1 1.0000000000000000e+00 1 1
Expand All @@ -47,9 +42,17 @@ sin(1.0) = 0.8414709848078965

More examples of how to use *DACE.jl* can be found in the tests, for example [validation_2.jl](test/validation_2.jl).

You can run the validation tests with (using `]` to enter pkg mode from the Julia REPL):
You can run the validation tests using the Julia package manager.
Clone this git repository and change into the cloned directory.
Then enter the Julia REPL using `julia --project` and
type `]` to enter the Pkg REPL mode and instantiate the package:

```
(DACE) pkg> instantiate
```

Then run the tests:

```
$ julia --project
(DACE) pkg> test
```
2 changes: 1 addition & 1 deletion docs/Project.toml
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ DocStringExtensions = "ffbed154-4ef7-542d-bbb7-c09d3a79fcae"

[compat]
CxxWrap = "~0.16"
DACE_jll = "~0.4"
DACE_jll = "~0.5"
DiffEqBase = "^6"
SpecialFunctions = "^2"
DocStringExtensions = "^0.9"
8 changes: 2 additions & 6 deletions docs/src/index.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# DACE.jl

!!! warning
This package is still in development, is not complete and instructions may change significantly

This is the documentation page for [DACE.jl](https://github.com/a-ev/DACE.jl),
a Julia interface to the [DACE library](https://github.com/dacelib/dace).

Expand All @@ -12,11 +9,9 @@ DACE.jl can be installed using the Julia package manager. From the Julia REPL,
type `]` to enter the Pkg REPL mode and run

```
pkg> add https://github.com/a-ev/DACE.jl.git
pkg> add DACE
```

Note: the `add` command above may not be needed if you are running from main directory of the repository.

## Notes about the interface

- The Julia interface is built using [CxxWrap.jl](https://github.com/JuliaInterop/CxxWrap.jl)
Expand All @@ -25,6 +20,7 @@ Note: the `add` command above may not be needed if you are running from main dir
- The C++ code gets built by [BinaryBuilder](https://docs.binarybuilder.org/stable/) and released into the Julia registry
- the build recipe is located [here](https://github.com/JuliaPackaging/Yggdrasil/tree/master/D/DACE)
- The Julia component of the interface is currently [here](https://github.com/a-ev/DACE.jl)
- the DACE library has been released to the Julia General registry

The above may change, in particular we hope to:

Expand Down
2 changes: 1 addition & 1 deletion examples/ode_integration.jl
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

# ```julia
# using Pkg
# Pkg.add("https://github.com/a-ev/DACE.jl.git")
# Pkg.add("DACE")
# ```

# ## Using DACE
Expand Down
2 changes: 1 addition & 1 deletion examples/polynomial_inversion.jl
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

# ```julia
# using Pkg
# Pkg.add("https://github.com/a-ev/DACE.jl.git")
# Pkg.add("DACE")
# ```

# ## Using DACE
Expand Down
2 changes: 1 addition & 1 deletion examples/sine.jl
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@

# ```julia
# using Pkg
# Pkg.add("https://github.com/a-ev/DACE.jl.git")
# Pkg.add("DACE")
# ```

# ## Using DACE
Expand Down

0 comments on commit dabc545

Please sign in to comment.