def run_experiment(experiment, configs, args, mods=None, **kwargs):
config = Config(file_=args.config) if args.config is not None else Config()
config.update_missing(configs[args.default_config])
if args.mods is not None:
for mod in args.mods:
config.update(mods[mod])
config = Config(config=config, update_from_argv=True)
# GET EXISTING EXPERIMENTS TO BE ABLE TO SKIP CERTAIN CONFIGS
if args.skip_existing:
existing_configs = []
for exp in os.listdir(args.base_dir):
try:
existing_configs.append(
Config(file_=os.path.join(args.base_dir, exp, "config",
"config.json")))
except Exception as e:
pass
if args.grid is not None:
grid = GridSearch().read(args.grid)
else:
grid = [{}]
for combi in grid:
config.update(combi)
if args.skip_existing:
skip_this = False
for existing_config in existing_configs:
if existing_config.contains(config):
skip_this = True
break
if skip_this:
continue
loggers = {}
if args.visdomlogger:
loggers["visdom"] = ("visdom", {}, 1)
exp = experiment(config=config,
base_dir=args.base_dir,
resume=args.resume,
ignore_resume_config=args.ignore_resume_config,
loggers=loggers,
**kwargs)
if not args.test:
exp.run()
else:
exp.run_test()
def run_experiment(experiment, configs, args, mods=None, **kwargs):
# set a few defaults
if "explogger_kwargs" not in kwargs:
kwargs["explogger_kwargs"] = dict(
folder_format="{experiment_name}_%Y%m%d-%H%M%S")
if "explogger_freq" not in kwargs:
kwargs["explogger_freq"] = 1
if "resume_save_types" not in kwargs:
kwargs["resume_save_types"] = ("model", "simple", "th_vars", "results")
config = Config(file_=args.config) if args.config is not None else Config()
config.update_missing(configs[args.default_config].deepcopy())
if args.mods is not None and mods is not None:
for mod in args.mods:
config.update(mods[mod])
config = Config(config=config, update_from_argv=True)
# GET EXISTING EXPERIMENTS TO BE ABLE TO SKIP CERTAIN CONFIGS
if args.skip_existing:
existing_configs = []
for exp in os.listdir(args.base_dir):
try:
existing_configs.append(
Config(file_=os.path.join(args.base_dir, exp, "config",
"config.json")))
except Exception as e:
pass
if args.grid is not None:
grid = GridSearch().read(args.grid)
else:
grid = [{}]
for combi in grid:
config.update(combi)
if args.skip_existing:
skip_this = False
for existing_config in existing_configs:
if existing_config.contains(config):
skip_this = True
break
if skip_this:
continue
if "backup_every" in config:
kwargs["save_checkpoint_every_epoch"] = config["backup_every"]
loggers = {}
if args.visdomlogger:
loggers["v"] = ("visdom", {}, 1)
if args.tensorboardxlogger is not None:
if args.tensorboardxlogger == "same":
loggers["tx"] = ("tensorboard", {}, 1)
else:
loggers["tx"] = ("tensorboard", {
"target_dir": args.tensorboardxlogger
}, 1)
if args.telegramlogger:
kwargs["use_telegram"] = True
if args.automatic_description:
difference_to_default = Config.difference_config_static(
config, configs["DEFAULTS"]).flat(keep_lists=True,
max_split_size=0,
flatten_int=True)
description_str = ""
for key, val in difference_to_default.items():
val = val[0]
description_str = "{} = {}\n{}".format(key, val,
description_str)
config.description = description_str
exp = experiment(config=config,
base_dir=args.base_dir,
resume=args.resume,
ignore_resume_config=args.ignore_resume_config,
loggers=loggers,
**kwargs)
trained = False
if args.resume is None or args.test is False:
exp.run()
trained = True
if args.test:
exp.run_test(setup=not trained)
if isinstance(args.resume,
str) and exp.elog is not None and args.copy_test:
for f in glob.glob(os.path.join(exp.elog.save_dir, "test*")):
if os.path.isdir(f):
shutil.copytree(
f,
os.path.join(args.resume, "save",
os.path.basename(f)))
else:
shutil.copy(f, os.path.join(args.resume, "save"))
class PytorchExperiment(Experiment):
"""
A PytorchExperiment extends the basic
functionality of the :class:`.Experiment` class with
convenience features for PyTorch (and general logging) such as creating a folder structure,
saving, plotting results and checkpointing your experiment.
The basic life cycle of a PytorchExperiment is the same as
:class:`.Experiment`::
setup()
prepare()
for epoch in n_epochs:
train()
validate()
end()
where the distinction between the first two is that between them
PytorchExperiment will automatically restore checkpoints and save the
:attr:`_config_raw` in :meth:`._setup_internal`. Please see below for more
information on this.
To get your own experiment simply inherit from the PytorchExperiment and
overwrite the :meth:`.setup`, :meth:`.prepare`, :meth:`.train`,
:meth:`.validate` method (or you can use the `very` experimental decorator
:func:`.experimentify` to convert your class into a experiment).
Then you can run your own experiment by calling the :meth:`.run` method.
Internally PytorchExperiment will provide a number of member variables which
you can access.
- n_epochs
Number of epochs.
- exp_name
Name of your experiment.
- config
The (initialized) :class:`.Config` of your experiment. You can
access the uninitialized one via :attr:`_config_raw`.
- result
A dict in which you can store your result values. If a
:class:`.PytorchExperimentLogger` is used, results will be a
:class:`.ResultLogDict` that directly automatically writes to a file
and also stores the N last entries for each key for quick access
(e.g. to quickly get the running mean).
- vlog (if use_visdomlogger is True)
A :class:`.PytorchVisdomLogger` instance which can log your results
to a running visdom server. Start the server via
:code:`python -m visdom.server` or pass :data:`auto_start=True` in
the :attr:`visdomlogger_kwargs`.
- elog (if use_explogger is True)
A :class:`.PytorchExperimentLogger` instance which can log your
results to a given folder.
- tlog (if use_telegrammessagelogger is True)
A :class:`.TelegramMessageLogger` instance which can send the results to
your telegram account
- clog
A :class:`.CombinedLogger` instance which logs to all loggers with
different frequencies (specified with the :attr:`_c_freq` for each
logger where 1 means every time and N means every Nth time,
e.g. if you only want to send stuff to Visdom every 10th time).
The most important attribute is certainly :attr:`.config`, which is the
initialized :class:`.Config` for the experiment. To understand how it needs
to be structured to allow for automatic instantiation of types, please refer
to its documentation. If you decide not to use this functionality,
:attr:`config` and :attr:`_config_raw` are identical. **Beware however that
by default the Pytorchexperiment only saves the raw config** after
:meth:`.setup`. If you modify :attr:`config` during setup, make sure
to implement :meth:`._setup_internal` yourself should you want the modified
config to be saved::
def _setup_internal(self):
super(YourExperiment, self)._setup_internal() # calls .prepare_resume()
self.elog.save_config(self.config, "config")
Args:
config (dict or Config): Configures your experiment. If :attr:`name`,
:attr:`n_epochs`, :attr:`seed`, :attr:`base_dir` are given in the
config, it will automatically
overwrite the other args/kwargs with the values from the config.
In addition (defined by :attr:`parse_config_sys_argv`) the config
automatically parses the argv arguments and updates its values if a
key matches a console argument.
name (str):
The name of the PytorchExperiment.
n_epochs (int): The number of epochs (number of times the training
cycle will be executed).
seed (int): A random seed (which will set the random, numpy and
torch seed).
base_dir (str): A base directory in which the experiment result folder
will be created.
globs: The :func:`globals` of the script which is run. This is necessary
to get and save the executed files in the experiment folder.
resume (str or PytorchExperiment): Another PytorchExperiment or path to
the result dir from another PytorchExperiment from which it will
load the PyTorch modules and other member variables and resume
the experiment.
ignore_resume_config (bool): If :obj:`True` it will not resume with the
config from the resume experiment but take the current/own config.
resume_save_types (list or tuple): A list which can define which values
to restore when resuming. Choices are:
- "model" <-- Pytorch models
- "optimizer" <-- Optimizers
- "simple" <-- Simple python variables (basic types and lists/tuples
- "th_vars" <-- torch tensors/variables
- "results" <-- The result dict
parse_sys_argv (bool): Parsing the console arguments (argv) to get a
:attr:`config path` and/or :attr:`resume_path`.
parse_config_sys_argv (bool): Parse argv to update the config
(if the keys match).
checkpoint_to_cpu (bool): When checkpointing, transfer all tensors to
the CPU beforehand.
safe_checkpoint_every_epoch (int): Determines after how many epochs a
checkpoint is stored.
use_visdomlogger (bool): Use a :class:`.PytorchVisdomLogger`. Is
accessible via the :attr:`vlog` attribute.
visdomlogger_kwargs (dict): Keyword arguments for :attr:`vlog`
instantiation.
visdomlogger_c_freq (int): The frequency x (meaning one in x) with which
the :attr:`clog` will call the :attr:`vlog`.
use_explogger (bool): Use a :class:`.PytorchExperimentLogger`. Is
accessible via the :attr:`elog` attribute. This will create the
experiment folder structure.
explogger_kwargs (dict): Keyword arguments for :attr:`elog`
instantiation.
explogger_c_freq (int): The frequency x (meaning one in x) with which
the :attr:`clog` will call the :attr:`elog`.
use_telegrammessagelogger (bool): Use a :class:`.TelegramMessageLogger`. Is
accessible via the :attr:`tlog` attribute.
telegrammessagelogger_kwargs (dict): Keyword arguments for :attr:`tlog`
instantiation.
telegrammessagelogger_c_freq (int): The frequency x (meaning one in x) with which
the :attr:`clog` will call the :attr:`tlog`.
append_rnd_to_name (bool): If :obj:`True`, will append a random six
digit string to the experiment name.
"""
def __init__(self,
config=None,
name=None,
n_epochs=None,
seed=None,
base_dir=None,
globs=None,
resume=None,
ignore_resume_config=False,
resume_save_types=("model", "optimizer", "simple", "th_vars",
"results"),
resume_reset_epochs=True,
parse_sys_argv=False,
parse_config_sys_argv=True,
checkpoint_to_cpu=True,
safe_checkpoint_every_epoch=1,
use_visdomlogger=True,
visdomlogger_kwargs=None,
visdomlogger_c_freq=1,
use_explogger=True,
explogger_kwargs=None,
explogger_c_freq=100,
use_telegrammessagelogger=False,
telegrammessagelogger_kwargs=None,
telegrammessagelogger_c_freq=1000,
append_rnd_to_name=False):
# super(PytorchExperiment, self).__init__()
Experiment.__init__(self)
if parse_sys_argv:
config_path, resume_path = get_vars_from_sys_argv()
if config_path:
config = config_path
if resume_path:
resume = resume_path
self._config_raw = None
if isinstance(config, str):
self._config_raw = Config(file_=config,
update_from_argv=parse_config_sys_argv)
elif isinstance(config, Config):
self._config_raw = Config(config=config,
update_from_argv=parse_config_sys_argv)
elif isinstance(config, dict):
self._config_raw = Config(config=config,
update_from_argv=parse_config_sys_argv)
else:
self._config_raw = Config(update_from_argv=parse_config_sys_argv)
self.n_epochs = n_epochs
if 'n_epochs' in self._config_raw:
self.n_epochs = self._config_raw["n_epochs"]
if self.n_epochs is None:
self.n_epochs = 0
self._seed = seed
if 'seed' in self._config_raw:
self._seed = self._config_raw.seed
if self._seed is None:
random_data = os.urandom(4)
seed = int.from_bytes(random_data, byteorder="big")
self._config_raw.seed = seed
self._seed = seed
self.exp_name = name
if 'name' in self._config_raw:
self.exp_name = self._config_raw["name"]
if append_rnd_to_name:
rnd_str = ''.join(
random.choice(string.ascii_letters + string.digits)
for _ in range(5))
self.exp_name += "_" + rnd_str
if 'base_dir' in self._config_raw:
base_dir = self._config_raw["base_dir"]
self._checkpoint_to_cpu = checkpoint_to_cpu
self._safe_checkpoint_every_epoch = safe_checkpoint_every_epoch
self.results = dict()
# Init loggers
logger_list = []
self.vlog = None
if use_visdomlogger:
if visdomlogger_kwargs is None:
visdomlogger_kwargs = {}
self.vlog = PytorchVisdomLogger(name=self.exp_name,
**visdomlogger_kwargs)
if visdomlogger_c_freq is not None and visdomlogger_c_freq > 0:
logger_list.append((self.vlog, visdomlogger_c_freq))
self.elog = None
if use_explogger:
if explogger_kwargs is None:
explogger_kwargs = {}
self.elog = PytorchExperimentLogger(base_dir=base_dir,
experiment_name=self.exp_name,
**explogger_kwargs)
if explogger_c_freq is not None and explogger_c_freq > 0:
logger_list.append((self.elog, explogger_c_freq))
# Set results log dict to the right path
self.results = ResultLogDict("results-log.json",
base_dir=self.elog.result_dir)
self.tlog = None
if use_telegrammessagelogger:
if telegrammessagelogger_kwargs is None:
telegrammessagelogger_kwargs = {}
self.tlog = TelegramMessageLogger(**telegrammessagelogger_kwargs,
exp_name=self.exp_name)
if telegrammessagelogger_c_freq is not None and telegrammessagelogger_c_freq > 0:
logger_list.append((self.tlog, telegrammessagelogger_c_freq))
self.clog = CombinedLogger(*logger_list)
set_seed(self._seed)
# Do the resume stuff
self._resume_path = None
self._resume_save_types = resume_save_types
self._ignore_resume_config = ignore_resume_config
self._resume_reset_epochs = resume_reset_epochs
if resume is not None:
if isinstance(resume, str):
if resume == "last":
self._resume_path = os.path.join(
base_dir,
sorted(os.listdir(base_dir))[-1])
else:
self._resume_path = resume
elif isinstance(resume, PytorchExperiment):
self._resume_path = resume.elog.base_dir
if self._resume_path is not None and not self._ignore_resume_config:
self._config_raw.update(Config(file_=os.path.join(
self._resume_path, "config", "config.json")),
ignore=list(
map(lambda x: re.sub("^-+", "", x),
sys.argv)))
# self.elog.save_config(self.config, "config_pre")
if globs is not None:
zip_name = os.path.join(self.elog.save_dir, "sources.zip")
SourcePacker.zip_sources(globs, zip_name)
# Init objects in config
self.config = Config.init_objects(self._config_raw)
atexit.register(self.at_exit_func)
def process_err(self, e):
if self.elog is not None:
self.elog.text_logger.log_to(
"\n".join(traceback.format_tb(e.__traceback__)), "err")
def update_attributes(self, var_dict, ignore=()):
"""
Updates the member attributes with the attributes given in the var_dict
Args:
var_dict (dict): dict in which the update values stored. If a key matches a member attribute name
the member attribute will be updated
ignore (list or tuple): iterable of keys to ignore
"""
for key, val in var_dict.items():
if key == "results":
self.results.load(val)
continue
if key in ignore:
continue
if hasattr(self, key):
setattr(self, key, val)
def get_pytorch_modules(self, from_config=True):
"""
Returns all torch.nn.Modules stored in the experiment in a dict.
Args:
from_config (bool): Also get modules that are stored in the :attr:`.config` attribute.
Returns:
dict: Dictionary of PyTorch modules
"""
pyth_modules = dict()
for key, val in self.__dict__.items():
if isinstance(val, torch.nn.Module):
pyth_modules[key] = val
if from_config:
for key, val in self.config.items():
if isinstance(val, torch.nn.Module):
if type(key) == str:
key = "config." + key
pyth_modules[key] = val
return pyth_modules
def get_pytorch_optimizers(self, from_config=True):
"""
Returns all torch.optim.Optimizers stored in the experiment in a dict.
Args:
from_config (bool): Also get optimizers that are stored in the :attr:`.config`
attribute.
Returns:
dict: Dictionary of PyTorch optimizers
"""
pyth_optimizers = dict()
for key, val in self.__dict__.items():
if isinstance(val, torch.optim.Optimizer):
pyth_optimizers[key] = val
if from_config:
for key, val in self.config.items():
if isinstance(val, torch.optim.Optimizer):
if type(key) == str:
key = "config." + key
pyth_optimizers[key] = val
return pyth_optimizers
def get_simple_variables(self, ignore=()):
"""
Returns all standard variables in the experiment in a dict.
Specifically, this looks for types :class:`int`, :class:`float`, :class:`bytes`,
:class:`bool`, :class:`str`, :class:`set`, :class:`list`, :class:`tuple`.
Args:
ignore (list or tuple): Iterable of names which will be ignored
Returns:
dict: Dictionary of variables
"""
simple_vars = dict()
for key, val in self.__dict__.items():
if key in ignore:
continue
if isinstance(val,
(int, float, bytes, bool, str, set, list, tuple)):
simple_vars[key] = val
return simple_vars
def get_pytorch_tensors(self, ignore=()):
"""
Returns all torch.tensors in the experiment in a dict.
Args:
ignore (list or tuple): Iterable of names which will be ignored
Returns:
dict: Dictionary of PyTorch tensor
"""
pytorch_vars = dict()
for key, val in self.__dict__.items():
if key in ignore:
continue
if torch.is_tensor(val):
pytorch_vars[key] = val
return pytorch_vars
def get_pytorch_variables(self, ignore=()):
"""Same as :meth:`.get_pytorch_tensors`."""
return self.get_pytorch_tensors(ignore)
def save_results(self, name="results.json"):
"""
Saves the result dict as a json file in the result dir of the experiment logger.
Args:
name (str): The name of the json file in which the results are written.
"""
if self.elog is None:
return
with open(os.path.join(self.elog.result_dir, name), "w") as file_:
json.dump(self.results, file_, indent=4)
def save_pytorch_models(self):
"""Saves all torch.nn.Modules as model files in the experiment checkpoint folder."""
if self.elog is None:
return
pyth_modules = self.get_pytorch_modules()
for key, val in pyth_modules.items():
self.elog.save_model(val, key)
def load_pytorch_models(self):
"""Loads all model files from the experiment checkpoint folder."""
if self.elog is None:
return
pyth_modules = self.get_pytorch_modules()
for key, val in pyth_modules.items():
self.elog.load_model(val, key)
def log_simple_vars(self):
"""
Logs all simple python member variables as a json file in the experiment log folder.
The file will be names 'simple_vars.json'.
"""
if self.elog is None:
return
simple_vars = self.get_simple_variables()
with open(os.path.join(self.elog.log_dir, "simple_vars.json"),
"w") as file_:
json.dump(simple_vars, file_)
def load_simple_vars(self):
"""
Restores all simple python member variables from the 'simple_vars.json' file in the log
folder.
"""
if self.elog is None:
return
simple_vars = {}
with open(os.path.join(self.elog.log_dir, "simple_vars.json"),
"r") as file_:
simple_vars = json.load(file_)
self.update_attributes(simple_vars)
def save_checkpoint(self,
name="checkpoint",
save_types=("model", "optimizer", "simple", "th_vars",
"results"),
n_iter=None,
iter_format="{:05d}",
prefix=False):
"""
Saves a current model checkpoint from the experiment.
Args:
name (str): The name of the checkpoint file
save_types (list or tuple): What kind of member variables should be stored? Choices are:
"model" <-- Pytorch models,
"optimizer" <-- Optimizers,
"simple" <-- Simple python variables (basic types and lists/tuples),
"th_vars" <-- torch tensors,
"results" <-- The result dict
n_iter (int): Number of iterations. Together with the name, defined by the iter_format,
a file name will be created.
iter_format (str): Defines how the name and the n_iter will be combined.
prefix (bool): If True, the formatted n_iter will be prepended, otherwise appended.
"""
if self.elog is None:
return
model_dict = {}
optimizer_dict = {}
simple_dict = {}
th_vars_dict = {}
results_dict = {}
if "model" in save_types:
model_dict = self.get_pytorch_modules()
if "optimizer" in save_types:
optimizer_dict = self.get_pytorch_optimizers()
if "simple" in save_types:
simple_dict = self.get_simple_variables()
if "th_vars" in save_types:
th_vars_dict = self.get_pytorch_variables()
if "results" in save_types:
results_dict = {"results": self.results}
checkpoint_dict = {
**model_dict,
**optimizer_dict,
**simple_dict,
**th_vars_dict,
**results_dict
}
self.elog.save_checkpoint(name=name,
n_iter=n_iter,
iter_format=iter_format,
prefix=prefix,
move_to_cpu=self._checkpoint_to_cpu,
**checkpoint_dict)
def load_checkpoint(self,
name="checkpoint",
save_types=("model", "optimizer", "simple", "th_vars",
"results"),
n_iter=None,
iter_format="{:05d}",
prefix=False,
path=None):
"""
Loads a checkpoint and restores the experiment.
Make sure you have your torch stuff already on the right devices beforehand,
otherwise this could lead to errors e.g. when making a optimizer step
(and for some reason the Adam states are not already on the GPU:
https://discuss.pytorch.org/t/loading-a-saved-model-for-continue-training/17244/3 )
Args:
name (str): The name of the checkpoint file
save_types (list or tuple): What kind of member variables should be loaded? Choices are:
"model" <-- Pytorch models,
"optimizer" <-- Optimizers,
"simple" <-- Simple python variables (basic types and lists/tuples),
"th_vars" <-- torch tensors,
"results" <-- The result dict
n_iter (int): Number of iterations. Together with the name, defined by the iter_format,
a file name will be created and searched for.
iter_format (str): Defines how the name and the n_iter will be combined.
prefix (bool): If True, the formatted n_iter will be prepended, otherwise appended.
path (str): If no path is given then it will take the current experiment dir and formatted
name, otherwise it will simply use the path and the formatted name to define the
checkpoint file.
"""
if self.elog is None:
return
model_dict = {}
optimizer_dict = {}
simple_dict = {}
th_vars_dict = {}
results_dict = {}
if "model" in save_types:
model_dict = self.get_pytorch_modules()
if "optimizer" in save_types:
optimizer_dict = self.get_pytorch_optimizers()
if "simple" in save_types:
simple_dict = self.get_simple_variables()
if "th_vars" in save_types:
th_vars_dict = self.get_pytorch_variables()
if "results" in save_types:
results_dict = {"results": self.results}
checkpoint_dict = {
**model_dict,
**optimizer_dict,
**simple_dict,
**th_vars_dict,
**results_dict
}
if n_iter is not None:
name = name_and_iter_to_filename(name,
n_iter,
".pth.tar",
iter_format=iter_format,
prefix=prefix)
if path is None:
restore_dict = self.elog.load_checkpoint(name=name,
**checkpoint_dict)
else:
checkpoint_path = os.path.join(path, name)
if checkpoint_path.endswith("/"):
checkpoint_path = checkpoint_path[:-1]
restore_dict = self.elog.load_checkpoint_static(
checkpoint_file=checkpoint_path, **checkpoint_dict)
self.update_attributes(restore_dict)
def _end_internal(self):
"""Ends the experiment and stores the final results/checkpoint"""
if isinstance(self.results, ResultLogDict):
self.results.close()
self.save_results()
self.save_end_checkpoint()
self._save_exp_config()
self.print("Experiment ended. Checkpoints stored =)")
def _end_test_internal(self):
"""Ends the experiment after test and stores the final results and config"""
self.save_results()
self._save_exp_config()
self.print("Testing ended. Results stored =)")
def at_exit_func(self):
"""
Stores the results and checkpoint at the end (if not already stored).
This method is also called if an error occurs.
"""
if self._exp_state not in ("Ended", "Tested"):
if isinstance(self.results, ResultLogDict):
self.results.print_to_file("]")
self.save_checkpoint(name="checkpoint_exit-" + self._exp_state)
self.save_results()
self._save_exp_config()
self.print("Experiment exited. Checkpoints stored =)")
time.sleep(
2
) # allow checkpoint saving to finish. We need a better solution for this :D
def _setup_internal(self):
self.prepare_resume()
if self.elog is not None:
self.elog.save_config(self._config_raw, "config")
self._save_exp_config()
def _start_internal(self):
self._save_exp_config()
def prepare_resume(self):
"""Tries to resume the experiment by using the defined resume path or PytorchExperiment."""
checkpoint_file = ""
base_dir = ""
reset_epochs = self._resume_reset_epochs
if self._resume_path is not None:
if isinstance(self._resume_path, str):
if self._resume_path.endswith(".pth.tar"):
checkpoint_file = self._resume_path
base_dir = os.path.dirname(
os.path.dirname(checkpoint_file))
elif self._resume_path.endswith(
"checkpoint") or self._resume_path.endswith(
"checkpoint/"):
checkpoint_file = get_last_file(self._resume_path)
base_dir = os.path.dirname(
os.path.dirname(checkpoint_file))
elif "checkpoint" in os.listdir(
self._resume_path) and "config" in os.listdir(
self._resume_path):
checkpoint_file = get_last_file(self._resume_path)
base_dir = self._resume_path
else:
warnings.warn(
"You have not selected a valid experiment folder, will search all sub folders",
UserWarning)
if self.elog is not None:
self.elog.text_logger.log_to(
"You have not selected a valid experiment folder, will search all "
"sub folders", "warnings")
checkpoint_file = get_last_file(self._resume_path)
base_dir = os.path.dirname(
os.path.dirname(checkpoint_file))
if base_dir:
if not self._ignore_resume_config:
load_config = Config()
load_config.load(os.path.join(base_dir, "config/config.json"))
self._config_raw = load_config
self.config = Config.init_objects(self._config_raw)
self.print("Loaded existing config from:", base_dir)
if checkpoint_file:
self.load_checkpoint(name="",
path=checkpoint_file,
save_types=self._resume_save_types)
self._resume_path = checkpoint_file
shutil.copyfile(
checkpoint_file,
os.path.join(self.elog.checkpoint_dir, "0_checkpoint.pth.tar"))
self.print("Loaded existing checkpoint from:", checkpoint_file)
self._resume_reset_epochs = reset_epochs
if self._resume_reset_epochs:
self._epoch_idx = 0
def _end_epoch_internal(self, epoch):
self.save_results()
if epoch % self._safe_checkpoint_every_epoch == 0:
self.save_temp_checkpoint()
self._save_exp_config()
def _save_exp_config(self):
if self.elog is not None:
cur_time = time.strftime("%y-%m-%d_%H:%M:%S",
time.localtime(time.time()))
self.elog.save_config(
Config(
**{
'name': self.exp_name,
'time': self._time_start,
'state': self._exp_state,
'current_time': cur_time,
'epoch': self._epoch_idx
}), "exp")
def save_temp_checkpoint(self):
"""Saves the current checkpoint as checkpoint_current."""
self.save_checkpoint(name="checkpoint_current")
def save_end_checkpoint(self):
"""Saves the current checkpoint as checkpoint_last."""
self.save_checkpoint(name="checkpoint_last")
def add_result(self,
value,
name,
counter=None,
tag=None,
label=None,
plot_result=True,
plot_running_mean=False):
"""
Saves a results and add it to the result dict, this is similar to results[key] = val,
but in addition also logs the value to the combined logger
(it also stores in the results-logs file).
**This should be your preferred method to log your numeric values**
Args:
value: The value of your variable
name (str): The name/key of your variable
counter (int or float): A counter which can be seen as the x-axis of your value.
Normally you would just use the current epoch for this.
tag (str): A label/tag which can group similar values and will plot values with the same
label in the same plot
label: deprecated label
plot_result (bool): By default True, will also log all your values to the combined
logger (with show_value).
"""
if label is not None:
warnings.warn(
"label in add_result is deprecated, please use tag instead")
if tag is None:
tag = label
tag_name = tag
if tag_name is None:
tag_name = name
r_elem = ResultElement(data=value,
label=tag_name,
epoch=self._epoch_idx,
counter=counter)
self.results[name] = r_elem
if plot_result:
if tag is None:
legend = False
else:
legend = True
if plot_running_mean:
value = np.mean(self.results.running_mean_dict[name])
self.clog.show_value(value=value,
name=name,
tag=tag_name,
counter=counter,
show_legend=legend)
def get_result(self, name):
"""
Similar to result[key] this will return the values in the results dictionary with the given
name/key.
Args:
name (str): the name/key for which a value is stored.
Returns:
The value with the key 'name' in the results dict.
"""
return self.results.get(name)
def add_result_without_epoch(self, val, name):
"""
A faster method to store your results, has less overhead and does not call the combined
logger. Will only store to the results dictionary.
Args:
val: the value you want to add.
name (str): the name/key of your value.
"""
self.results[name] = val
def get_result_without_epoch(self, name):
"""
Similar to result[key] this will return the values in result with the given name/key.
Args:
name (str): the name/ key for which a value is stores.
Returns:
The value with the key 'name' in the results dict.
"""
return self.results.get(name)
def print(self, *args):
"""
Calls 'print' on the experiment logger or uses builtin 'print' if former is not
available.
"""
if self.elog is None:
print(*args)
else:
self.elog.print(*args)