diff --git a/.gitignore b/.gitignore index cd6c60cb88592988944d923da8e803b2b5ef0cfe..8a8bf31765c12959f4326f1d5819e7d71803bc70 100644 --- a/.gitignore +++ b/.gitignore @@ -2,4 +2,4 @@ __pycache__ *.egg-info doc/build/ *.pyc - +force_bdss/version.py diff --git a/braindump/datasource.py b/braindump/datasource.py deleted file mode 100644 index af36fd93db389aec14cb5f1fcc73ddc8be5dac16..0000000000000000000000000000000000000000 --- a/braindump/datasource.py +++ /dev/null @@ -1,35 +0,0 @@ -class DataSource(): - """Base class that performs calculation or extraction of information - """ - __metaclass__ = abc.ABCMeta - - def __init__(self, name): - self.name = name - - @abstractclassmethod - def provides(cls): - return [CUBA.key] - - def execute(self, parameters): - """Performs the evaluation and returns a list of Result. - """ - - -class Simulator(DataSource): - pass - - -class Database(DataSource): - pass - - -# Represents the result of a simulator. -# It contains the resulting cuba key, the associated uncertainty and the -# originating simulator. -# Difference between uncertainty and quality: uncertainty is a numerical value -# of the value, as in the case of an experimental simulation. -# quality is the level of accuracy of the (e.g.c omputational) method, as -# the importance and reliability of that value. It should be an enumeration -# value such as HIGH, MEDIUM, POOR -Result = namedtuple("Result", "cuba_key value uncertainty originator quality") - diff --git a/braindump/kpi_calculator.py b/braindump/kpi_calculator.py deleted file mode 100644 index d9e7d0d60dfca89fdddc98861f21c65323bea6e6..0000000000000000000000000000000000000000 --- a/braindump/kpi_calculator.py +++ /dev/null @@ -1,16 +0,0 @@ -class KPICalculator(): - """Base class that defines the equaation to compute the KPIs values from - the results of the simulators - - input: a list of SimulatorResult - output: a list of KPIs. - """ - __metaclass__ = abc.ABCMeta - - def execute(self, datasource_results) - """Returns the KPIResult""" - - -KPIResult = namedtuple("KPIResult", "name cuba_key value uncertainty quality") - - diff --git a/braindump/main.py b/braindump/main.py deleted file mode 100644 index a61d6a00c4e4b9534c8375c5ecdf4fa738d95930..0000000000000000000000000000000000000000 --- a/braindump/main.py +++ /dev/null @@ -1,38 +0,0 @@ -from force_bdss import * - -wf=Workflow() -wf.set_mco(Dakota()) -wf.set_datasources([ - ViscositySimulator(), - CostExtractor(), -]) -wf.objectives([ - Objective(), - Objective() - ]) - - -wf.set_parameters({ - "material_1": { - CUBA.FORMULA: "H2O", - CUBA.CONCENTRATION: Range(0, 100) - }, - "material_2": { - CUBA.FORMULA: "glycol", - CUBA.CONCENTRATION: Formula("material_1", - lambda material_1: 100 - material_1[CUBA.CONCENTRATION]) - } -}) - -wf.set_result_callback(callback) - -# constraints vs computed value -# e.g. constraint = value from 0 to 100 -# computed value = 100 - other value -# TODO: Study dakota better to understand how it works and what kind of -# interface it expects - -pareto_front = wf.execute() - -plot(pareto_front) - diff --git a/braindump/mco.py b/braindump/mco.py deleted file mode 100644 index 6b4756219dc167fba02d2b01653fd45dd323064d..0000000000000000000000000000000000000000 --- a/braindump/mco.py +++ /dev/null @@ -1,26 +0,0 @@ -class MCO(): - """Receives a list of KPIResult to decide the next step in the parameter - space""" - __metaclass__ = abc.ABCMeta - starting_point - variable_constraints - objectives - - def get_next_parameters(kpi_results): - pass - - -class Dakota(MCO): - def __init__(self, options): - pass - - -class DakotaInput(): - """Read the parameters from the dakota input file and returns - the parameters for further consumption""" - def parse(filename): - """Returns the parameters""" - - -class DakotaOutput(): - """Writes the KPIs to the file for consumption by Dakota""" diff --git a/braindump/workflow.py b/braindump/workflow.py deleted file mode 100644 index 70c268a0b1ee2518fcbbed3a7c9cc602280c2914..0000000000000000000000000000000000000000 --- a/braindump/workflow.py +++ /dev/null @@ -1,25 +0,0 @@ -# This is a prototype for the Workflow in FORCE -import abc - - -class Workflow(): - # calculates the KPIs from the list of the cuba keys coming from the - # simulators - mco = None - data_sources = None - - - - -class ViscosityCalculator(Simulator): - pass - - -class CostExtractor(Database): - provides_kpi = [] - - -class Objective() - kpi = None - optimization_type = MAXIMIZE - diff --git a/doc/source/api/force_bdss.cli.rst b/doc/source/api/force_bdss.cli.rst index c6f155feae77f2f4ef9f45341a29ee927b931f5e..c96292e6712e3cb76369b1c4c59ddfe58c7c3e3f 100644 --- a/doc/source/api/force_bdss.cli.rst +++ b/doc/source/api/force_bdss.cli.rst @@ -1,5 +1,5 @@ -force\_bdss\.cli package -======================== +force_bdss.cli package +====================== Subpackages ----------- @@ -11,8 +11,8 @@ Subpackages Submodules ---------- -force\_bdss\.cli\.force\_bdss module ------------------------------------- +force_bdss.cli.force_bdss module +-------------------------------- .. automodule:: force_bdss.cli.force_bdss :members: diff --git a/doc/source/api/force_bdss.cli.tests.rst b/doc/source/api/force_bdss.cli.tests.rst index 207d9516f942c774bf349ac8a91ec55c4f5807ca..5fef4d6bb9516d1e822af0255e1b311b0b77ea98 100644 --- a/doc/source/api/force_bdss.cli.tests.rst +++ b/doc/source/api/force_bdss.cli.tests.rst @@ -1,11 +1,11 @@ -force\_bdss\.cli\.tests package -=============================== +force_bdss.cli.tests package +============================ Submodules ---------- -force\_bdss\.cli\.tests\.test\_execution module ------------------------------------------------ +force_bdss.cli.tests.test_execution module +------------------------------------------ .. automodule:: force_bdss.cli.tests.test_execution :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.rst b/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.rst index 9ae598589c9d83a01f695595f72b5065774f8ce1..0db16a6675b7671c06903351b160229e47566b3b 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.rst @@ -1,5 +1,5 @@ -force\_bdss\.core\_plugins\.dummy\.csv\_extractor package -========================================================= +force_bdss.core_plugins.dummy.csv_extractor package +=================================================== Subpackages ----------- @@ -11,24 +11,24 @@ Subpackages Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.csv\_extractor\_bundle module --------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_bundle module +----------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.csv\_extractor\_data\_source module --------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_data_source module +---------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_data_source :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.csv\_extractor\_model module -------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_model module +---------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_model :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.tests.rst index 95ab6ce85eadac258e92d3e68dcd65ced13d2c6a..a93a5fc4096ee9a1fedeb5c2141b40e22456bcd3 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.tests.rst @@ -1,19 +1,19 @@ -force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.tests package -================================================================ +force_bdss.core_plugins.dummy.csv_extractor.tests package +========================================================= Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.tests\.test\_csv\_extractor\_bundle module ---------------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.csv_extractor.tests.test_csv_extractor_bundle module +---------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.csv_extractor.tests.test_csv_extractor_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.tests\.test\_csv\_extractor\_data\_source module ---------------------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.csv_extractor.tests.test_csv_extractor_data_source module +--------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.csv_extractor.tests.test_csv_extractor_data_source :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.rst index 9ddaee43284dbe56e934bebb16764fedecda5d81..61c462f5e1b6dcf940904290845e913f67c73fbf 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.rst @@ -1,5 +1,5 @@ -force\_bdss\.core\_plugins\.dummy\.dummy\_dakota package -======================================================== +force_bdss.core_plugins.dummy.dummy_dakota package +================================================== Subpackages ----------- @@ -11,32 +11,32 @@ Subpackages Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.dakota\_bundle module ------------------------------------------------------------------------ +force_bdss.core_plugins.dummy.dummy_dakota.dakota_bundle module +--------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.dakota_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.dakota\_communicator module ------------------------------------------------------------------------------ +force_bdss.core_plugins.dummy.dummy_dakota.dakota_communicator module +--------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.dakota_communicator :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.dakota\_model module ----------------------------------------------------------------------- +force_bdss.core_plugins.dummy.dummy_dakota.dakota_model module +-------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.dakota_model :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.dakota\_optimizer module --------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.dummy_dakota.dakota_optimizer module +------------------------------------------------------------------ .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.dakota_optimizer :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.tests.rst index 0e5975a08327f16be2155c9f947abeba04c6f669..febc1cb487e5b89984ef0c82d5aadd2e7cd5058b 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.tests.rst @@ -1,25 +1,33 @@ -force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.tests package -=============================================================== +force_bdss.core_plugins.dummy.dummy_dakota.tests package +======================================================== Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.tests\.test\_dakota\_bundle module ------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_bundle module +-------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.tests\.test\_dakota\_communicator module ------------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_communicator module +-------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_communicator :members: :undoc-members: :show-inheritance: +force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_optimizer module +----------------------------------------------------------------------------- + +.. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_optimizer + :members: + :undoc-members: + :show-inheritance: + Module contents --------------- diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.rst index da0f4ed38f1eafcdf6736cf1ffa7f3f736638b12..f6b31d3bbaf5a90a1f95755423a1d36931a5d168 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.rst @@ -1,5 +1,5 @@ -force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source package -============================================================== +force_bdss.core_plugins.dummy.dummy_data_source package +======================================================= Subpackages ----------- @@ -11,24 +11,24 @@ Subpackages Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.dummy\_data\_source module ----------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source module +------------------------------------------------------------------------ .. automodule:: force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.dummy\_data\_source\_bundle module ------------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source_bundle module +------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.dummy\_data\_source\_model module ------------------------------------------------------------------------------------------ +force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source_model module +------------------------------------------------------------------------------ .. automodule:: force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source_model :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.tests.rst index a665a03f64f2c6d9d8011de225f1f9b8f05e7407..84c724a0bce909180744f3812a3617e28a318f56 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.tests.rst @@ -1,19 +1,19 @@ -force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.tests package -===================================================================== +force_bdss.core_plugins.dummy.dummy_data_source.tests package +============================================================= Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.tests\.test\_dummy\_data\_source module ------------------------------------------------------------------------------------------------ +force_bdss.core_plugins.dummy.dummy_data_source.tests.test_dummy_data_source module +----------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_data_source.tests.test_dummy_data_source :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.tests\.test\_dummy\_data\_source\_bundle module -------------------------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.dummy_data_source.tests.test_dummy_data_source_bundle module +------------------------------------------------------------------------------------------ .. automodule:: force_bdss.core_plugins.dummy.dummy_data_source.tests.test_dummy_data_source_bundle :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.rst index 5de1ecc908401be6fd36aedf61edafaa5cff6ea3..c02d6eeef6e62d171fcccee196f8d65bc9dfc1a3 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.rst @@ -1,5 +1,5 @@ -force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator package -================================================================= +force_bdss.core_plugins.dummy.dummy_kpi_calculator package +========================================================== Subpackages ----------- @@ -11,24 +11,24 @@ Subpackages Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator\.dummy\_kpi\_calculator module ----------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator module +------------------------------------------------------------------------------ .. automodule:: force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator\.dummy\_kpi\_calculator\_bundle module ------------------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator_bundle module +------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator\.dummy\_kpi\_calculator\_model module ------------------------------------------------------------------------------------------------ +force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator_model module +------------------------------------------------------------------------------------ .. automodule:: force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator_model :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.rst index bf54bf5ede11330a2fc4bde99898cf22fc106e4b..f46cc8792a1b4bb891bef1cbf7162a64f1b64473 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.rst @@ -1,11 +1,11 @@ -force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator\.tests package -======================================================================== +force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests package +================================================================ Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator\.tests\.test\_dummy\_kpi\_calculator\_bundle module -------------------------------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.test_dummy_kpi_calculator_bundle module +------------------------------------------------------------------------------------------------ .. automodule:: force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.test_dummy_kpi_calculator_bundle :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.rst b/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.rst index ea4c2baf13eabbd5002ecbfd44d70aabac359fd5..e50d5f5412539c27e21d7a476823ff9408d26987 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.rst @@ -1,5 +1,5 @@ -force\_bdss\.core\_plugins\.dummy\.kpi\_adder package -===================================================== +force_bdss.core_plugins.dummy.kpi_adder package +=============================================== Subpackages ----------- @@ -11,24 +11,24 @@ Subpackages Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.kpi\_adder\.kpi\_adder\_bundle module ------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_bundle module +--------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.kpi\_adder\.kpi\_adder\_calculator module ----------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_calculator module +------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_calculator :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.kpi\_adder\.kpi\_adder\_model module ------------------------------------------------------------------------ +force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_model module +-------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_model :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.tests.rst index 3937a7e155466d0c7e370c0ae4edaa0ea468dcb7..1aa848c9f7c5b75123f4dc1408a0124a40555ca2 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.tests.rst @@ -1,11 +1,11 @@ -force\_bdss\.core\_plugins\.dummy\.kpi\_adder\.tests package -============================================================ +force_bdss.core_plugins.dummy.kpi_adder.tests package +===================================================== Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.kpi\_adder\.tests\.test\_kpi\_adder\_bundle module -------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.kpi_adder.tests.test_kpi_adder_bundle module +-------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.kpi_adder.tests.test_kpi_adder_bundle :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.rst b/doc/source/api/force_bdss.core_plugins.dummy.rst index 82b8d0273381e6db869689d1cdcc659bf260da2c..6d5b57bb89bf098067e01e605e684565990e3151 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.rst @@ -1,5 +1,5 @@ -force\_bdss\.core\_plugins\.dummy package -========================================= +force_bdss.core_plugins.dummy package +===================================== Subpackages ----------- @@ -16,8 +16,8 @@ Subpackages Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.dummy\_plugin module -------------------------------------------------------- +force_bdss.core_plugins.dummy.dummy_plugin module +------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_plugin :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.tests.rst index fbe318ae3b065e37dbcdfef4a6e2fe426183c0a7..b20750e59689a67817f4bade9d9b5cca503aa9af 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.tests.rst @@ -1,19 +1,19 @@ -force\_bdss\.core\_plugins\.dummy\.tests package -================================================ +force_bdss.core_plugins.dummy.tests package +=========================================== Submodules ---------- -force\_bdss\.core\_plugins\.dummy\.tests\.data\_source\_bundle\_test\_mixin module ----------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.tests.data_source_bundle_test_mixin module +------------------------------------------------------------------------ .. automodule:: force_bdss.core_plugins.dummy.tests.data_source_bundle_test_mixin :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_plugins\.dummy\.tests\.kpi\_calculator\_bundle\_test\_mixin module -------------------------------------------------------------------------------------- +force_bdss.core_plugins.dummy.tests.kpi_calculator_bundle_test_mixin module +--------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.tests.kpi_calculator_bundle_test_mixin :members: diff --git a/doc/source/api/force_bdss.core_plugins.rst b/doc/source/api/force_bdss.core_plugins.rst index d667de4d88ad1e3f3b4ee21977731d9091daad0b..aabfada58813a84466b0ca4252d7d6277ad032df 100644 --- a/doc/source/api/force_bdss.core_plugins.rst +++ b/doc/source/api/force_bdss.core_plugins.rst @@ -1,5 +1,5 @@ -force\_bdss\.core\_plugins package -================================== +force_bdss.core_plugins package +=============================== Subpackages ----------- diff --git a/doc/source/api/force_bdss.data_sources.rst b/doc/source/api/force_bdss.data_sources.rst index e5548091c1a73ff48d22001ed95eab727ddfb154..7df2d7d82a4fc847ade8719b3c338e4fb4c3b04c 100644 --- a/doc/source/api/force_bdss.data_sources.rst +++ b/doc/source/api/force_bdss.data_sources.rst @@ -1,5 +1,5 @@ -force\_bdss\.data\_sources package -================================== +force_bdss.data_sources package +=============================== Subpackages ----------- @@ -11,48 +11,48 @@ Subpackages Submodules ---------- -force\_bdss\.data\_sources\.base\_data\_source module ------------------------------------------------------ +force_bdss.data_sources.base_data_source module +----------------------------------------------- .. automodule:: force_bdss.data_sources.base_data_source :members: :undoc-members: :show-inheritance: -force\_bdss\.data\_sources\.base\_data\_source\_bundle module -------------------------------------------------------------- +force_bdss.data_sources.base_data_source_bundle module +------------------------------------------------------ .. automodule:: force_bdss.data_sources.base_data_source_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.data\_sources\.base\_data\_source\_model module ------------------------------------------------------------- +force_bdss.data_sources.base_data_source_model module +----------------------------------------------------- .. automodule:: force_bdss.data_sources.base_data_source_model :members: :undoc-members: :show-inheritance: -force\_bdss\.data\_sources\.data\_source\_parameters module ------------------------------------------------------------ +force_bdss.data_sources.data_source_parameters module +----------------------------------------------------- .. automodule:: force_bdss.data_sources.data_source_parameters :members: :undoc-members: :show-inheritance: -force\_bdss\.data\_sources\.data\_source\_result module -------------------------------------------------------- +force_bdss.data_sources.data_source_result module +------------------------------------------------- .. automodule:: force_bdss.data_sources.data_source_result :members: :undoc-members: :show-inheritance: -force\_bdss\.data\_sources\.i\_data\_source\_bundle module ----------------------------------------------------------- +force_bdss.data_sources.i_data_source_bundle module +--------------------------------------------------- .. automodule:: force_bdss.data_sources.i_data_source_bundle :members: diff --git a/doc/source/api/force_bdss.data_sources.tests.rst b/doc/source/api/force_bdss.data_sources.tests.rst index 2b9563c0d99b6b04af56263f10eb83e968312357..067997cbdb5e09e2db0e7b93d0aa7f87d3082e40 100644 --- a/doc/source/api/force_bdss.data_sources.tests.rst +++ b/doc/source/api/force_bdss.data_sources.tests.rst @@ -1,19 +1,19 @@ -force\_bdss\.data\_sources\.tests package -========================================= +force_bdss.data_sources.tests package +===================================== Submodules ---------- -force\_bdss\.data\_sources\.tests\.test\_base\_data\_source module ------------------------------------------------------------------- +force_bdss.data_sources.tests.test_base_data_source module +---------------------------------------------------------- .. automodule:: force_bdss.data_sources.tests.test_base_data_source :members: :undoc-members: :show-inheritance: -force\_bdss\.data\_sources\.tests\.test\_base\_data\_source\_bundle module --------------------------------------------------------------------------- +force_bdss.data_sources.tests.test_base_data_source_bundle module +----------------------------------------------------------------- .. automodule:: force_bdss.data_sources.tests.test_base_data_source_bundle :members: diff --git a/doc/source/api/force_bdss.io.rst b/doc/source/api/force_bdss.io.rst index 558ecbe7027e6a1f7dac11c92b973a6c3111e9f3..c221828e07ac581f86f7948193842a228c018dca 100644 --- a/doc/source/api/force_bdss.io.rst +++ b/doc/source/api/force_bdss.io.rst @@ -1,5 +1,5 @@ -force\_bdss\.io package -======================= +force_bdss.io package +===================== Subpackages ----------- @@ -11,16 +11,16 @@ Subpackages Submodules ---------- -force\_bdss\.io\.workflow\_reader module ----------------------------------------- +force_bdss.io.workflow_reader module +------------------------------------ .. automodule:: force_bdss.io.workflow_reader :members: :undoc-members: :show-inheritance: -force\_bdss\.io\.workflow\_writer module ----------------------------------------- +force_bdss.io.workflow_writer module +------------------------------------ .. automodule:: force_bdss.io.workflow_writer :members: diff --git a/doc/source/api/force_bdss.io.tests.rst b/doc/source/api/force_bdss.io.tests.rst index 7a53ccef1f9275f7ef794f7d0fe3d73f45445cef..d7512c8f927552c173fa291b1f2958b696207c95 100644 --- a/doc/source/api/force_bdss.io.tests.rst +++ b/doc/source/api/force_bdss.io.tests.rst @@ -1,19 +1,19 @@ -force\_bdss\.io\.tests package -============================== +force_bdss.io.tests package +=========================== Submodules ---------- -force\_bdss\.io\.tests\.test\_workflow\_reader module ------------------------------------------------------ +force_bdss.io.tests.test_workflow_reader module +----------------------------------------------- .. automodule:: force_bdss.io.tests.test_workflow_reader :members: :undoc-members: :show-inheritance: -force\_bdss\.io\.tests\.test\_workflow\_writer module ------------------------------------------------------ +force_bdss.io.tests.test_workflow_writer module +----------------------------------------------- .. automodule:: force_bdss.io.tests.test_workflow_writer :members: diff --git a/doc/source/api/force_bdss.kpi.rst b/doc/source/api/force_bdss.kpi.rst index c8c9a36153b11d6b8717c93cebc22f53675d1b0d..b90b1b5f07e1e7e428de41c12bfe88cb58abd4c6 100644 --- a/doc/source/api/force_bdss.kpi.rst +++ b/doc/source/api/force_bdss.kpi.rst @@ -1,5 +1,5 @@ -force\_bdss\.kpi package -======================== +force_bdss.kpi package +====================== Subpackages ----------- @@ -11,40 +11,40 @@ Subpackages Submodules ---------- -force\_bdss\.kpi\.base\_kpi\_calculator module ----------------------------------------------- +force_bdss.kpi.base_kpi_calculator module +----------------------------------------- .. automodule:: force_bdss.kpi.base_kpi_calculator :members: :undoc-members: :show-inheritance: -force\_bdss\.kpi\.base\_kpi\_calculator\_bundle module ------------------------------------------------------- +force_bdss.kpi.base_kpi_calculator_bundle module +------------------------------------------------ .. automodule:: force_bdss.kpi.base_kpi_calculator_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.kpi\.base\_kpi\_calculator\_model module ------------------------------------------------------ +force_bdss.kpi.base_kpi_calculator_model module +----------------------------------------------- .. automodule:: force_bdss.kpi.base_kpi_calculator_model :members: :undoc-members: :show-inheritance: -force\_bdss\.kpi\.i\_kpi\_calculator\_bundle module ---------------------------------------------------- +force_bdss.kpi.i_kpi_calculator_bundle module +--------------------------------------------- .. automodule:: force_bdss.kpi.i_kpi_calculator_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.kpi\.kpi\_calculator\_result module ------------------------------------------------- +force_bdss.kpi.kpi_calculator_result module +------------------------------------------- .. automodule:: force_bdss.kpi.kpi_calculator_result :members: diff --git a/doc/source/api/force_bdss.kpi.tests.rst b/doc/source/api/force_bdss.kpi.tests.rst index e7a8126e235c8bac7bea84d12d09fc828949f4cf..9c7eb6c4e91b36ebafe7b82c5da3f3dfa08efb20 100644 --- a/doc/source/api/force_bdss.kpi.tests.rst +++ b/doc/source/api/force_bdss.kpi.tests.rst @@ -1,19 +1,19 @@ -force\_bdss\.kpi\.tests package -=============================== +force_bdss.kpi.tests package +============================ Submodules ---------- -force\_bdss\.kpi\.tests\.test\_base\_kpi\_calculator module ------------------------------------------------------------ +force_bdss.kpi.tests.test_base_kpi_calculator module +---------------------------------------------------- .. automodule:: force_bdss.kpi.tests.test_base_kpi_calculator :members: :undoc-members: :show-inheritance: -force\_bdss\.kpi\.tests\.test\_base\_kpi\_calculator\_bundle module -------------------------------------------------------------------- +force_bdss.kpi.tests.test_base_kpi_calculator_bundle module +----------------------------------------------------------- .. automodule:: force_bdss.kpi.tests.test_base_kpi_calculator_bundle :members: diff --git a/doc/source/api/force_bdss.mco.parameters.rst b/doc/source/api/force_bdss.mco.parameters.rst index 8bad9d2826fe41a48d1a6d9fec4562cb24aeaff1..f289f438bb64123f0dff84ac4d30be8e342d72db 100644 --- a/doc/source/api/force_bdss.mco.parameters.rst +++ b/doc/source/api/force_bdss.mco.parameters.rst @@ -1,5 +1,5 @@ -force\_bdss\.mco\.parameters package -==================================== +force_bdss.mco.parameters package +================================= Subpackages ----------- @@ -11,32 +11,32 @@ Subpackages Submodules ---------- -force\_bdss\.mco\.parameters\.base\_mco\_parameter module ---------------------------------------------------------- +force_bdss.mco.parameters.base_mco_parameter module +--------------------------------------------------- .. automodule:: force_bdss.mco.parameters.base_mco_parameter :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.parameters\.base\_mco\_parameter\_factory module ------------------------------------------------------------------- +force_bdss.mco.parameters.base_mco_parameter_factory module +----------------------------------------------------------- .. automodule:: force_bdss.mco.parameters.base_mco_parameter_factory :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.parameters\.core\_mco\_parameters module ----------------------------------------------------------- +force_bdss.mco.parameters.core_mco_parameters module +---------------------------------------------------- .. automodule:: force_bdss.mco.parameters.core_mco_parameters :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.parameters\.mco\_parameter\_factory\_registry module ----------------------------------------------------------------------- +force_bdss.mco.parameters.mco_parameter_factory_registry module +--------------------------------------------------------------- .. automodule:: force_bdss.mco.parameters.mco_parameter_factory_registry :members: diff --git a/doc/source/api/force_bdss.mco.parameters.tests.rst b/doc/source/api/force_bdss.mco.parameters.tests.rst index c8950c209dce89f496fed6cff8448b59c7a427db..694cb158a833bfa1c3860bf12166bd71ab93788a 100644 --- a/doc/source/api/force_bdss.mco.parameters.tests.rst +++ b/doc/source/api/force_bdss.mco.parameters.tests.rst @@ -1,35 +1,35 @@ -force\_bdss\.mco\.parameters\.tests package -=========================================== +force_bdss.mco.parameters.tests package +======================================= Submodules ---------- -force\_bdss\.mco\.parameters\.tests\.test\_base\_mco\_parameter module ----------------------------------------------------------------------- +force_bdss.mco.parameters.tests.test_base_mco_parameter module +-------------------------------------------------------------- .. automodule:: force_bdss.mco.parameters.tests.test_base_mco_parameter :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.parameters\.tests\.test\_base\_mco\_parameter\_factory module -------------------------------------------------------------------------------- +force_bdss.mco.parameters.tests.test_base_mco_parameter_factory module +---------------------------------------------------------------------- .. automodule:: force_bdss.mco.parameters.tests.test_base_mco_parameter_factory :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.parameters\.tests\.test\_core\_mco\_parameters module ------------------------------------------------------------------------ +force_bdss.mco.parameters.tests.test_core_mco_parameters module +--------------------------------------------------------------- .. automodule:: force_bdss.mco.parameters.tests.test_core_mco_parameters :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.parameters\.tests\.test\_parameter\_factory\_registry module ------------------------------------------------------------------------------- +force_bdss.mco.parameters.tests.test_parameter_factory_registry module +---------------------------------------------------------------------- .. automodule:: force_bdss.mco.parameters.tests.test_parameter_factory_registry :members: diff --git a/doc/source/api/force_bdss.mco.rst b/doc/source/api/force_bdss.mco.rst index ced0270689b083d478226aafd1faadbaf4cc7948..c8047b33691b51c57d8f3ac75629b1c6f206f8ff 100644 --- a/doc/source/api/force_bdss.mco.rst +++ b/doc/source/api/force_bdss.mco.rst @@ -1,5 +1,5 @@ -force\_bdss\.mco package -======================== +force_bdss.mco package +====================== Subpackages ----------- @@ -12,40 +12,40 @@ Subpackages Submodules ---------- -force\_bdss\.mco\.base\_mco module ----------------------------------- +force_bdss.mco.base_mco module +------------------------------ .. automodule:: force_bdss.mco.base_mco :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.base\_mco\_bundle module ------------------------------------------- +force_bdss.mco.base_mco_bundle module +------------------------------------- .. automodule:: force_bdss.mco.base_mco_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.base\_mco\_communicator module ------------------------------------------------- +force_bdss.mco.base_mco_communicator module +------------------------------------------- .. automodule:: force_bdss.mco.base_mco_communicator :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.base\_mco\_model module ------------------------------------------ +force_bdss.mco.base_mco_model module +------------------------------------ .. automodule:: force_bdss.mco.base_mco_model :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.i\_mco\_bundle module ---------------------------------------- +force_bdss.mco.i_mco_bundle module +---------------------------------- .. automodule:: force_bdss.mco.i_mco_bundle :members: diff --git a/doc/source/api/force_bdss.mco.tests.rst b/doc/source/api/force_bdss.mco.tests.rst index 809ef692cabc2a883cb72b24e72b381c4eda9519..6dbcf8432a56e54097c8d928f481e2ee23fed06b 100644 --- a/doc/source/api/force_bdss.mco.tests.rst +++ b/doc/source/api/force_bdss.mco.tests.rst @@ -1,27 +1,27 @@ -force\_bdss\.mco\.tests package -=============================== +force_bdss.mco.tests package +============================ Submodules ---------- -force\_bdss\.mco\.tests\.test\_base\_mco module ------------------------------------------------ +force_bdss.mco.tests.test_base_mco module +----------------------------------------- .. automodule:: force_bdss.mco.tests.test_base_mco :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.tests\.test\_base\_mco\_bundle module -------------------------------------------------------- +force_bdss.mco.tests.test_base_mco_bundle module +------------------------------------------------ .. automodule:: force_bdss.mco.tests.test_base_mco_bundle :members: :undoc-members: :show-inheritance: -force\_bdss\.mco\.tests\.test\_base\_mco\_communicator module -------------------------------------------------------------- +force_bdss.mco.tests.test_base_mco_communicator module +------------------------------------------------------ .. automodule:: force_bdss.mco.tests.test_base_mco_communicator :members: diff --git a/doc/source/api/force_bdss.rst b/doc/source/api/force_bdss.rst index 63a788a84fc979af8c0189b1a01fd682fde7b8b8..e558a1c921e3a3b557f6ccb205fb8f9349659589 100644 --- a/doc/source/api/force_bdss.rst +++ b/doc/source/api/force_bdss.rst @@ -1,5 +1,5 @@ -force\_bdss package -=================== +force_bdss package +================== Subpackages ----------- @@ -18,70 +18,78 @@ Subpackages Submodules ---------- -force\_bdss\.api module ------------------------ +force_bdss.api module +--------------------- .. automodule:: force_bdss.api :members: :undoc-members: :show-inheritance: -force\_bdss\.base\_core\_driver module --------------------------------------- +force_bdss.base_core_driver module +---------------------------------- .. automodule:: force_bdss.base_core_driver :members: :undoc-members: :show-inheritance: -force\_bdss\.base\_extension\_plugin module -------------------------------------------- +force_bdss.base_extension_plugin module +--------------------------------------- .. automodule:: force_bdss.base_extension_plugin :members: :undoc-members: :show-inheritance: -force\_bdss\.bdss\_application module -------------------------------------- +force_bdss.bdss_application module +---------------------------------- .. automodule:: force_bdss.bdss_application :members: :undoc-members: :show-inheritance: -force\_bdss\.bundle\_registry\_plugin module --------------------------------------------- +force_bdss.bundle_registry_plugin module +---------------------------------------- .. automodule:: force_bdss.bundle_registry_plugin :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_evaluation\_driver module --------------------------------------------- +force_bdss.core_evaluation_driver module +---------------------------------------- .. automodule:: force_bdss.core_evaluation_driver :members: :undoc-members: :show-inheritance: -force\_bdss\.core\_mco\_driver module -------------------------------------- +force_bdss.core_mco_driver module +--------------------------------- .. automodule:: force_bdss.core_mco_driver :members: :undoc-members: :show-inheritance: -force\_bdss\.ids module ------------------------ +force_bdss.ids module +--------------------- .. automodule:: force_bdss.ids :members: :undoc-members: :show-inheritance: +force_bdss.version module +------------------------- + +.. automodule:: force_bdss.version + :members: + :undoc-members: + :show-inheritance: + Module contents --------------- diff --git a/doc/source/api/force_bdss.tests.fixtures.rst b/doc/source/api/force_bdss.tests.fixtures.rst index 3c0c12f86492d2ad5aec4a1d6e1753da47ba1084..67056f7ef65941c819e17e7abbf4756b4b11728a 100644 --- a/doc/source/api/force_bdss.tests.fixtures.rst +++ b/doc/source/api/force_bdss.tests.fixtures.rst @@ -1,5 +1,5 @@ -force\_bdss\.tests\.fixtures package -==================================== +force_bdss.tests.fixtures package +================================= Module contents --------------- diff --git a/doc/source/api/force_bdss.tests.rst b/doc/source/api/force_bdss.tests.rst index 4402dd7deb447dbdc03b33327328e839dc5fc3e2..3f6641aec683b4a9df907c93aed68093123e0b50 100644 --- a/doc/source/api/force_bdss.tests.rst +++ b/doc/source/api/force_bdss.tests.rst @@ -1,5 +1,5 @@ -force\_bdss\.tests package -========================== +force_bdss.tests package +======================== Subpackages ----------- @@ -11,32 +11,32 @@ Subpackages Submodules ---------- -force\_bdss\.tests\.test\_bdss\_application module --------------------------------------------------- +force_bdss.tests.test_bdss_application module +--------------------------------------------- .. automodule:: force_bdss.tests.test_bdss_application :members: :undoc-members: :show-inheritance: -force\_bdss\.tests\.test\_bundle\_registry\_plugin module ---------------------------------------------------------- +force_bdss.tests.test_bundle_registry_plugin module +--------------------------------------------------- .. automodule:: force_bdss.tests.test_bundle_registry_plugin :members: :undoc-members: :show-inheritance: -force\_bdss\.tests\.test\_core\_evaluation\_driver module ---------------------------------------------------------- +force_bdss.tests.test_core_evaluation_driver module +--------------------------------------------------- .. automodule:: force_bdss.tests.test_core_evaluation_driver :members: :undoc-members: :show-inheritance: -force\_bdss\.tests\.test\_ids module ------------------------------------- +force_bdss.tests.test_ids module +-------------------------------- .. automodule:: force_bdss.tests.test_ids :members: diff --git a/doc/source/api/force_bdss.workspecs.rst b/doc/source/api/force_bdss.workspecs.rst index d83f60e920cdaab28713ba0d8e036fe7db30fa13..13fb1dc84f6905f6ae3cbdbb78d4ad0b48fd4c5a 100644 --- a/doc/source/api/force_bdss.workspecs.rst +++ b/doc/source/api/force_bdss.workspecs.rst @@ -1,11 +1,11 @@ -force\_bdss\.workspecs package -============================== +force_bdss.workspecs package +============================ Submodules ---------- -force\_bdss\.workspecs\.workflow module ---------------------------------------- +force_bdss.workspecs.workflow module +------------------------------------ .. automodule:: force_bdss.workspecs.workflow :members: diff --git a/doc/source/conf.py b/doc/source/conf.py index 289f4699b729bf603e2e8449e66939191a6991d9..942d1f0f9a6dae14afd8e3f101a243278ecb770d 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -9,7 +9,9 @@ import os sys.path.insert(0, os.path.join( os.path.dirname(os.path.abspath(__file__)), "..", "..") ) -print(sys.path) + +from force_bdss.version import __version__ as RELEASE + MOCK_MODULES=[] def _warn_node(self, msg, node, **kwargs): @@ -58,8 +60,8 @@ source_suffix = '.rst' master_doc = 'index' project = u'FORCE' copyright = u'2017, FORCE Project' -version = '0.1.0' -release = '0.1.0.dev0' +version = ".".join(RELEASE.split(".")[0:3]) +release = RELEASE pygments_style = 'sphinx' html_theme = 'classic' html_static_path = ['_static'] diff --git a/doc/source/design.rst b/doc/source/design.rst new file mode 100644 index 0000000000000000000000000000000000000000..574edbf630d53b0541251535d9e5208d7ba62ddf --- /dev/null +++ b/doc/source/design.rst @@ -0,0 +1,37 @@ +Design +------ + +The application is based on three entities, as written in the introduction: + +- Multi Criteria Optimizer (MCO) +- DataSources +- Key Performance Indicator (KPI) Calculators + +There are a few core assumptions about each of these entities: + +- The MCO design must honor the execution model of Dakota, that is, spawn + a secondary process that performs a computation starting from a given set + of input parameters, and produces a resulting set of output parameters. + In our code, this secondary process is ``force_bdss`` itself, invoked with + the option ``--evaluate``. +- The DataSources are entities that, given the MCO parameters, provide some + numerical result. This result is passed to the KPI calculators. +- The KPI calculators now compute the final KPIs that are then returned to + the invoker MCO. + + +The result can be represented with the following data flow + + +1. The MCO produces and, by means of a Communicator, injects... +2. ...DataSourceParameters, that are passed to... +3. one or more DataSources, each performing some computation or data + extraction and produces +4. DataSourceResult, one per DataSource, are then passed (together with the + DataSourceParameters) to... +5. one or more KPICalculators, which perform final data evaluation on the + obtained values, eac producing KPIResult... +6. Whose values are then returned to the MCO via the Communicator. + +The resulting pipeline is therefore just two layers (DataSources, then +KPICalculators). diff --git a/doc/source/index.rst b/doc/source/index.rst index 2c604ad0e31baae9effe30724964b4e18244c5e1..467b4ca39d68e477b4a57f4f7f20188f44b4a1e5 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -10,6 +10,8 @@ User Manual :maxdepth: 1 Introduction <introduction> + Design <design> + Plugin development <plugin_development> API Reference diff --git a/doc/source/introduction.rst b/doc/source/introduction.rst index 1914d9dc1f45c5e83ba16f087f858eecc2414463..70d16fe0d02d1acd48902d2ba7ae5ff837b532a9 100644 --- a/doc/source/introduction.rst +++ b/doc/source/introduction.rst @@ -1,2 +1,23 @@ Introduction ------------ + +The Business Decision System is the CLI support for the evaluation of +Pareto front computations. It is a single executable ``force_bdss`` that +interprets a workflow specification file, normally generated via the GUI +workflow manager. + +By itself, the executable and the code implementing it provides no +functionality. All functionality comes from external plugins, extending the +API to provide new entities, specifically: + +- Multi Criteria Optimizer (MCO) +- DataSources +- Key Performance Indicator (KPI) Calculators + +Plugin support requires compliancy to the Force BDSS api for plugins. +Extensions are registered via setuptools entry points. + +Execution of the force bdss executable is simple. Invoke with:: + + force_bdss workflow.json + diff --git a/doc/source/plugin_development.rst b/doc/source/plugin_development.rst new file mode 100644 index 0000000000000000000000000000000000000000..231161baa9bca63d69ca55868abd8f40805e4173 --- /dev/null +++ b/doc/source/plugin_development.rst @@ -0,0 +1,25 @@ +Plugin Development +------------------ + +A single Plugin can provide one or more of the pluggable entities +described elsewhere (MCO/KPICalculators/DataSources). Multiple plugins can +be installed to provide a broad range of functionalities. + +Plugins must return "Bundles". Each Bundle acts as a Factory, providing +factory methods for one of the above pluggable entities and its associated +classes. + +To implement a new plugin, you must + +- define the entity you want to extend (e.g. ``MyOwnDataSource``) as a derived + class of the appropriate class (e.g. BaseDataSource), and reimplement + the appropriate methods. +- Define the model that this DataSource needs, by extending + ``BaseDataSourceModel`` and adding, with traits, the appropriate data that + are required by your data source to perform its task. +- Define the Bundle, by reimplementing BaseDataSourceBundle and reimplementing + its ``create_*`` methods to return the above entities. +- Define a ``Plugin`` by reimplementing ``BaseExtensionPlugin`` and + reimplementing its initialization defaults methods to return your bundle. +- add the plugin class in the setup.py entry_point, under the namespace + ``force.bdss.extensions`` diff --git a/setup.py b/setup.py index 9429bc9b5ec0fb1080280e1eedd00be192c07a95..c0842ae3490fb2a5dc566ad621e7539f600185c9 100644 --- a/setup.py +++ b/setup.py @@ -1,6 +1,25 @@ +import os from setuptools import setup, find_packages -VERSION = "0.1.0.dev1" +VERSION = "0.1.0.dev2" + + +# Read description +with open('README.rst', 'r') as readme: + README_TEXT = readme.read() + + +def write_version_py(): + filename = os.path.join( + os.path.dirname(__file__), + 'force_bdss', + 'version.py') + ver = "__version__ = '{}'\n" + with open(filename, 'w') as fh: + fh.write(ver.format(VERSION)) + + +write_version_py() setup( name="force_bdss",