teradataml 20.0.0.0__py3-none-any.whl → 20.0.0.1__py3-none-any.whl

teradataml/data/docs/sqle/docs_17_20/ROC.py

@@ -1,4 +1,4 @@
-def ROC(data=None, probability_column=None, observation_column=None, model_id_column=None, positive_label=None,
+def ROC(data=None, probability_column=None, observation_column=None, model_id_column=None, positive_class='1',
         num_thresholds=50, auc=True, gini=True, **generic_arguments):
     """
     DESCRIPTION:
@@ -48,8 +48,9 @@ def ROC(data=None, probability_column=None, observation_column=None, model_id_co
             Types: str
 
         positive_class:
-            Required Argument.
+            Optional Argument.
             Specifies the label of the positive class.
+            Default Value: '1'
             Types: str
 
         num_thresholds:

teradataml/data/docs/sqle/docs_17_20/SVMPredict.py

@@ -1,5 +1,6 @@
 def SVMPredict(object=None, newdata=None, id_column=None, accumulate=None,
-               output_prob=False, output_responses=None, **generic_arguments):
+               output_prob=False, output_responses=None, model_type='Classification',
+               **generic_arguments):
     """
     DESCRIPTION:
         The SVMPredict() function uses the model generated by the function SVM() to
@@ -57,6 +58,15 @@ def SVMPredict(object=None, newdata=None, id_column=None, accumulate=None,
             Note:
                 Only applicable when "output_prob" is 'True'.
             Types: str OR list of strs
+        
+        model_type:
+            Optional Argument.
+            Specifies the type of the analysis.
+            Note:
+                * Required for Regression problem.
+            Permitted Values: 'Classification', 'Regression'
+            Default Value: 'Classification'
+            Types: str
 
         **generic_arguments:
             Specifies the generic keyword arguments SQLE functions accept. Below
@@ -155,7 +165,8 @@ def SVMPredict(object=None, newdata=None, id_column=None, accumulate=None,
         SVMPredict_out1 = SVMPredict(newdata=transform_obj.result,
                                      object=svm_obj1.result,
                                      id_column="id",
-                                     accumulate="MedHouseVal"
+                                     accumulate="MedHouseVal",
+                                     model_type="Regression"
                                      )
 
         # Print the result DataFrame.

teradataml/data/docs/sqle/docs_17_20/ScaleFit.py

@@ -1,5 +1,9 @@
 def ScaleFit(data=None, target_columns=None, scale_method=None, miss_value="KEEP",
-             global_scale=False, multiplier='1', intercept='0', **generic_arguments):
+             global_scale=False, multiplier='1', intercept='0',
+             parameter_data=None, attribute_data=None, partition_columns=None,
+             ignoreinvalid_locationscale=False, unused_attributes="UNSCALED",
+             attribute_name_column=None, attribute_value_column=None, target_attributes=None,
+             **generic_arguments):
     """
     DESCRIPTION:
         ScaleFit() function outputs statistics to input to ScaleTransform() function,
@@ -15,6 +19,9 @@ def ScaleFit(data=None, target_columns=None, scale_method=None, miss_value="KEEP
             Required Argument.
             Specifies the input teradataml DataFrame column(s) for which to output statistics.
             The columns must contain numeric data in the range (-1e\u00B3\u2070\u2078, 1e\u00B3\u2070\u2078).
+            Note:
+                * This argument cannot be used with "target_attributes", "attribute_name_column", 
+                 "attribute_value_column".
             Types: str OR list of Strings (str)
 
         scale_method:
@@ -124,6 +131,60 @@ def ScaleFit(data=None, target_columns=None, scale_method=None, miss_value="KEEP
             Default Value: "0"
             Types: str OR list of String (str)
 
+        parameter_data:
+            Optional Argument.
+            Specifies the input teradataml DataFrame containing the parameters.
+            Note:
+                * This is valid when "data_partition_column" is used.
+            Types: teradataml DataFrame
+        
+        attribute_data:
+            Optional Argument.
+            Specifies the input teradataml DataFrame containing the attributes.
+            Note:
+                * This is valid when "data_partition_column" is used.
+            Types: teradataml DataFrame
+        
+        partition_columns:
+            Optional Argument.
+            Specifies the column name in the "data" to partition the input.
+            Types: str OR list of Strings (str)
+        
+        ignoreinvalid_locationscale:
+            Optional Argument.
+            Specifies whether to ignore invalid values of location and scale parameters.
+            Default Value: False
+            Types: bool
+        
+        unused_attributes:
+            Optional Argument.
+            Specifies whether to emit out unused attributes of different partitions
+            as unscaled values or NULLs (for dense input).
+            Permitted Values: 'NULLIFY', 'UNSCALED'
+            Default Value: 'UNSCALED'
+            Types: str
+        
+        attribute_name_column:
+            Optional Argument.
+            Specifies the column name in the "attribute_data" which contains attribute names.
+            Note:
+                * This is required for sparse input.
+            Types: str
+        
+        attribute_value_column:
+            Optional Argument.
+            Specifies the column name in the "attribute_data" which contains attribute values.
+            Note:
+                * This is required for sparse input.
+            Types: str
+        
+        target_attributes:
+            Optional Argument.
+            Specifies the attributes for which scaling should be performed.
+            Note:
+                * This is required for sparse input.
+            Types: str OR list of Strings (str)
+
         **generic_arguments:
             Specifies the generic keyword arguments SQLE functions accept.
             Below are the generic keyword arguments:
@@ -174,9 +235,16 @@ def ScaleFit(data=None, target_columns=None, scale_method=None, miss_value="KEEP
 
         # Load the example data.
         load_example_data("teradataml", ["scale_housing"])
+        load_example_data('scale', ["scale_attributes", "scale_parameters",
+        "scale_input_partitioned", "scale_input_sparse","scale_input_part_sparse"])
 
         # Create teradataml DataFrame.
         scaling_house = DataFrame.from_table("scale_housing")
+        scale_attribute = DataFrame.from_table("scale_attributes")
+        scale_parameter = DataFrame.from_table("scale_parameters")
+        scale_inp_part = DataFrame.from_table("scale_input_partitioned")
+        scale_inp_sparse = DataFrame.from_table("scale_input_sparse")
+        scale_inp_part_sparse = DataFrame.from_table("scale_input_part_sparse")
 
         # Check the list of available analytic functions.
         display_analytic_functions()
@@ -194,4 +262,54 @@ def ScaleFit(data=None, target_columns=None, scale_method=None, miss_value="KEEP
         # Print the result DataFrame.
         print(fit_obj.output)
         print(fit_obj.output_data)
+
+        # Example 2: Create statistics to scale "fare" and "age" columns
+        #            with respect to maximum absolute value with partition column
+        #            for dense input.
+        fit_obj = ScaleFit(data=scale_inp_part,
+                           attribute_data=scale_attribute,
+                           parameter_data=scale_parameter,
+                           target_columns=['fare', 'age'],
+                           scale_method="maxabs",
+                           miss_value="zero",
+                           global_scale=False,
+                           data_partition_column='pid',
+                           attribute_data_partition_column='pid',
+                           parameter_data_partition_column='pid')
+
+        # Print the result DataFrame.
+        print(fit_obj.output)
+        print(fit_obj.output_data)
+
+        # Example 3: Create statistics to scale "fare" column with respect to
+        #            range for sparse input.
+        fit_obj = ScaleFit(data=scale_inp_sparse,
+                           target_attribute=['fare'],
+                           scale_method="range",
+                           miss_value="keep",
+                           global_scale=False,
+                           attribute_name_column='attribute_column',
+                           attribute_value_column='attribute_value')
+
+        # Print the result DataFrame.
+        print(fit_obj.output)
+        print(fit_obj.output_data)
+
+        # Example 4: Create statistics to scale "fare" column with respect to
+        #            maximum absolute value for sparse input with partition column.
+        fit_obj = ScaleFit(data=scale_inp_part_sparse,
+                            parameter_data=scale_parameter,
+                            attribute_data=scale_attribute,
+                            scale_method="maxabs",
+                            miss_value="zero",
+                            global_scale=False,
+                            attribute_name_column='attribute_column',
+                            attribute_value_column='attribute_value',
+                            data_partition_column='pid',
+                            attribute_data_partition_column='pid',
+                            parameter_data_partition_column='pid')
+
+        # Print the result DataFrame.
+        print(fit_obj.output)
+        print(fit_obj.output_data)
     """

teradataml/data/docs/sqle/docs_17_20/ScaleTransform.py

@@ -1,4 +1,5 @@
-def ScaleTransform(data=None, object=None, accumulate=None, **generic_arguments):
+def ScaleTransform(data=None, object=None, accumulate=None, attribute_name_column=None,
+                   attribute_value_column=None, **generic_arguments):
     """
     DESCRIPTION:
         ScaleTransform() function scales specified columns in input data, using ScaleFit() function output.
@@ -21,6 +22,20 @@ def ScaleTransform(data=None, object=None, accumulate=None, **generic_arguments)
             Specifies the names of input teradataml DataFrame columns to copy to the output.
             Types: str OR list of Strings (str)
 
+        attribute_name_column:
+            Optional Argument.
+            Specifies the column name in the "attribute_data" which contains attribute names.
+            Note:
+                * This is required for sparse input.
+            Types: str
+        
+        attribute_value_column:
+            Optional Argument.
+            Specifies the column name in the "attribute_data" which contains attribute values.
+            Note:
+                * This is required for sparse input.
+            Types: str
+
         **generic_arguments:
             Specifies the generic keyword arguments SQLE functions accept.
             Below are the generic keyword arguments:
@@ -70,9 +85,16 @@ def ScaleTransform(data=None, object=None, accumulate=None, **generic_arguments)
 
         # Load the example data.
         load_example_data("teradataml", ["scale_housing"])
+        load_example_data('scale', ["scale_attributes", "scale_parameters",
+        "scale_input_partitioned", "scale_input_sparse","scale_input_part_sparse"])
 
         # Create teradataml DataFrame.
         scaling_house = DataFrame.from_table("scale_housing")
+        scale_attribute = DataFrame.from_table("scale_attributes")
+        scale_parameter = DataFrame.from_table("scale_parameters")
+        scale_inp_part = DataFrame.from_table("scale_input_partitioned")
+        scale_inp_sparse = DataFrame.from_table("scale_input_sparse")
+        scale_inp_part_sparse = DataFrame.from_table("scale_input_part_sparse")
 
         # Check the list of available analytic functions.
         display_analytic_functions()
@@ -107,4 +129,74 @@ def ScaleTransform(data=None, object=None, accumulate=None, **generic_arguments)
 
         # Print the result DataFrame.
         print(obj1.result)
+
+        # Example 3: Create statistics to scale "fare" and "age" columns with respect to
+        #            maximum absolute value for partitioned input.
+        fit_obj = ScaleFit(data=scale_inp_part,
+                           attribute_data=scale_attribute,
+                           parameter_data=scale_parameter,
+                           target_columns=['fare', 'age'],
+                           scale_method="maxabs",
+                           miss_value="zero",
+                           global_scale=False,
+                           data_partition_column='pid',
+                           attribute_data_partition_column='pid',
+                           parameter_data_partition_column='pid')
+
+        obj = ScaleTransform(data=scale_inp_part,
+                             object=fit_obj.output,
+                             accumulate=['pid','passenger'],
+                             data_partition_column='pid',
+                             object_partition_column='pid')
+        
+        # Print the result DataFrame.
+        print(obj.result)
+
+
+        # Example 4: Create statistics to scale "fare" column with respect to
+        #            range for sparse input.
+        fit_obj = ScaleFit(data=scale_inp_sparse,
+                           target_attribute=['fare'],
+                           scale_method="range",
+                           miss_value="keep",
+                           global_scale=False,
+                           attribute_name_column='attribute_column',
+                           attribute_value_column='attribute_value')
+
+        obj = ScaleTransform(data=scale_inp_sparse,
+                             object=fit_obj.output,
+                             accumulate=['passenger'],
+                             attribute_name_column='attribute_column',
+                             attribute_value_column='attribute_value'
+                     )
+        
+        # Print the result DataFrame.
+        print(obj.result)
+
+
+        # Example 5: Create statistics to scale "fare" column with respect to
+        #            maximum absolute value for sparse input with partition column.
+        fit_obj = ScaleFit(data=scale_inp_part_sparse,
+                           parameter_data=scale_parameter,
+                           attribute_data=scale_attribute,
+                           scale_method="maxabs",
+                           miss_value="zero",
+                           global_scale=False,
+                           attribute_name_column='attribute_column',
+                           attribute_value_column='attribute_value',
+                           data_partition_column='pid',
+                           attribute_data_partition_column='pid',
+                           parameter_data_partition_column='pid')
+
+        obj = ScaleTransform(data=scale_inp_part_sparse,
+                             object=fit_obj.output,
+                             accumulate=["passenger",'pid'],
+                             attribute_name_column='attribute_column',
+                             attribute_value_column='attribute_value',
+                             object_partition_column='pid',
+                             data_partition_column='pid')
+        
+        # Print the result DataFrame.
+        print(obj.result)
+
     """

teradataml/data/docs/sqle/docs_17_20/TDGLMPredict.py

@@ -1,5 +1,6 @@
 def TDGLMPredict(object=None, newdata=None, id_column=None, accumulate=None, output_prob=False,
-                 output_responses=None, **generic_arguments):
+                 output_responses=None, partition_column=None, family="GAUSSIAN",
+                 **generic_arguments):
     """
     DESCRIPTION:
         The TDGLMPredict() function predicts target values (regression) and class labels
@@ -57,6 +58,18 @@ def TDGLMPredict(object=None, newdata=None, id_column=None, accumulate=None, out
             Note:
                 Only applicable if "output_prob" is True.
             Types: str OR list of strs
+        
+        partition_column:
+            Optional Argument.
+            Specifies the column names of "data" on which to partition the input.
+            Types: str OR list of Strings (str)
+
+        family:
+            Optional Argument.
+            Specifies the distribution exponential family.
+            Permitted Values: 'GAUSSIAN', 'BINOMIAL'
+            Default Value: 'GAUSSIAN'
+            Types: str
 
         **generic_arguments:
             Specifies the generic keyword arguments SQLE functions accept. Below 
@@ -168,4 +181,153 @@ def TDGLMPredict(object=None, newdata=None, id_column=None, accumulate=None, out
 
         # Print the result DataFrame.
         print(TDGLMPredict_out1.result)
+
+        # Example 3 : TDGLMPredict() predicts the 'medv' using generated regression model by GLM
+        #             using stepwise regression algorithm.   
+        #             This example uses the boston dataset and scales the data.
+        #             Scaled data is used as input data to generate the GLM model and predict the target values.
+
+        # loading the example data
+        load_example_data("decisionforest", ["boston"])
+        load_example_data('glm', ['housing_train_segment', 'housing_train_parameter', 'housing_train_attribute'])
+
+        # Create teradataml DataFrame objects.
+        boston_df = DataFrame('boston')
+        housing_seg = DataFrame('housing_train_segment')
+        housing_parameter = DataFrame('housing_train_parameter')
+        housing_attribute = DataFrame('housing_train_attribute')
+
+        # scaling the data
+        # Scale "target_columns" with respect to 'STD' value of the column.
+        fit_obj = ScaleFit(data=boston_df,
+                        target_columns=['crim','zn','indus','chas','nox','rm','age','dis','rad','tax','ptratio','black','lstat',],
+                        scale_method="STD")
+
+        # Scale values specified in the input data using the fit data generated by the ScaleFit() function above.
+        obj = ScaleTransform(object=fit_obj.output,
+                            data=boston_df,
+                            accumulate=["id","medv"])
+
+        boston = obj.result
+
+        # Generate generalized linear model(GLM) using stepwise regression algorithm.
+        glm_1 = GLM(data=boston,
+                    input_columns=['indus','chas','nox','rm'],
+                    response_column='medv',
+                    family='GAUSSIAN',
+                    lambda1=0.02,
+                    alpha=0.33,
+                    batch_size=10,
+                    learning_rate='optimal',
+                    iter_max=36,
+                    iter_num_no_change=100,
+                    tolerance=0.0001,
+                    initial_eta=0.02,
+                    stepwise_direction='backward',
+                    max_steps_num=10)
+        
+        # Predict target values using generated regression model by GLM and newdata.
+        res = TDGLMPredict(id_column="id",
+                            newdata=boston,
+                            object=glm_1,
+                            accumulate='medv')
+        
+        # Print the result DataFrame.
+        print(res.result)
+
+        # Example 4 : TDGLMPredict() predicts the 'medv' using generated regression model by GLM
+        #             stepwise regression algorithm with initial_stepwise_columns.
+        glm_2 = GLM(data=boston,
+                    input_columns=['crim','zn','indus','chas','nox','rm','age','dis','rad','tax','ptratio','black','lstat'],
+                    response_column='medv',
+                    family='GAUSSIAN',
+                    lambda1=0.02,
+                    alpha=0.33,
+                    batch_size=10,
+                    learning_rate='optimal',
+                    iter_max=36,
+                    iter_num_no_change=100,
+                    tolerance=0.0001,
+                    initial_eta=0.02,
+                    stepwise_direction='bidirectional',
+                    max_steps_num=10,
+                    initial_stepwise_columns=['rad','tax']
+            )
+
+        # Predict target values using generated regression model by GLM and newdata.
+        res = TDGLMPredict(id_column="id",
+                            newdata=boston,
+                            object=glm_2,
+                            accumulate='medv')
+
+        # Print the result DataFrame.
+        print(res.result)
+
+        # Example 5 : TDGLMPredict() predicts the 'price' using generated regression model by GLM
+        #             using partition by key.
+        glm_3 = GLM(data=housing_seg,
+                    input_columns=['bedrooms', 'bathrms', 'stories', 'driveway', 'recroom', 'fullbase', 'gashw', 'airco'],
+                    response_column='price',
+                    family='GAUSSIAN',
+                    batch_size=10,
+                    iter_max=1000,
+                    data_partition_column='partition_id'
+            )
+
+        # Predict target values using generated regression model by GLM and newdata.
+        res = TDGLMPredict(id_column="sn",
+                            newdata=housing_seg,
+                            object=glm_3,
+                            accumulate='price',
+                            newdata_partition_column='partition_id',
+                            object_partition_column='partition_id')
+        
+        # Print the result DataFrame.
+        print(res.result)
+
+        # Example 6 : TDGLMPredict() predicts the 'price' using generated regression model by GLM
+        #             using partition by key with attribute data.
+        glm_4 = GLM(data=housing_seg,
+                    input_columns=['bedrooms', 'bathrms', 'stories', 'driveway', 'recroom', 'fullbase', 'gashw', 'airco'],
+                    response_column='price',
+                    family='GAUSSIAN',
+                    batch_size=10,
+                    iter_max=1000,
+                    data_partition_column='partition_id',
+                    attribute_data = housing_attribute,
+                    attribute_data_partition_column = 'partition_id'
+            )
+
+        # Predict target values using generated regression model by GLM and newdata.
+        res = TDGLMPredict(id_column="sn",
+                newdata=housing_seg,
+                object=glm_4,
+                accumulate='price',
+                newdata_partition_column='partition_id',
+                object_partition_column='partition_id')
+        
+        # Print the result DataFrame.
+        print(res.result)
+
+        # Example 7 : TDGLMPredict() predicts the 'homestyle' using generated generalized linear model by GLM
+        #             using partition by key with parameter data.
+        glm_5 = GLM(data=housing_seg,
+                    input_columns=['bedrooms', 'bathrms', 'stories', 'driveway', 'recroom', 'fullbase', 'gashw', 'airco'],
+                    response_column='homestyle',
+                    family='binomial',
+                    iter_max=1000,
+                    data_partition_column='partition_id',
+                    parameter_data = housing_parameter,
+                    parameter_data_partition_column = 'partition_id'
+            )
+
+        res = TDGLMPredict(id_column="sn",
+                            newdata=housing_seg,
+                            object=glm_5,
+                            accumulate='homestyle',
+                            newdata_partition_column='partition_id',
+                            object_partition_column='partition_id')
+        
+        # Print the result DataFrame.
+        print(res.result)
     """

teradataml/data/docs/sqle/docs_17_20/XGBoost.py

@@ -1,7 +1,7 @@
 def XGBoost(formula=None, data=None, input_columns=None, response_column=None, max_depth=5,
             num_boosted_trees=-1, min_node_size=1, seed=1, model_type='REGRESSION',
-            coverage_factor=1.0, min_impurity=0.0, lambda1=100000,
-            shrinkage_factor=0.1, column_sampling=1.0, iter_num=10, tree_size=-1,
+            coverage_factor=1.0, min_impurity=0.0, lambda1=1, shrinkage_factor=0.5, 
+            column_sampling=1.0, iter_num=10, tree_size=-1, base_score=0.0,
             **generic_arguments):
     """
     DESCRIPTION:
@@ -174,7 +174,7 @@ def XGBoost(formula=None, data=None, input_columns=None, response_column=None, m
             Notes:
                 * The "lambda1" must be in the range [0, 100000].
                 * The value 0 specifies no regularization.
-            Default Value: 100000
+            Default Value: 1
             Types: float OR int
 
         shrinkage_factor:
@@ -185,7 +185,7 @@ def XGBoost(formula=None, data=None, input_columns=None, response_column=None, m
             Notes:
                 * The "shrinkage_factor" is a DOUBLE PRECISION value in the range (0, 1].
                 * The value 1 specifies no shrinkage.
-            Default Value: 0.1
+            Default Value: 0.5
             Types: float
 
         column_sampling:
@@ -217,6 +217,14 @@ def XGBoost(formula=None, data=None, input_columns=None, response_column=None, m
             Default Value: -1
             Types: int
 
+        base_score:
+            Optional Argument.
+            Specifies the initial prediction value for all data points.
+            Note:
+                * The "base_score" must be in the range [-1e50, 1e50].
+            Default Value: 0.0
+            Types: float
+
         **generic_arguments:
             Specifies the generic keyword arguments SQLE functions accept. Below
             are the generic keyword arguments:

teradataml/data/docs/sqle/docs_17_20/XGBoostPredict.py

@@ -1,6 +1,6 @@
 def XGBoostPredict(newdata=None, object=None, id_column=None, num_boosted_tree=1000,
                    iter_num=3, accumulate=None, output_prob=False, model_type="REGRESSION",
-                   output_responses=None,  **generic_arguments):
+                   output_responses=None, detailed=False, **generic_arguments):
     """
     DESCRIPTION:
         The XGBoostPredict() function runs the predictive algorithm based on the model generated
@@ -123,6 +123,12 @@ def XGBoostPredict(newdata=None, object=None, id_column=None, num_boosted_tree=1
                   'Classification'.
             Types: str OR list of str(s)
 
+        detailed:
+            Optional Argument.
+            Specifies whether to output detailed information of each prediction.
+            Default Value: False
+            Types: bool
+
         **generic_arguments:
             Specifies the generic keyword arguments SQLE functions accept. Below
             are the generic keyword arguments: