init_simulation_from_checkpoint

tenpy.simulations.simulation.init_simulation_from_checkpoint(*, filename=None, checkpoint_results=None, update_sim_params=None, simulation_class_kwargs=None)[source]

Re-initialize a simulation from a given checkpoint without running it.

(All parameters have to be given as keyword arguments.)

If you need to run the simulation, you can use a with statement for proper context management:

with sim:
    results = sim.run()
Parameters:
  • filename (None | str) – The filename of the checkpoint to be loaded. You can either specify the filename or the checkpoint_results.

  • checkpoint_results (None | dict) – Alternatively to filename the results of the simulation so far, i.e. directly the data dictionary saved at a simulation checkpoint.

  • update_sim_params (None | dict) – Allows to update specific Simulation parameters; ignored if None. Uses update_recursive() to update values, such that the keys of update_sim_params can be recursive, e.g. algorithm_params/max_sweeps.

  • simulation_class_kwargs (None | dict) – Further keyword arguments given to the simulation class, ignored if None.

Returns:

The results from running the simulation, i.e., what tenpy.simulations.Simulation.resume_run() returned.

Return type:

results

Notes

The checkpoint_filename should be relative to the current working directory. If you use the Simulation.directory, the simulation class will attempt to change to that directory during initialization. Hence, either resume the simulation from the same directory where you originally started, or update the Simulation.directory (and :cfg:option`Simulation.output_filename`) parameter with update_sim_params.