Source code for bmtk.simulator.core.simulation_config
# Copyright 2017. Allen Institute. All rights reserved
#
# Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
# following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
# disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
# disclaimer in the documentation and/or other materials provided with the distribution.
#
# 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote
# products derived from this software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
# INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#
import os
import json
import warnings
from bmtk.utils.sonata.config import SonataConfig, copy_config
from bmtk.simulator.core.io_tools import io
[docs]class SimulationConfig(SonataConfig):
"""A special version of SonataConfig that contains some methods that can be used by the simulators. Mainly
it contains the build_env() method which can be called to setup logging plus initialize the 'output_dir' folder.
Functionality that is specific to SONATA should go in SonataConfig
"""
def __init__(self, *args, **kwargs):
super(SimulationConfig, self).__init__(*args, **kwargs)
self.env_built = False
self._io = None
@property
def io(self):
if self._io is None:
self._io = io
return self._io
@io.setter
def io(self, io):
self._io = io
@property
def validator(self):
if self._validator is None:
from .simulation_config_validator import SimulationConfigValidator
json_schema = os.path.join(os.path.dirname(__file__), 'sonata_schemas', 'config_schema.json')
with open(json_schema, 'r') as f:
config_schema = json.load(f)
self._validator = SimulationConfigValidator(schema=config_schema)
return self._validator
[docs] def validate(self):
try:
return super(SimulationConfig, self).validate()
except Exception as exc:
# Capture the output into our log file before raising the error
msg = 'SimulationConfig ValidationError: {}'.format(str(exc))
self.io.log_exception(msg)
[docs] def copy_to_output(self):
copy_config(self)
def _set_logging(self):
"""Check if log-level and/or log-format string is being changed through the config"""
output_sec = self.output
if 'log_format' in output_sec:
self.io.set_log_format(output_sec['log_format'])
if 'log_level' in output_sec:
self.io.set_log_level(output_sec['log_level'])
if 'log_to_console' in output_sec:
self.io.log_to_console = output_sec['log_to_console']
if 'quiet_simulator' in output_sec and output_sec['quiet_simulator']:
self.io.quiet_simulator()
[docs] def build_env(self, force=False):
"""Creates the folder(s) set in 'output' section, sets up logging and copies over the configuration"""
if self.env_built and not force:
return
self._set_logging()
self.io.setup_output_dir(self.output_dir, self.log_file, self.overwrite_output)
self.copy_to_output()
self.env_built = True
[docs]def from_dict(config_dict, validator=None, **opts):
warnings.warn('Deprecated: Pleas use SimulationConfig.from_dict() instead.', DeprecationWarning)
return SimulationConfig.from_dict(config_dict, validator, **opts)
[docs]def from_json(config_file, validator=None, **opts):
warnings.warn('Deprecated: Pleas use SimulationConfig.from_json() instead.', DeprecationWarning)
return SimulationConfig.from_json(config_file, validator, **opts)