Skip to content

Commit

Permalink
[DOCS] Fix ITensors.compile docs
Browse files Browse the repository at this point in the history
  • Loading branch information
mtfishman committed Dec 13, 2024
1 parent 88f7d3e commit d8e3658
Show file tree
Hide file tree
Showing 3 changed files with 14 additions and 8 deletions.
2 changes: 1 addition & 1 deletion Project.toml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
name = "ITensors"
uuid = "9136182c-28ba-11e9-034c-db9fb085ebd5"
authors = ["Matthew Fishman <mfishman@flatironinstitute.org>", "Miles Stoudenmire <mstoudenmire@flatironinstitute.org>"]
version = "0.7.10"
version = "0.7.11"

[deps]
Adapt = "79e6a3ab-5dfb-504d-930d-738a2a938a0e"
Expand Down
10 changes: 7 additions & 3 deletions docs/src/AdvancedUsageGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -818,15 +818,19 @@ called a "custom system image", a custom version of Julia that
includes a compiled version of ITensors (see the [PackageCompiler documentation](https://julialang.github.io/PackageCompiler.jl/dev/) for more details).
!!! compat "ITensors 0.7"
As of ITensors 0.7, you must now install and load the
As of ITensors 0.7, you must now install and load both the
[ITensorMPS.jl](https://github.com/ITensor/ITensorMPS.jl) package
in order to use `ITensors.compile()`, since it relies on running MPS/MPO
functionality as example code for Julia to compile.
and the [PackageCompiler.jl](https://github.com/JuliaLang/PackageCompiler.jl)
package in order to use `ITensors.compile()`, since it relies on running MPS/MPO
functionality as example code for Julia to compile and is based in a package
extension in order to make `PackageCompiler.jl` an optional dependency.
Just run the commands:
```
julia> using ITensors, ITensorMPS

julia> using PackageCompiler

julia> ITensors.compile()
[...]
```
Expand Down
10 changes: 6 additions & 4 deletions src/packagecompile/compile.jl
Original file line number Diff line number Diff line change
Expand Up @@ -44,17 +44,19 @@ end
ITensors.compile(; dir = "$(default_compile_dir())",
filename = "$(default_compile_filename())")
Compile ITensors.jl with [PackageCompiler](https://julialang.github.io/PackageCompiler.jl/dev/).
Compile ITensors.jl with [PackageCompiler.jl](https://julialang.github.io/PackageCompiler.jl/dev/).
This will take some time, perhaps a few minutes.
This will create a system image containing the compiled version of ITensors
located at `dir/filename`, by default `$(default_compile_path())`.
!!! compat "ITensors 0.7"
As of ITensors 0.7, you must now install and load the
As of ITensors 0.7, you must now install and load both the
[ITensorMPS.jl](https://github.com/ITensor/ITensorMPS.jl) package
in order to use `ITensors.compile()`, since it relies on running MPS/MPO
functionality as example code for Julia to compile.
and the [PackageCompiler.jl](https://github.com/JuliaLang/PackageCompiler.jl)
package in order to use `ITensors.compile()`, since it relies on running MPS/MPO
functionality as example code for Julia to compile and is based in a package
extension in order to make `PackageCompiler.jl` an optional dependency.
$(compile_note())
""" compile

2 comments on commit d8e3658

@mtfishman
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@JuliaRegistrator
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Registration pull request created: JuliaRegistries/General/121382

Tip: Release Notes

Did you know you can add release notes too? Just add markdown formatted text underneath the comment after the text
"Release notes:" and it will be added to the registry PR, and if TagBot is installed it will also be added to the
release that TagBot creates. i.e.

@JuliaRegistrator register

Release notes:

## Breaking changes

- blah

To add them here just re-invoke and the PR will be updated.

Tagging

After the above pull request is merged, it is recommended that a tag is created on this repository for the registered package version.

This will be done automatically if the Julia TagBot GitHub Action is installed, or can be done manually through the github interface, or via:

git tag -a v0.7.11 -m "<description of version>" d8e365881964eef8fd1995d0e9ac9d682d0e695d
git push origin v0.7.11

Please sign in to comment.