GitHub

Spglib

Documentation for Spglib.

See the Index for the complete list of documented functions and types.

The code, which is hosted on GitHub, is tested using various continuous integration services for its validity.

This repository is created and maintained by @singularitti, and contributions are highly welcome.

Package features

Spglib.jl is a Julia wrapper of the C library Spglib. See this page. It is used for finding and handling crystal symmetries.

There was a package LibSymspg.jl thanks to @unkcpz. However, it is no longer actively maintained.

This package:

  • enables the finding and handling of crystal symmetries;
  • includes new naming conventions, input types, and return types of functions.

Installation

The package can be installed with the Julia package manager. From the Julia REPL, type ] to enter the Pkg mode and run:

pkg> add Spglib

Or, equivalently, via Pkg.jl:

julia> import Pkg; Pkg.add("Spglib")   Resolving package versions...
   Installed Spglib ─ v0.9.4
    Updating `~/work/Spglib.jl/Spglib.jl/docs/Project.toml`
  [f761d5c5] ~ Spglib v0.9.4 `~/.julia/dev/Spglib` ⇒ v0.9.4
    Updating `~/work/Spglib.jl/Spglib.jl/docs/Manifest.toml`
  [f761d5c5] ~ Spglib v0.9.4 `~/.julia/dev/Spglib` ⇒ v0.9.4
Precompiling project...
   1243.3 ms  ✓ Spglib
  1 dependency successfully precompiled in 1 seconds. 59 already precompiled.
  1 dependency precompiled but a different version is currently loaded. Restart julia to access the new version

Documentation

  • STABLE — documentation of the most recently tagged version.
  • DEV — documentation of the in-development version.

Project status

The package is developed for and tested against Julia v1.6 and above on Linux, macOS, and Windows.

Questions and contributions

You can post usage questions on our discussion page.

We welcome contributions, feature requests, and suggestions. If you encounter any problems, please open an issue. The Contributing page has a few guidelines that should be followed when opening pull requests and contributing code.

Manual outline

Library outline

Index