Feature/add dynotears

RELEASE.md

@@ -1,5 +1,6 @@
 # Upcoming release
 
+* adding dynotears (`from_numpy_dynamic`, an algorithm for structure learning on Dynamic Bayesian Networks)
 * Add a count data type to the data generator using a zero-inflated Poisson
 * Set bounds/max class imbalance for binary features for the data generators
 * Add non-linear data generators for multiple data types

causalnex/structure/__init__.py

@@ -30,6 +30,6 @@
 ``causalnex.structure`` provides functionality to define or learn structure.
 """
 
-__all__ = ["StructureModel", "notears", "data_generators"]
+__all__ = ["StructureModel", "notears", "dynotears", "data_generators"]
 
 from .structuremodel import StructureModel

causalnex/structure/data_generators/__init__.py

@@ -40,14 +40,20 @@
     "generate_continuous_data",
     "generate_continuous_dataframe",
     "generate_count_dataframe",
+    "gen_stationary_dyn_net_and_df",
+    "generate_dataframe_dynamic",
+    "generate_structure_dynamic",
 ]
 
 from .core import generate_structure, nonlinear_sem_generator, sem_generator
 from .wrappers import (
+    gen_stationary_dyn_net_and_df,
     generate_binary_data,
     generate_binary_dataframe,
     generate_categorical_dataframe,
     generate_continuous_data,
     generate_continuous_dataframe,
     generate_count_dataframe,
+    generate_dataframe_dynamic,
+    generate_structure_dynamic,
 )

causalnex/structure/data_generators/core.py

@@ -39,11 +39,11 @@
 import pandas as pd
 from sklearn.gaussian_process.kernels import RBF, Kernel
 
+from causalnex.structure import StructureModel
 from causalnex.structure.categorical_variable_mapper import (
     VariableFeatureMapper,
     validate_schema,
 )
-from causalnex.structure.structuremodel import StructureModel
 
 # dict mapping distributions names to their functions
 __distribution_mapper = {
@@ -117,7 +117,10 @@ def generate_structure(
         edge_flags = np.tril(np.ones([num_nodes, num_nodes]), k=-1)
 
     else:
-        raise ValueError("unknown graph type")
+        raise ValueError(
+            "unknown graph type {t}. ".format(t=graph_type)
+            + "Available types are ['erdos-renyi', 'barabasi-albert', 'full']"
+        )
 
     # randomly permute edges - required because we limited ourselves to lower diagonal previously
     perms = np.random.permutation(np.eye(num_nodes, num_nodes))