# Release notes¶

## Git master branch¶

Calculators:

Optimizers:

• Add ase.optimize.climbfixinternals.ClimbFixInternals class for transition state search and optimization along internal reaction coordinates

## Version 3.22.1¶

1 December 2021: 3.22.1

• Fixed compatibility of Brillouin zone plotting with matplotlib 3.5+.

## Version 3.22.0¶

24 June 2021: 3.22.0

Calculators:

• ase.calculators.qmmm.ForceQMMM was updated to enable correct handling of various periodic boundary conditions. Functions to import and export files with QM/MM mapping were also added.

• It is now possible to use Abinit together with SocketIOCalculator. Requires Abinit 9.4+.

• It is now possible to pass a function to SocketIOCalculator to customize startup of a socket client. This decouples socket I/O calculators from FileIOCalculator.

• Added PySocketIOClient, a helper class for using the socket I/O calculator with Python clients.

• OpenKIM calculator updated to support kimpy 2.0.0.

• DFTB+ calculator now reads dipole moments.

Algorithms:

• Dedicated class ase.vibrations.VibrationsData to improve the representation of vibrational modes and associated data.

• Major refactoring of ase.vibrations.Vibrations. The calculated vibrational data can now be exported as a VibrationsData object.

• phonons.get_dos() now returns a DOS object based on the new framework in ase.spectrum.

• ase.vibrations.Vibrations and ase.phonons.Phonons now use a simplified caching system where forces for each displacement are saved in JSON files inside a subdirectory. This breaks old cached calculations. Old vibrations calculations can be ported using a migration tool; see python3 -m ase.vibrations.pickle2json --help.

• Added ase.md.contour_exploration.ContourExploration. It evolves systems at fixed potential energy. This is useful for tracing potential energy contour lines or rapidly exploring the potential energy surface of a system and can be tuned to preferentially sample highly curved regions of the potential energy surface.

• ase.neb.NEB has been overhauled and given support for preconditioning via a new $$precon$$ argument to its constructor, and two newly supported methods, $$spline$$ for spline-interpolated tangets and $$string$$ for the string method, both of which support preconditioning. The default behaviour should be unchanged.

• Interpolating NEB images on constrained atoms will now raise an error if the interpolated positions would become different depending on whether the constraints were applied. Pass apply_constraint=True or False to ase.neb.NEB.interpolate() or ase.neb.interpolate() to choose a specific behaviour and silence the error.

• 3D Brillouin zone plots are now guaranteed isometric with Matplotlib 3.3+.

I/O:

• Gaussian input file parsing has been greatly improved. The parser now extracts all variables from the input file.

• Reading of “chemical json” file types with name *.cml is enabled.

• LAMMPS dump: Reading of elements column added, with priority over types if given. All four of the position specifier columns read correctly now.

• Format readers that would by default read or write specific files into current working directory no longer do so. A path, whether absolute or relative, is now mandatory for all I/O functions.

• The Siesta .XV format is now a recognized I/O format, siesta-xv.

• Parsing an OUTCAR file will now produce an Atoms object with periodic boundary conditions.

Breaking changes:

• For security, ASE no longer uses pickle for any kind of file I/O. This is because a maliciously crafted pickle file can execute arbitrary code.

Features that used pickle now either use JSON, no longer support saving, or require a manual port of older pickle files using a migration tool. If you have many old calculations and rely on your own old (trusted) pickle files which cannot be loaded now, consider writing and contributing a migration tool for those files.

The old PickleTrajectory format can still be loaded by manually overriding the security check.

Pickle is still used for communication between processes started by ASE (such as plotting tools in the GUI), which is not a security problem since an attacker cannot tamper with the data unless the system is already compromised.

GUI:

Bug fixes:

• Fix deadlock with DFTD3 calculator in MPI calculations.

• Fix parsing of Quantum Espresso outputs with more than 1000 atoms.

• Write netcdf trajectories compatible with Amber 20.

• Fix bug where constraints could be applied inconsistently in MD simulations.

• Allow disabling thermostat and barostat in NPT molecular dynamics.

• Fix problem with whitespace in CIF parser.

• Fix a problem where constraints would be applied inconsistently in MD simulations. As the interactions between MD and constraints are not trivial, users should in general verify carefully that simulations behave physically correctly.

• Fix issue where occupancies in atoms.info would subtly change type when saved to JSON and reloaded.

