def test_from_params(load_params,
model_params,
validation_params,
log_device_placement=False,
save_params=None,
dont_run=False,
skip_check=False,
use_estimator=False):
"""
Main testing interface function.
Same as train_from_parameters; but just performs testing without training.
For documentation, see argument descriptions in train_from_params.
"""
# use tpu only if a tpu_name has been specified and not a multi-model
if isinstance(model_params, list): # multi-model mode
use_tpu = (model_params[0].get('tpu_name', None) is not None)
assert (use_tpu is False)
else:
use_tpu = (model_params.get('tpu_name', None) is not None)
if use_tpu:
log.info('Using tpu: %s' % model_params['tpu_name'])
params, test_args = parse_params('test',
model_params,
dont_run=dont_run,
skip_check=skip_check,
save_params=save_params,
load_params=load_params,
validation_params=validation_params,
log_device_placement=log_device_placement,
use_tpu=use_tpu)
# do not need to create sess with estimator interface
if use_estimator or use_tpu:
return tpu_test_from_params(params, test_args, use_tpu=use_tpu)
else:
with tf.Graph().as_default(), tf.device(DEFAULT_HOST):
# create session
gpu_options = tf.GPUOptions(allow_growth=True)
sess = tf.Session(config=tf.ConfigProto(
allow_soft_placement=True,
gpu_options=gpu_options,
log_device_placement=log_device_placement,
))
init_op_global = tf.global_variables_initializer()
sess.run(init_op_global)
init_op_local = tf.local_variables_initializer()
sess.run(init_op_local)
log.info('Initialized from scratch first')
# For convenience, use list of dicts instead of dict of lists
_params = [{key: value[i]
for (key, value) in params.items()}
for i in range(len(params['model_params']))]
_ttargs = [{key: value[i]
for (key, value) in test_args.items()}
for i in range(len(params['model_params']))]
# Build a graph for each distinct model.
for param, ttarg in zip(_params, _ttargs):
print(param['load_params'])
from_ckpt = param['load_params'].get('from_ckpt')
use_ckpt = (from_ckpt is not None)
if not 'cache_dir' in load_params:
temp_cache_dir = save_params.get('cache_dir', None)
load_params['cache_dir'] = temp_cache_dir
log.info('cache_dir not found in load_params, '\
+ 'using cache_dir ({}) from save_params'.format(
temp_cache_dir))
ttarg['dbinterface'] = DBInterface(
var_manager=None,
params=param,
load_params=param['load_params'])
if not use_ckpt:
ttarg['dbinterface'].load_rec()
ld = ttarg['dbinterface'].load_data
assert ld is not None, "No load data found for query, aborting"
ld = ld[0]
# TODO: have option to reconstitute model_params entirely from
# saved object ("revivification")
param['model_params']['seed'] = ld['params'][
'model_params']['seed']
cfg_final = ld['params']['model_params']['cfg_final']
else:
cfg_final = param['model_params'].get('cfg_final', {})
ttarg['validation_targets'], var_manager \
= get_valid_targets_dict(
loss_params=None,
cfg_final=cfg_final,
**param)
param['load_params']['do_restore'] = True
param['model_params']['cfg_final'] = cfg_final
# Build database interface class, loading model
ttarg['dbinterface'] = DBInterface(
sess=sess,
params=param,
var_manager=var_manager,
load_params=param['load_params'],
save_params=param['save_params'])
ttarg['dbinterface'].initialize()
ttarg['save_intermediate_freq'] \
= param['save_params'].get('save_intermediate_freq')
# Convert back to a dictionary of lists
params = {
key: [param[key] for param in _params]
for key in _params[0].keys()
}
test_args = {
key: [ttarg[key] for ttarg in _ttargs]
for key in _ttargs[0].keys()
}
if dont_run:
return test_args
res = test(sess, **test_args)
sess.close()
return res
def train_from_params(
save_params,
model_params,
train_params,
loss_params=None,
learning_rate_params=None,
optimizer_params=None,
validation_params=None,
load_params=None,
log_device_placement=DEFAULT_PARAMS[
'log_device_placement'], # advanced
dont_run=DEFAULT_PARAMS['dont_run'], # advanced
skip_check=DEFAULT_PARAMS['skip_check'], # advanced
use_estimator=False):
"""
Main training interface function.
Args:
save_params (dict):
Describing the parameters used to construct the save database, and
control saving. These include:
- host (str)
Hostname where database connection lives
- port (int)
Port where database connection lives
- dbname (str)
Name of database for storage
- collname (str)
Name of collection for storage
- exp_id (str)
Experiment id descriptor
NOTE: the variables host/port/dbname/coll/exp_id control
the location of the saved data for the run, in order of
increasing specificity. When choosing these, note that:
- If a given host/port/dbname/coll/exp_id already has saved checkpoints,\
then any new call to start training with these same location variables\
will start to train from the most recent saved checkpoint. If you mistakenly\
try to start training a new model with different variable names, or structure,\
from that existing checkpoint, an error will be raised, as the model will be\
incompatiable with the saved variables.
- When choosing what dbname, coll, and exp_id, to use, keep in mind that mongodb\
queries only operate over a single collection. So if you want to analyze\
results from a bunch of experiments together using mongod queries, you should\
put them all in the same collection, but with different exp_ids. If, on the\
other hand, you never expect to analyze data from two experiments together,\
you can put them in different collections or different databases. Choosing\
between putting two experiments in two collections in the same database\
or in two totally different databases will depend on how you want to organize\
your results and is really a matter of preference.
- do_save (bool, default: True)
Whether to save to database
- save_initial_filters (bool, default: True)
Whether to save initial model filters at step = 0,
- save_metrics_freq (int, default: 5)
How often to store train results to database
- save_valid_freq (int, default: 3000)
How often to calculate and store validation results
to database
- save_filters_freq (int, default: 30000)
How often to save filter values to database
- cache_filters_freq (int, default: 3000)
How often to cache filter values locally and save
to ___RECENT database
- cache_max_num (int, default: 6)
Maximal number of cached filters to keep in __RECENT database
- cache_dir (str, default: None)
Path where caches will be saved locally. If None, will default to
~/.tfutils/<host:post>/<dbname>/<collname>/<exp_id>.
model_params (dict): Containing function that produces model and arguments to that function.
- model_params['func']
The function producing the model.
The function's signature is:
Args:
- ``inputs``: data object
- ``train`` (boolean): if in training or testing
- ``seed`` (int): seed for use in random generation
Returns:
- ``outputs`` (tf.Operations): train output tensorflow nodes
- Additional configurations you want to store in database
- Remaining items in model_params are dictionary of arguments passed to func.
train_params (dict): Containing params for data sources and targets in training.
- train_params['data_params']
This contains params for the data
- ``train_params['data_params']['func']`` is the function that constructs the data:
The function's signature is:
Args:
- ``batch_size``: Batch size for input data
Returns:
- ``inputs``: A dictionary of tensors that will be sent to model function
- ``train_params['data_params']['batch_size']`` batch size of the data, will be sent to func
- Remainder of ``train_params['data_params']`` are kwargs passed to func
- train_params['targets'] (optional)
contains params for additional train targets
- ``train_params['targets']['func']`` is a function that produces tensorflow nodes as training targets:
The function's signature is:
Args:
- ``inputs``: returned values of ``train_params['data_params']['func']``
- ``output``: first returned value of ``train_params['model_params']['func']``
Returns:
A dictionary of tensors that will be computed and stored in the database
- Remainder of ``train_parms['targets']`` are arguments to func.
- train_params['validate_first'] (optional, bool, default is True):
controls whether validating before training
- train_params['thres_loss'] (optional, float, default: 100):
If loss exceeds this during training, HiLossError is thrown
- train_params['num_steps'] (int or None, default: None):
How many total steps of the optimization are run.
If None, train is run until process is cancelled.
loss_params (dict): Parameters for helper.get_loss_base function to build loss.
- loss_params['pred_targets'] (a string or a list of strings):
contain the names of inputs nodes that will be sent into the loss function
- loss_params['loss_func']:
the function used to calculate the loss. Must be provided.
- loss_params['loss_func_kwargs'] (dict):
Keyword parameters sent to ``loss_params['loss_func']``. Default is {}.
- loss_params['agg_func']:
The aggregate function, default is None.
- loss_params['agg_func_kwargs']:
Keyword parameters sent to ``loss_params['agg_func']``. Default is {}.
- loss_params['loss_per_case_func'] (Deprecated):
Deprecated parameter, the same as ``loss_params['loss_func']``.
- loss_params['targets'] (Deprecated):
Deprecated parameter, the same as ``loss_params['targets']``.
learning_rate_params (dict): Parameters for specifying learning_rate.
- learning_rate_params['func']:
The function producing tensorflow node acting as learning rate.
This function must accept argument ``global_step``.
- remainder of learning_rate_params are arguments to func.
optimizer_params (dict): Parameters for creating optimizer.
- optimizer_params['optimizer']:
A class producing an optimizer object,
which should have function ``compute_gradients`` and ``apply_gradients``.
The signatures of these two functions are similar as tensorflow basic optimizer classes.
Must accept:
- "learning_rate" -- the result of the learning_rate_func call
- Remainder of optimizer_params (aside form "optimizer") are arguments
to the optimizer func
- optimizer_params['func'] (Deprecated):
Deprecated parameter, the same as ``optimizer_params['optimizer']``.
validation_params (dict): Dictionary of validation sources. The structure if this dictionary is:
{
<validation_target_name_1>: {
data: {
'func': (callable) data source function for this validation,
<kwarg1>: <value1> for 'func',
...
},
targets: {
'func': (callable) returning targets,
<kwarg1>: <value1> for 'func',
...
},
num_steps (int):
number of batches of validation source to compute,
agg_func (optional, callable):
how to aggregate validation results
across batches after computation. Signature is:
- one input argument: the list of validation batch results
- one output: aggregated version
Default is ``utils.identity_func``
online_agg_func (optional, callable):
how to aggregate validation results
on a per-batch basis. Siganture is:
- three input arguments: (current aggregate, new result, step)
- one output: new aggregated result
On first step, current aggregate passed in is None.
The final result is passed to the "agg_func".
Default is ``utils.append_and_return``
},
<validation_target_name_2>: ...
}
For each validation_target_name key, the targets are computed and then added to
the output dictionary to be computed every so often -- unlike train_targets which
are computed on each time step, these are computed on a basic controlled by the
valid_save_freq specific in the save_params.
load_params (dict):
Similar to save_params, if you want loading to happen from a different
location than where saving occurs. Parameters include:
- host (str)
Hostname where database connection lives
- port (int)
Port where database connection lives
- dbname (str)
Name of database for storage
- collname (str)
Name of collection for storage
- exp_id (str)
Experiment id descriptor
- do_restore (bool, default: True)
Whether to restore from saved model
- query (dict)
mongodb query describing how to load from loading database
- from_ckpt (string)
Path to load from a TensorFlow checkpoint (instead of from the db)
- to_restore (list of strings or a regex/callable which returns strings)
Specifies which variables should be loaded from the checkpoint.
Any variables not specified here will be reinitialized.
- load_param_dict (dict)
A dictionary whose keys are the names of the variables that are to be loaded
from the checkpoint, and the values are the names of the variables of the model
that you want to restore with the value of the corresponding checkpoint variable.
log_device_placement (bool, default is False):
Advanced parameter. Whether to log device placement in tensorflow session
dont_run (bool, default is False):
Advanced parameter. Whether returning everything, not actually training
skip_check (bool, default is False):
Advanced parameter. Whether skipping github check, could be useful when working in detached head
"""
# use tpu only if a tpu_name has been specified and not a multi-model
if isinstance(model_params, list): # multi-model mode
use_tpu = (model_params[0].get('tpu_name', None) is not None)
assert (use_tpu is False)
else:
use_tpu = (model_params.get('tpu_name', None) is not None)
if use_tpu:
log.info('Using tpu: %s' % model_params['tpu_name'])
params, train_args = parse_params(
'train',
model_params,
dont_run=dont_run,
skip_check=skip_check,
load_params=load_params,
loss_params=loss_params,
save_params=save_params,
train_params=train_params,
optimizer_params=optimizer_params,
validation_params=validation_params,
learning_rate_params=learning_rate_params,
log_device_placement=log_device_placement,
use_tpu=use_tpu or use_estimator)
if use_estimator or use_tpu:
return tpu_train_from_params(params, train_args, use_tpu=use_tpu)
else:
with tf.Graph().as_default(), tf.device(DEFAULT_HOST):
# For convenience, use list of dicts instead of dict of lists
_params = [{key: value[i]
for (key, value) in params.items()}
for i in range(len(params['model_params']))]
_trargs = [{key: value[i]
for (key, value) in train_args.items()}
for i in range(len(params['model_params']))]
# Use a single dataprovider for all models.
data_params = _params[0]['train_params']['data_params']
_params[0]['train_params']['data_params'], inputs \
= get_data(**data_params)
# Build a graph for each distinct model.
var_manager_list = []
for param, trarg in zip(_params, _trargs):
_, _, param, trarg, var_manager \
= get_model(inputs,
param['model_params'],
param=param,
trarg=trarg)
trarg['validation_targets'], _ = \
get_valid_targets_dict(
var_manager=var_manager,
**param)
var_manager_list.append(var_manager)
# Create session.
gpu_options = tf.GPUOptions(allow_growth=True)
sess = tf.Session(config=tf.ConfigProto(
allow_soft_placement=True,
gpu_options=gpu_options,
log_device_placement=log_device_placement,
))
# Initialize variables here
init_op_global = tf.global_variables_initializer()
sess.run(init_op_global)
init_op_local = tf.local_variables_initializer()
sess.run(init_op_local)
log.info('Initialized from scratch first')
# Build database interface for each model
# This interface class will handle the records saving, model saving, and
# model restoring.
for param, trarg, var_manager in zip(_params, _trargs,
var_manager_list):
trarg['dbinterface'] = DBInterface(
sess=sess,
params=param,
var_manager=var_manager,
global_step=trarg['global_step'],
save_params=param['save_params'],
load_params=param['load_params'])
## Model will be restored from saved database here
trarg['dbinterface'].initialize()
# Convert back to a dictionary of lists
params = {
key: [param[key] for param in _params]
for key in _params[0].keys()
}
train_args = {
key: [trarg[key] for trarg in _trargs]
for key in _trargs[0].keys()
}
if dont_run:
return train_args
return train(sess, **train_args)
def test_from_params(load_params,
model_params,
validation_params,
log_device_placement=False,
save_params=None,
dont_run=False,
skip_check=False,
):
"""
Main testing interface function.
Same as train_from_parameters; but just performs testing without training.
For documentation, see argument descriptions in train_from_params.
"""
params, test_args = parse_params(
'test',
model_params,
dont_run=dont_run,
skip_check=skip_check,
save_params=save_params,
load_params=load_params,
validation_params=validation_params,
log_device_placement=log_device_placement,
)
with tf.Graph().as_default(), tf.device(DEFAULT_HOST):
# create session
sess = tf.Session(
config=tf.ConfigProto(
allow_soft_placement=True,
log_device_placement=log_device_placement,
))
init_op_global = tf.global_variables_initializer()
sess.run(init_op_global)
init_op_local = tf.local_variables_initializer()
sess.run(init_op_local)
log.info('Initialized from scratch first')
# For convenience, use list of dicts instead of dict of lists
_params = [{key: value[i] for (key, value) in params.items()}
for i in range(len(params['model_params']))]
_ttargs = [{key: value[i] for (key, value) in test_args.items()}
for i in range(len(params['model_params']))]
# Build a graph for each distinct model.
for param, ttarg in zip(_params, _ttargs):
if not 'cache_dir' in load_params:
temp_cache_dir = save_params.get('cache_dir', None)
load_params['cache_dir'] = temp_cache_dir
log.info('cache_dir not found in load_params, using cache_dir ({}) from save_params'.format(temp_cache_dir))
ttarg['dbinterface'] = DBInterface(params=param, load_params=param['load_params'])
ttarg['dbinterface'].load_rec()
ld = ttarg['dbinterface'].load_data
assert ld is not None, "No load data found for query, aborting"
ld = ld[0]
# TODO: have option to reconstitute model_params entirely from
# saved object ("revivification")
param['model_params']['seed'] = ld['params']['model_params']['seed']
cfg_final = ld['params']['model_params']['cfg_final']
ttarg['validation_targets'] = \
get_valid_targets_dict(
loss_params=None,
cfg_final=cfg_final,
**param)
# tf.get_variable_scope().reuse_variables()
param['load_params']['do_restore'] = True
param['model_params']['cfg_final'] = cfg_final
prefix = param['model_params']['prefix'] + '/'
all_vars = variables._all_saveable_objects()
var_list = strip_prefix(prefix, all_vars)
ttarg['dbinterface'] = DBInterface(sess=sess,
params=param,
var_list=var_list,
load_params=param['load_params'],
save_params=param['save_params'])
ttarg['dbinterface'].initialize(no_scratch=True)
ttarg['save_intermediate_freq'] = param['save_params'].get('save_intermediate_freq')
# Convert back to a dictionary of lists
params = {key: [param[key] for param in _params]
for key in _params[0].keys()}
test_args = {key: [ttarg[key] for ttarg in _ttargs]
for key in _ttargs[0].keys()}
if dont_run:
return test_args
res = test(sess, **test_args)
sess.close()
return res