Manual:Updating to a new version

From OctopusWiki
Revision as of 11:40, 19 February 2008 by Xavier (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Some changes were introduced in Octopus 3.0 that make it uncompatible with files from previous version. This page lists this changes and aims to help with the transition.

Input variables

Some variables changed name or change format. If an obsolete variable is found, Octopus will stop and will tell you the variable that replaces it.

  • Units, UnitsInput and UnitsOutput now take a named option as argument instead of a string. So
Units = "eVA"

should be replaced by

Units = ev_angstrom

. The code will stop if the old format is encountered.

  • XFunctional and CFunctional were replaced by XCFunctional, for example
XFunctional = lda_x
CFunctional = lda_c_vwn

must be replaced with

XCFunctional = lda_x + lda_c_vwn

.

  • TDLasers

Output directories

Some directories in octopus output were renamed, restart files now are stored under restart/ instead of tmp/. Files previously found under status/ are now located in exec/.

Restart file format

Octopus writes restart files in a binary format, this format has been updated and improved. As a result Octopus is no longer able to restart automatically the calculation of a run performed with older versions.

Recovering old restart files

If you really need to recover your old restart files, first you have to generate NetCDF restart files with your old version of Octopus. Then you will have to rename the tmp/ directory to restart/ and remove the restart_ prefix from its subdirectories, for example tmp/restart_gs/ now should be called restart/gs/.

Now you can run Octopus 3.0 and it will find your restart information.