Web-page:

## Version 3.21.1¶

24 January 2021: 3.21.1

• Fix incorrect positions written to CIF files with mixed boundary conditions.

• Writing a CIF with only 1 or 2 lattice vectors will now raise an error since CIF cannot represent those systems.

• The name of the Vasp calculator is now 'vasp' as intended.

• Fix attribute error in write_jmol().

## Version 3.21.0¶

18 January 2021: 3.21.0

General changes:

• center() now centers around 0 along directions which do not have a cell vector. Previously this operation had no effect in those directions.

• Deprecated the following methods on Atoms as they can be replaced by ~ase.cell.Cell: atoms.get_cell_lengths_and_angles(), atoms.get_reciprocal_cell(), atoms.number_of_lattice_vectors. Instead use atoms.cell.cellpar(), atoms.cell.reciprocal(), and atoms.cell.rank, respectively.

• Removed deprecated code on Atoms for handling angles in radians.

• get_velocities() will now return zeros rather than None when there are no velocities, consistently with other optionals such as momenta.

• For security reasons, pickle will no longer be used for persistent file storage in the future. Pickle has so far been replaced with JSON in ase.io.bundletrajectory.BundleTrajectory and ase.dft.stm.STM. All remaining use of pickle for persistent storage will be likewise replaced in next release. Users are advised as always not to open pickle-files from untrusted sources.

• ase.utils.opencew() to be replaced by ase.utils.xwopen() which is a contextmanager and ensures that the file is closed correctly.

• Clusters created by ase.cluster will no longer have cell vectors and will be centered around (0, 0, 0). Previously they had a “tight” cell and coordinates centered with zero vacuum.

• Refactored external viewers in ase.visualize.view. Viewers will now clean up their temporary files correctly on non-UNIX platforms.

• Band structure module moved to ase.spectrum.band_structure.

• New objects for working with DOS and collections of DOS in ase.spectrum. To begin with, this will mostly be relevant for format readers that want to retrieve such objects from calculations.

Command-line interface:

• Added ase exec sub-command for the ase command line interface.

Algorithms:

• Changed units for molecular dynamics modules. They now accept the temperature in Kelvin as a keyword-only argument temperature_K and Berendsen NPT accepts the pressure in eV/Å³ as a keyword-only argument pressure_au. The previous arguments are still available and still take temperature and pressure in whatever unit the module used to accept, but now issue a warning.

• Made Andersen thermostat available for molecular dynamics simulation.

• Refactored ase.neb.NEB.

• The linear interpolation (ase.neb.interpolate()) between images now supports cell-interpolation and the use of scaled positions.

• SingleCalculatorNEB is deprecated. Use ase.neb.NEB(allow_shared_calculator=True) instead.

• Extended constraint ase.constraints.FixInternals by possibility to fix linear combinations of bond lengths.

• FixInternals constraints now support constraining linear combinations of angles or dihedrals. It is also possible to slice atoms objects with FixInternals constraints on them.

• Added ase.build.connected which finds groups of connected atoms inside an Atoms object.

• Optimizers and molecular dynamics objects, which may open trajectories or logfiles, can now be used as context managers. Doing so ensures correct closing of the files that they open.

• Faster codepath for minimum-image convention (MIC) distance calculations with “well-behaved” unit cells. This improves the speed of neighbour lists and certain constraints.

• Cleanup and deprecations of certain methods on Phonons.

Calculators:

• The ignore_bad_restart_file argument supported by many calculators has been deprecated. The user should choose this kind of behaviour explicitly.

• Cleaned up and fixed multiple issues with ELK calculator.

• Make-shift cleanup and fixes for Exciting calculator.

• ase.calculators.abinit.Abinit updated to work with Abinit 9.

• Improved cleanup of old socket files under some types of failure with ase.calculators.socketio.SocketIOCalculator.

• Vasp now uses the newer implementation formerly known as Vasp2.

• Added smooth cutoff option to ase.calculators.lj.LennardJones. This makes the forces continuous as atoms move past the cutoff radius.

• LennardJones is now much more efficient.

• Many calculators would change the working directory in order to facilitate work with files. However doing so breaks threading. This has been fixed for most calculators (abinit, lammpsrun, )

I/O:

• Reads Wannier90 .wout files. See ase.io.wannier90.read_wout() and ase.io.wannier90.read_wout_all().

