Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A Converter from CIF to SALMON input file.


SALMON is an open-source software based on first-principles time-dependent density functional theory to describe optical responses and electron dynamics in matters induced by light electromagnetic fields. This program generates the input file format of the SALMON from the CIF-formatted crystal structure data. The CIF is the most popular file format for the data archive of the crystallographic information. The CIF formatted data can be obtained from many [distribution websites](#CIF Archives).

This program has functionalities as below:

  • Generate the atomic coordinates from the CIF by considering the symmetric operations, and construct the rectangular supercell which can be treated in the SALMON.
  • Estimate the preferred grid spacing from the contained atomic species.
  • Automatic downloads of pseudopotential files required in the calculation (optional).

It is convenient for preparation of your input files.


  • Python 3
  • NumPy 1.10 or later
  • SciPy


Simple usage

./ < CIFFILE.cif > inputfile.inp

The translated input file is exported on the stdout.

Automatic Download of Pseudopotential Files

Use -d or --download options to get the pseudopotential files used in the input file.

./ -d < CIFFILE.cif > inputfile.inp 

Write out the Generated Supercell

Use --export-cif options to export the CIF file of the generated supercell structure.

./ --export-cif=OUTPUT.cif < CIFFILE.cif 

You can check the generated structure by using the CIF supported viewers.


  • This program automatically estimates the spatial division (nrgrid) from the atomic species. However, it is often insufficient for the material systems including d-orbits such as the transition metals. We strongly recommend ** the trial-and-error testing to check the convergence ** by your self.
  • The real-time (dt) and k-space sampling grid (nkgrid) is presently not automatically estimated, and it is necessary to set the adequate values by your self.

External Links

SALMON Project

CIF Archives

CIF Format

  • Hall SR, Allen FH, Brown ID (1991). "The Crystallographic Information File (CIF): a new standard archive file for crystallography." Acta Crystallographica. A47 (6): 655–685. doi:10.1107/S010876739101067X


Input File Importer for SALMON Program



No releases published


No packages published


You can’t perform that action at this time.