• ase.io.pov.write_pov() no longer includes an option to run povray on top of the written output. Instead it returns a renderer which can be used like this:

png_path = write_pov('myfile.pov').render()

• Refactored CIF reader and writer, adding more extensive testing and fixing multiple bugs.

• CIF writer now uses up-to-date variable definitions from the CIF standard instead of deprecated ones. Also, it no longer writes columns of dummy data that doesn’t depend on the atoms.

• Added ase.io.cif.CIFBlock for direct access to data inside a CIF, and ase.io.cif.parse_cif() to iterate over such blocks from a CIF.

• Fixed many cases of careless I/O handling where format readers or writers would open files without necessarily closing them.

• Vasp output formats return atoms with fully periodic boundary conditions as appropriate.

• Vasp POSCAR/CONTCAR writer will now use the Vasp5 format by default.

Development:

• Test suite now prints a descriptive header with dependency versions including a list of installed/enabled calculators.

• All tests with random numbers now use a specific seed so as to run reproducibly.

• CI now supports integration testing with many additional calculators. The full list of external calculators that can be integration-tested via CI is: Abinit, Asap, CP2K, DFTB, DFTD3, Elk, Espresso, Exciting, GPAW, Gromacs, Lammpslib, Lammpsrun, NWChem, Octopus, OpenMX, Siesta.

## Version 3.20.1¶

11 August 2020: 3.20.1

• Minor fix related to package version requirements on pypi.

## Version 3.19.3¶

11 August 2020: 3.19.3

• Minor fix related to package version requirements on pypi.

## Version 3.20.0¶

8 August 2020: 3.20.0

General changes:

• get_calculator() and set_calculator() are deprecated. Use atoms.calc instead.

• del atoms.calc is deprecated. Use atoms.calc = None instead.

• The deprecated atoms.cell.pbc has been removed.

• More utility methods for atoms.symbols: species(), search(), indices().

Development:

• Test suite now uses pytest. This means it requires pytest and optionally pytest-xdist for parallelization. The ase test command works as before although its output will be different and improved.

• Many tests have been improved and simplified, making use of pytest for parametrization and test fixtures.

• The continuous integration tests on Gitlab now use custom dockers. The docker files can be found at https://gitlab.com/ase/ase-dockers.

• Some calculators can now be tested via Gitlab’s CI.

• Code coverage statistics are now available on https://ase.gitlab.io/ase. They currently exclude calculators and IO formats.

• Our CI now uses mypy for static analysis of the code.

Algorithms:

• Functions for attaching structures in attach introduced.

• Standardize optimizers maximum step variable name to maxstep and default value to 0.2 for all optimizers.

• Added Pyberny geometry optimizer. This optimizer can be very efficient for molecules, but is currently unreliable and therefore should be considered experimental.

• Removed interface to FindSym due to lack of users and maintainers. If you need this, please find it in git history, make it work, and write tests.

• The tangent estimates used to make the nudged elastic band (NEB) plots are slightly improved to use center, rather than forward differences. This does not affect how NEBs are run; only how they are displayed.

• ase.neb.NEBTools now allows the simultaneous plotting of all bands from a trajectory of a nudged elastic band calculation (or similar); this funciton is also available at the command line as ase nebplot neb.traj.

• The image-dependent pair-potential (IDPP) interpolation scheme for connecting states—i.e., in a saddle-point search—has been moved into the method ase.neb.idpp_interpolate(). This method is a more feature-rich version than that accessible via ase.neb.NEB.interpolate().

• Reduced code duplication in the ase.ga module by incorporating the ‘bulk’ GA functionality into the corresponding ‘standard’ modules. Using the now deprecated ‘bulk’ GA modules (i.e. ase.ga.bulk_startgenerator, ase.ga.bulk_crossovers, ase.ga.bulk_mutations and ase.ga.bulk_utilities) raises a warning with pointers to the corresponding ‘standard’ modules.

• Extended the genetic algorithm to cases where 1 or 2 cell vectors are part of the global optimization problem, which can be useful in searching for nanowire and thin film structures.

• Added a new tutorial on molecular crystal structure prediction using a genetic algorithm, see Genetic algorithm search for molecular crystal structures.

• Allow setting the initial hessian in $$optimize.BFGS$$ via the keyword $$alpha$$ or explicitly via $$opt.H0 = ...$$ after instantiation.

Command-line interface:

• New dimensionality sub-command for the ase command line interface.

• Added a diff CLI for displaying and comparing the positions, forces, and energies of atoms objects. The classes and functions used in the CLI are also available in ase.cli.template.

I/O:

• The ase db db1.db <selection> --insert-into db2.db command now respects --limit and --offset.

• Read and write support for qball sys file format.

• Added write support for the Vasp 5 XDATCAR file format.

• Added support for writing prismatic and computem xyz file. Required arguments to write mustem xtl file have been updated to be consistent with prismatic and computem xyz file export.

• Removed ETSF format reader since it depends on ScientificPython which requires Python 2.7.

• Removed Dacapo-NetCDF reader which has not worked since ancient times.

GUI:

• Use Ctrl+C, Ctrl+X, and Ctrl+V to copy/cut/paste atoms using the operating system’s clipboard. The copies use the JSON format.

• Removed old GUI modules which were never fully ported to Tkinter. If you miss them, please find them in git history and rehabilitate them.

Calculators:

• Multiple improvements and bugfixes to OpenMX calculator; OpenMX calculator now supports OpenMX 3.9.

• Added ORCA calculator.

• Added GAMESS-US calculator.

• Removed interface to Dacapo due to lack of users and maintainers.

• Completely refactored Gaussian calculator. The new calculator should be completely backwards compatible with the previous one, while having a more flexible design and supporting more keyword arguments.

• Added GaussianOptimizer and GaussianIRC classes for performing geometry optimization and IRC calculations with the Gaussian calculator. These classes are the canonical way to use Gaussian’s built-in geometry optimization routines.

• Fixed kpts option of ase.calculators.espresso.Espresso so that specifying a Γ-point calculation with kpts=(1, 1, 1) does not enable the optimized codepath (which halves memory and cpu). Use kpts=None to enable the optimized codepath.

• Added the properties stresses and energies to the Lennard-Jones potential ase.calculators.lj.LennardJones. Functionality for other properties should be unchanged. Testing and documentation have also been expanded.

## Version 3.19.2¶

22 July 2020: 3.19.2

• Compatibility fixes related to matplotlib: Update png writer to be compatible with matplotlib 3.3.0. Update incompatible calls to matplotlib.use().

## Version 3.19.1¶

4 April 2020: 3.19.1

• Update png writer to be compatible with matplotlib 3.2.

## Version 3.19.0¶

16 December 2019: 3.19.0

General changes:

• ase.build.bulk() now supports elements with tetragonal and rhombohedral lattices.

• The rank and size constants from the ase.parallel module have been deprecated. Use world.rank and world.size instead (and from ase.parallel import world).

• atoms.set_masses('most_common') now sets the masses of each element according to most common isotope as stored in ase.data.atomic_masses_common.

• ase.utils.parsemath added to utils. This module parses simple mathematical expressions and returns their numerical value.

• Plotting functions (such as band structure, EOS, …) no longer show the figure by default.

• Atoms constructor now accepts velocities as keyword.

• Documentation: New set of introductory ASE tutorials.

• More detailed output of ase info --formats.

• For completeness, ase.lattice now also supports the 1D Bravais lattice.

Algorithms:

• Added DiffusionCoefficient so one can calculate atom/molecule mobility from trajectory as a function of time.

• Added general linear parametric constraints ase.constraints.FixParametricRelations, ase.constraints.FixScaledParametricRelations, and ase.constraints.FixCartesianParametricRelations to ase.constraints. These constraints are based off the work in: arXiv: 1908.01610, and allows for the positions and cell of a structure to be optimized in a reduced parameter space.

• Added ase.build.graphene() for building graphene monolayers.

• Added ase.md.switch_langevin module for thermodynamic integration via MD simulations.

• Implemented “dynamic” or “ideal gas” contribution from atomic momenta to stress tensor Use <ase.Atoms.get_stress>(), e.g., atoms.get_stress(include_ideal_gas=True).

Calculators:

• Added Q-Chem calculator.

• Added Psi4 calculator.

• Added DemonNano calculator.

• Added OpenKIM calculator, a special calculator for OpenKim models.

• Gulp calculator now provides stress tensor.

• The NWChem calculator has been completely rewritten, and now supports DFT, SCF (Hartree Fock), MP2, CCSD, and TCE calculations with gaussian-type orbitals. The calculator also now supports plane-wave calculations, including band structure calculations through ASE’s BandStructure utilities. To facilitate these changes, the format of the calculator keywords has been changed. Please read the updated NWChem calculator documentation for more details.

• Siesta calculator refactored. The Siesta calculator now supports the band structure machinery. There is only a single Siesta calculator now covering all versions of Siesta, consistently with other ASE calculators.

• Added mixing module for the linear combination of arbitrary calculators.

• New ase.calculators.idealgas.IdealGas calculator for non-interacting atoms. The calculator does nothing. This can be useful for testing.

• EMT calculator now support atom-specific energies as per atoms.get_energies().

I/O:

• Read and write support for RMCProfile (rmc6f) file format.

• Write support for Materials Studio xtd files.

• More efficient storage of the “data” part of rows in the ase.db database. NumPy arrays are now stored in binary format instead of as text thereby using approximately a factor of two less space when storing numbers of np.float64.

• The pov module can now render high-order bonds.

• Atoms now provides the general-purpose JSON mechanism from ase.io.jsonio.

• Added ase.data.pubchem module to search for structures in the PubChem database.

GUI:

• It is now possible to copy and paste atoms: The “add atoms” function (Ctrl+A) will suggest the atoms in the current selection by default.

## Version 3.18.2¶

15 December 2019: 3.18.2

• Fix an issue with the binary package (wheel) of 3.18.1. No bugfixes as such.

## Version 3.18.1¶

20 September 2019: 3.18.1

• Multiple bugfixes. Most importantly, deprecate atoms.cell.pbc in order to avoid complexities from dealing with two ways of manipulating this piece of information. Use atoms.pbc instead; this works the same as always. Also, the Cell object now exposes almost the entire ndarray interface. For a list of smaller bugfixes, see the git log.

## Version 3.18.0¶

19 July 2019: 3.18.0

General changes:

• ASE no longer supports Python2.

• atoms.cell is now a Cell object. This object resembles a 3x3 array and also provides shortcuts to many common operations.

• Preliminary Formula type added. Collects all formula manipulation functionality in one place.

• Symbols objects, like atoms.symbols, now have a formula attribute.

• Added classes to represent primitive Bravais lattices and data relating to Brillouin zones to ase.lattice. Includes 2D lattices.

• New BandPath class to represent a band path specification like 'GXL' along with actual k-point coordinates. BandStructure objects now have a band path.

• ase.dft.kpoints.bandpath() now returns a BandPath object. Generation of band paths now works for (almost) any cell.

• Use atoms.cell.bandpath() as a shortcut to generate band paths.

• New holonomic constraint for trilinear molecules.

• Added ase info --calculators option which shows a list of calculators and whether they appear to be installed.

• Added ase.build.surfaces_with_termination.surfaces_with_termination(), a tool to build surfaces with a particular termination.

• Use the shortcut with ase.utils.workdir('mydir', mkdir=True): <code> to temporarily change directories.

• The ase test command now properly autocompletes test names and calculator names.

• Added keyword, atoms.wrap(pretty_translation=True), to minimize the scaled positions of the atoms.

Calculators:

• Added interface to ACE-Molecule.

• NWChem calculator now supports TDDFT runs.

• Multiple improvements to the ONETEP Calculator. Input files can now be written that specify LDOS, bsunfolding and many other functionalities.

• Calculation of stress tensor implemented for EMT potential.

• The Octopus calculator now provides the stress tensor.

• Reworked LAMMPS calculator. The calculator should now behave more consistently with other ASE calculators.

• Gromacs calculator updated to work with newer Gromacs.

• Fleur calculator updated to work with newer Fleur.

• Added ACN, a QM/MM forcefield for acetonitrile.

• Improved eigenvalue parsing with Siesta calculator.

Algorithms:

• Determine Bravais lattice for any 2D or 3D cell using atoms.cell.get_bravais_lattice().

• Added function to Minkowski reduce a cell.

• Improved stability of Niggli reduction algorithm.

• Supercell generation using ase.build.make_supercell() now uses a constructive algorithm instead of cutting which was prone to tolerance errors.

• Setting an MD velocity distribution now preserves the temperature by default.

• Analysis tool for extracting bond lengths and angles from atoms.

• Dynamics and structure optimizers can now run as an iterator using the new irun() mechanism:

for conv in opt.irun(fmax=0.05):
print('hello')


This makes it easier to execute custom code during runs. The conv variable indicates whether the current iteration meets the convergence criterion, although this behaviour may change in future versions.

• The genetic algorithm module ase.ga now has operators for crystal structure prediction. See Genetic algorithm search for bulk crystal structures.

• New ase.utils.deltacodesdft.delta() function: Calculates the difference between two DFT equation-of-states. See the new Calculating Delta-values tutorial.

• Holonomic FixLinearTriatomic for QM/MM calculations.

• The NeighborList now uses kdtree from Scipy for improved performance. It also uses Minkowsky reduction to improve performance for unusually shaped cells.

I/O:

• Database supports user defined tables

• Support for reading and writing DL_POLY format.

• Support for reading CP2K DCD format.

• Support for EON .con files with multiple images.

• Support for writing Materials Studio xtd format.

• Improved JSON support. Command line tool tools like ase band-structure and ase reciprocal now work with JSON representations of band structures and paths.

• Support reading CIF files through the Pycodcif library. This can be useful for CIF features that are not supported by the internal CIF parser.

• MySQL and MariaDB are supported as database backend

• Support for writing isosurface information to POV format with ase.io.pov.add_isosurface_to_pov()

GUI:

• Quickinfo dialog automatically updates when switching image.

• Display information about custom arrays on Atoms objects; allow colouring by custom arrays.

• Improved color scales.

## Version 3.17.0¶

12 November 2018: 3.17.0

General changes:

• atoms.symbols is now an array-like object which works like a view of atoms.numbers, but based on chemical symbols. This enables convenient shortcuts such as mask = atoms.symbols == 'Au' or atoms.symbols[4:8] = 'Mo'.

• Test suite now runs in parallel.

• New DOS object for representing and plotting densities of states.

• Neighbor lists can now get connectivity matrices.

• ase convert now provides options to execute custom code on each processed image.

• Phonons class now uses the DOS and BandStructure machinery.

• Positions and velocities can now be initialized from phononic force constant matrix; see PhononHarmonics().

Algorithms:

Calculators:

• Added ase.calculators.qmmm.ForceQMMM force-based QM/MM calculator.

• Socked-based interface to certain calculators through the socketio module: Added support for communicating coordinates, forces and other quantities over sockets using the i-PI protocol. This removes the overhead for starting and stopping calculators for each geometry step. The calculators which best support this feature are Espresso, Siesta, and Aims.

• Added calculator for OpenMX.

• Updated the Castep calculator as well as the related I/O methods in order to be more forgiving and less reliant on the presence of a CASTEP binary. The castep_keywords.py file has been replaced by a JSON file, and if its generation fails CASTEP files can still be read and written if higher tolerance levels are set for the functions that manipulate them.

• Espresso and dftb now support the BandStructure machinery including improved handling of kpoints, get_eigenvalues(), and friends.

I/O:

• CIF reader now parses fractional occupancies if present. The GUI visualizes fractional occupancies in the style of Pacman.

• Support for downloading calculations from the Nomad archive. Use ase nomad-get nmd://<uri> ... to download one or more URIs as JSON files. Use the ase.nomad module to download and work with Nomad entries programmatically. nomad-json is now a recognized IO format.

• Sequences of atoms objects can now be saved as animations using the mechanisms offered by matplotlib. gif and mp4 are now recognized output formats.

Database:

• The ase.db.core.Database.write() method now takes a id that allows you to overwrite an existing row.

• The ase.db.core.Database.update() can now update the Atoms and the data parts of a row.

• The ase.db.core.Database.update() method will no longer accept a list of row ID’s as the first argument. Replace this:

db.update(ids, ...)


with:

with db:
for id in ids:
db.update(id, ...)

• New --show-keys and --show-values=... options for the ase db command line interface.

• Optimized performance of ase db, with enhanced speed of queries on key value pairs for large SQLite (.db) database files. Also, The ase db server (PostgreSQL) backend now uses native ARRAY and JSONB data types for storing NumPy arrays and dictionaries instead of the BYTEA datatype. Note that backwards compatibility is lost for the postgreSQL backend, and that postgres version 9.4+ is required.

GUI:

• Added callback method ase.gui.gui.GUI.repeat_poll() to the GUI. Useful for programmatically updating the GUI.

• Improved error handling and communication with subprocesses (for plots) in GUI.

## Version 3.16.2¶

4 June 2018: 3.16.2

• Fix test failure for newer versions of flask due to error within the test itself. Fix trajectory format on bigendian architectures. Fix issue with trajectory files opened in append mode where header would not be written correctly for images with different length, atomic species, boundary conditions, or constraints.

## Version 3.16.0¶

21 March 2018: 3.16.0

• New linear-scaling neighbor list available as a function neighbor_list().

• Castep calculator: option for automatic detection of pseudopotential files from a given directory (castep_pp_path); support for GBRV pseudopotential library; updated outfile parsing to comply with CASTEP 18.1.

• New LAMMPS calculator LAMMPSlib utilizing the Python bindings provided by LAMMPS instead of file I/O. Very basic calculator but can serve as base class for more sophisticated ones.

• Support for µSTEM xtl data format.

• New scanning tunnelling spectroscopy (STS) mode for STM simulations.

• New method, get_angles(), for calculating multiple angles.

• New ase reciprocal command for showing the 1. Brilluin zone, k-points and special points.

• New ase convert command for converting between file formats.

• Improved XRD/SAXS module: ase.utils.xrdebye.

• New cell editor for the GUI.

• Improved “quick info” dialog in the GUI. The dialog now lists results cached by the calculator.

• The “add atoms” dialog now offers a load file dialog as was the case before the tkinter port. It also provides a chooser for the G2 dataset.

• Interface for the CRYSTAL <ase.calculators.crystal code has been added.

• The ase.dft.bandgap.bandgap() function used with direct=True will now also consider spin-flip transitions. To get the spin-preserving direct gap (the old behavior), use:

min(bandgap(..., spin=s, direct=True) for s in [0, 1])

• Bug fixed in the ase.phonons.Phonons.symmetrize() method when using an even number of repeats.

## Version 3.15.0¶

28 September 2017: 3.15.0

## Version 3.14.1¶

28 June 2017: 3.14.1.

## Version 3.14.0¶

20 June 2017: 3.14.0.

• Python 2.6 no longer supported.

• The command-line tools ase-??? have been replaced by a single ase command with sub-commands (see Command line tool). For help, type:

$ase --help$ ase sub-command --help

• The old ase-build command which is now called ase build will no longer add vacuum by default. Use ase build -V 3.0 to get the old behavior.

• All methods of the Atoms object that deal with angles now have new API’s that use degrees instead of radians as the unit of angle (get_angle(), set_angle(), get_dihedral(), set_dihedral(), rotate_dihedral(), rotate(), euler_rotate()).

The old way of calling these methods works as always, but will give you a warning. Example:

>>> water.get_angle(0, 1, 2)  # new API
104.52
>>> water.get_angle([0, 1, 2])  # old API
/home/jensj/ase/ase/atoms.py:1484: UserWarning: Please use new API (which will return the angle in degrees): atoms_obj.get_angle(a1,a2,a3)*pi/180 instead of atoms_obj.get_angle([a1,a2,a3])
1.8242181341844732


Here are the changes you need to make in order to get rid of warnings:

Old API:

>>> a1 = atoms.get_angle([0, 1, 2])
>>> atoms.set_angle([0, 1, 2], pi / 2)
>>> a2 = atoms.get_dihedral([0, 1, 2, 3])
>>> atoms.set_dihedral([0, 1, 2, 3], pi / 6)
>>> atoms.rotate_dihedral([0, 1, 2, 3], 10.5 * pi / 180)
>>> atoms.rotate('z', pi / 4)
>>> atoms.rotate_euler(phi=phi, theta=theta, psi=psi)


New API:

>>> a1 = atoms.get_angle(0, 1, 2) * pi / 180
>>> atoms.set_angle(0, 1, 2, angle=90)
>>> a2 = atoms.get_dihedral(0, 1, 2, 3) * pi / 180
>>> atoms.set_dihedral(0, 1, 2, 3, angle=30)
>>> atoms.rotate_dihedral(0, 1, 2, 3, angle=10.5)
>>> atoms.rotate(45, 'z')
>>> atoms.euler_rotate(phi=phi * 180 / pi,
...                    theta=theta * 180 / pi,
...                    psi=psi * 180 / pi)

• The web-interface to the ase.db module now uses Bootstrap and looks much nicer. Querying the database is also much easier. See https://cmrdb.fysik.dtu.dk for an example.

• The PostgreSQL backend for ase.db can now contain more than one ASE database.

• An ASE database can now have Metadata describing the data. Metadata is a dict with any of the following keys: title, key_descriptions, default_columns, special_keys and layout.

• ase.data.atomic_masses has been updated to IUPAC values from 2016. Several elements will now have different weights which will affect dynamic calculations. The old values can be recovered like this:

>>> from ase.data import atomic_masses_legacy
>>> atoms.set_masses(atomic_masses_legacy[atoms.numbers])

• New ase.data.isotopes.download_isotope_data() function for getting individual isotope masses from NIST.

• New ase.eos.calculate_eos() helper function added.

• Added DeltaCodesDFT data: ase.collections.dcdft.

• ase.gui can now load and display any sequence of Atoms objects; it is no longer restricted to sequences with a constant number of atoms or same chemical composition.

• Trajectory files can now store any sequence of Atoms objects. Previously, atomic numbers, masses, and constraints were only saved for the first image, and had to apply for all subsequent ones.

• Added calculator interface for DMol3.

• Added calculator interface for GULP.

• Added file formats .car, .incoor, and .arc, related to DMol3.

• New function for interpolating from Monkhors-Pack sampled values in the BZ to arbitrary points in the BZ: ase.dft.kpoints.monkhorst_pack_interpolate().

• New band-structure command for the ase Command line tool.

• Two new functions for producing chemical formulas: ase.utils.formula_hill() and ase.utils.formula_metal().

• The ase.dft.bandgap.get_band_gap() function is now deprecated. Use the new one called ase.dft.bandgap.bandgap() (it’s more flexible and returns also band indices).

## Version 3.13.0¶

7 February 2017: 3.13.0.

## Version 3.12.0¶

24 October 2016: 3.12.0.

## Version 3.11.0¶

10 May 2016: 3.11.0.

## Version 3.10.0¶

17 Mar 2016: 3.10.0.

## Version 3.9.1¶

21 July 2015: 3.9.1.

## Version 3.9.0¶

28 May 2015: 3.9.0.

## Version 3.8.0¶

22 October 2013: 3.8.0.

• ASE’s gui renamed from ag to ase-gui.

• New STM module.

• Python 2.6 is now a requirement.

• The old ase.build.bulk function is now deprecated. Use the new one instead (ase.lattice.bulk()).

• We’re now using BuildBot for continuous integration: https://ase-buildbot.fysik.dtu.dk/waterfall

• New interface to the JDFTx code.

## Version 3.7.0¶

13 May 2013: 3.7.0.

## Version 3.6.0¶

24 Feb 2012: 3.6.0.

• ASE GUI translations added, available: da_DK, en_GB, es_ES.

• New function for making surfaces with arbitrary Miller indices with the smallest possible surface unit cell: ase.build.surface()

• New ase.lattice.bulk() function. Will replace old ase.build.bulk() function. The new one will produce a more natural hcp lattice and it will use experimental data for crystal structure and lattice constants if not provided explicitly.

• New values for ase.data.covalent_radii from Cordeo et al..

• New command line tool: Command line tool and tests based on it: abinit, elk, fleur, nwchem.

• New crystal builder for ase-gui

• Van der Waals radii in ase.data

• ASE’s GUI (ase-gui) now supports velocities for both graphs and coloring

• Cleaned up some name-spaces:

## Version 3.5.1¶

24 May 2011: 3.5.1.

• Problem with parallel vibration calculations fixed.

## Version 3.5.0¶

13 April 2011: 3.5.0.

• Improved EMT potential: uses a NeighborList object and is now ASAP compatible.

• ase.optimize.BFGSLineSearch> is now the default (QuasiNewton==BFGSLineSearch).

• There is a new interface to the LAMMPS molecular dynamics code.

• New ase.phonons module.

• Van der Waals corrections for DFT, see GPAW usage.

• New BundleTrajectory added.

• Updated GUI:

• Stability and usability improvements.

• Povray render facility.

• Updated expert user mode.

• Enabled customization of colours and atomic radii.

• Enabled user default settings via ~/.ase/gui.py.

• Database library expanded to include:

• The s22, s26 and s22x5 sets of van der Waals bonded dimers and complexes by the Hobza group.

• The DBH24 set of gas-phase reaction barrier heights by the Truhlar group.

• Implementation of the Dimer method.

## Version 3.4.1¶

11 August 2010: 3.4.1.