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

teradataml/data/docs/uaf/docs_17_20/Convolve.py

@@ -41,7 +41,7 @@ def Convolve(data1=None, data1_filter_expr=None, data2=None,
         data2:
             Required Argument.
             Specifies the actual filter kernel.
-            Two time series have the following TDSeries  characteristics.
+            The time series have the following TDSeries characteristics.
                 1. "payload_content" must have one of these values:
                     * REAL
                     * COMPLEX
@@ -64,18 +64,21 @@ def Convolve(data1=None, data1_filter_expr=None, data2=None,
 
         algorithm:
             Optional Argument.
-            Specifies the options to use for convolving. Options
-            are 'CONV_SUMMATION' and 'CONV_DFFT'. If the
-            'CONV_SUMMATION' approach is used when one of the two
-            series has greater than 64 entries, then an error
-            is returned. When this parameter is not present,
-            the function selects the option based on the number
-            of entries in the source input series.
+            Specifies the options to use for convolving.
+            By default, the function selects the best option based
+            on the number of entries present in the two inputs,
+            and their types ( REAL, COMPLEX, and so on.)
+            CONV_SUMMATION only supports:
+                * REAL, REAL
+                * REAL, MULTIVAR_REAL
+                * MULTIVAR_REAL, REAL
+                * MULTIVAR_REAL, MULTIVAR_REAL
             Note:
                 * This parameter is usually used for testing.
                   If this parameter is not included, the internal
-                  planning logic selects the best option based
-                  on the number of entries in the source input series.
+                  planning logic selects the best option based on
+                  the number of entries present in the two inputs,
+                  and their types ( REAL, COMPLEX, and so on.)
             Permitted Values: CONV_SUMMATION, CONV_DFFT
             Types: str
 

teradataml/data/docs/uaf/docs_17_20/Convolve2.py

@@ -154,7 +154,6 @@ def Convolve2(data1=None, data1_filter_expr=None, data2=None,
         data3 = DataFrame.from_table("Convolve2RealsLeft")
         data4 = DataFrame.from_table("Convolve2RealsLeft")
 
-
         # Example 1: Apply the Convolve2() function when payload fields of two matrices
         #            are the different to convolve two matrices into a new source 
         #            image matrix.
@@ -168,6 +167,7 @@ def Convolve2(data1=None, data1_filter_expr=None, data2=None,
                                    column_index='column_i',
                                    payload_field=["B"],
                                    payload_content="REAL")
+
         data2_matrix_df = TDMatrix(data=data2,
                                    id='id',
                                    row_index_style="sequence",
@@ -176,6 +176,7 @@ def Convolve2(data1=None, data1_filter_expr=None, data2=None,
                                    column_index='column_i',
                                    payload_field=["A"],
                                    payload_content="REAL")
+
         # Convolve the "data1_matrix_df" and "data2_matrix_df" matrices using the Convolve2() function.
         uaf_out1 = Convolve2(data1=data1_matrix_df,
                              data2=data2_matrix_df,
@@ -196,6 +197,7 @@ def Convolve2(data1=None, data1_filter_expr=None, data2=None,
                                    column_index='col_seq',
                                    payload_field=["A"],
                                    payload_content="REAL")
+
         data4_matrix_df = TDMatrix(data=data4,
                                    id='id',
                                    row_index_style="sequence",
@@ -204,6 +206,7 @@ def Convolve2(data1=None, data1_filter_expr=None, data2=None,
                                    column_index='col_seq',
                                    payload_field=["A"],
                                    payload_content="REAL")
+                                   
         # Convolve the "data3_matrix_df" and "data4_matrix_df" matrices using the Convolve2() function.
         uaf_out2 = Convolve2(data1=data3_matrix_df,
                              data2=data4_matrix_df,

teradataml/data/docs/uaf/docs_17_20/CopyArt.py

@@ -0,0 +1,145 @@
+def CopyArt(data=None, database_name = None,
+            table_name = None, map_name = None,
+            **generic_arguments):
+    """
+    DESCRIPTION:
+        CopyArt() function creates a copy of an existing analytics result table (ART).
+
+    PARAMETERS:
+        data:
+            Required Argument.
+            Specifies the ART data to be copied.
+            Types: DataFrame
+
+        database_name:
+            Required Argument.
+            Specifies the name of the destination database for copied ART.
+            Types: str
+
+        table_name:
+            Required Argument.
+            Specifies the name of the destination table for copied ART.
+            Types: str
+
+        map_name:
+            Optional Argument.
+            Specifies the name of the map for the destination ART.
+            By default, it refers to the map of the 'data'.
+            Types: str
+
+        **generic_arguments:
+            Specifies the generic keyword arguments of UAF functions.
+            Below are the generic keyword arguments:
+                persist:
+                    Optional Argument.
+                    Specifies whether to persist the results of the
+                    function in a table or not. When set to True,
+                    results are persisted in a table; otherwise,
+                    results are garbage collected at the end of the
+                    session.
+                    Note that, when UAF function is executed, an
+                    analytic result table (ART) is created.
+                    Default Value: False
+                    Types: bool
+
+                volatile:
+                    Optional Argument.
+                    Specifies whether to put the results of the
+                    function in a volatile ART or not. When set to
+                    True, results are stored in a volatile ART,
+                    otherwise not.
+                    Default Value: False
+                    Types: bool
+
+                output_table_name:
+                    Optional Argument.
+                    Specifies the name of the table to store results.
+                    If not specified, a unique table name is internally
+                    generated.
+                    Types: str
+
+                output_db_name:
+                    Optional Argument.
+                    Specifies the name of the database to create output
+                    table into. If not specified, table is created into
+                    database specified by the user at the time of context
+                    creation or configuration parameter. Argument is ignored,
+                    if "output_table_name" is not specified.
+                    Types: str
+    
+    RETURNS:
+        Instance of CopyArt.
+        Output teradataml DataFrames can be accessed using attribute
+        references, such as obj.<attribute_name>.
+        Output teradataml DataFrame attribute name is:
+            1. result
+
+    RAISES:
+        TeradataMlException, TypeError, ValueError
+
+    EXAMPLES:
+        # Notes:
+        #     1. Get the connection to Vantage, before importing the
+        #        function in user space.
+        #     2. User can import the function, if it is available on
+        #        Vantage user is connected to.
+        #     3. To check the list of UAF analytic functions available
+        #        on Vantage user connected to, use
+        #        "display_analytic_functions()".
+
+        # Check the list of available UAF analytic functions.
+        display_analytic_functions(type="UAF")
+
+        # Import function CopyArt.
+        from teradataml import CopyArt, AutoArima
+
+        # Load the example data.
+        load_example_data("uaf", ["blood2ageandweight"])
+
+        # Create teradataml DataFrame object.
+        data = DataFrame.from_table("blood2ageandweight")
+
+        # Create teradataml TDSeries object.
+        data_series_df = TDSeries(data=data,
+                                  id="PatientID",
+                                  row_index="SeqNo",
+                                  row_index_style="SEQUENCE",
+                                  payload_field="BloodFat",
+                                  payload_content="REAL")
+
+        # Execute AutoArima function to create ART.
+        uaf_out = AutoArima(data=data_series_df,
+                            start_pq_nonseasonal=[1, 1],
+                            seasonal=False,
+                            constant=True,
+                            algorithm="MLE",
+                            fit_percentage=80,
+                            stepwise=True,
+                            nmodels=7,
+                            fit_metrics=True,
+                            residuals=True)
+
+        # Example 1: Execute CopyArt function to copy ART to a destination table name
+        #            with persist option.
+        res = CopyArt(data=uaf_out.result,
+                      database_name="alice",
+                      table_name="copied_table",
+                      persist=True)
+        print(res.result)
+
+        # Example 2: Execute CopyArt function to copy ART to a destination table name.
+        res = CopyArt(data=uaf_out.result,
+                      database_name="alice",
+                      table_name="copied_table2")
+
+        # Print the result DataFrame.
+        print(res.result)
+
+        # Example 3: Copy ART to a destination table name using uaf object.
+        res = uaf_out.copy(database_name="alice",
+                           table_name="copied_table3")
+
+        # Print the result DataFrame.
+        print(res.result)
+
+    """

teradataml/data/docs/uaf/docs_17_20/CumulPeriodogram.py

@@ -21,7 +21,7 @@ def CumulPeriodogram(data=None, data_filter_expr=None,
             2. Use ArimaValidate() to validate spectral candidates.
             4. Execute CumulPeriodogram() using the residuals.
             5. See the null hypothesis result from CumulPeriodogram().
-            6. Use Plot() to plot the results.
+            6. Use DataFrame.plot() to plot the results.
 
     PARAMETERS:
         data:
@@ -143,7 +143,6 @@ def CumulPeriodogram(data=None, data_filter_expr=None,
                                        fit_metrics=True,
                                        residuals=True)
 
-
         # Example 1: Perform statistical test using CumulPeriodogram()
         #            with input as TDSeries object created over the 'fitresiduals'
         #            attribute of arima_validate generated by running ArimaValidate() and
@@ -158,7 +157,8 @@ def CumulPeriodogram(data=None, data_filter_expr=None,
                                   payload_field="RESIDUAL",
                                   payload_content="REAL")
 
-        uaf_out = CumulPeriodogram(data=data_series_df, significance_level=0.05)
+        uaf_out = CumulPeriodogram(data=data_series_df, 
+                                   significance_level=0.05)
 
         # Print the result DataFrames.
         print(uaf_out.result)
@@ -174,7 +174,8 @@ def CumulPeriodogram(data=None, data_filter_expr=None,
         # generated by ArimaValidate() function with layer as 'ARTFITRESIDUALS'.
         art_df = TDAnalyticResult(data=arima_validate.result, layer="ARTFITRESIDUALS")
 
-        uaf_out = CumulPeriodogram(data=art_df, significance_level=0.05)
+        uaf_out = CumulPeriodogram(data=art_df, 
+                                   significance_level=0.05)
 
         # Print the result DataFrames.
         print(uaf_out.result)

teradataml/data/docs/uaf/docs_17_20/DFFT2Conv.py

@@ -174,10 +174,10 @@ def DFFT2Conv(data=None, data_filter_expr=None, conv=None,
         # input matrix with real numbers only for the matrix id 33.
         filter_expr = td_matrix.id==33
         dfft2_out = DFFT2(data=td_matrix,
-                        data_filter_expr=filter_expr,
-                        freq_style="K_INTEGRAL",
-                        human_readable=False,
-                        output_fmt_content="COMPLEX")
+                          data_filter_expr=filter_expr,
+                          freq_style="K_INTEGRAL",
+                          human_readable=False,
+                          output_fmt_content="COMPLEX")
 
         # Example 1: Convert the complex(REAL,IMAGINARY) output of DFFT2() to
         #            polar(AMPLITUDE,PHASE) in RADIAN format using TDMatrix

teradataml/data/docs/uaf/docs_17_20/DWT.py

@@ -0,0 +1,235 @@
+def DWT(data1=None, data1_filter_expr=None, data2=None, 
+        data2_filter_expr=None, wavelet=None, mode="symmetric", 
+        level=1, part=None, input_fmt_input_mode=None, 
+        output_fmt_index_style="NUMERICAL_SEQUENCE", 
+        **generic_arguments):
+    """
+    DESCRIPTION:
+        DWT() is a function that performs discrete wavelet
+        transform (DWT).
+
+    PARAMETERS:
+        data1:
+            Required Argument.
+            Specifies the series to be used as an input.
+            Multiple payloads are supported, and each payload column is
+            transformed independently. Only REAL or MULTIVAR_REAL
+            payload content types are supported.
+            Types: TDSeries
+
+        data1_filter_expr:
+            Optional Argument.
+            Specifies the filter expression for "data1".
+            Types: ColumnExpression
+
+        data2:
+            Optional Argument.
+            Specifies the series to be used as an input. The
+            series specifies the filter. It should have two payload
+            columns corresponding to low and high pass 
+            filters. Only MULTIVAR_REAL payload content type is
+            supported.
+            Types: TDSeries
+
+        data2_filter_expr:
+            Optional Argument.
+            Specifies the filter expression for "data2".
+            Types: ColumnExpression
+
+        wavelet:
+            Optional Argument.
+            Specifies the name of the wavelet.
+            Option families and names are:
+                * Daubechies: 'db1' or 'haar', 'db2', 'db3', .... ,'db38'
+                * Coiflets: 'coif1', 'coif2', ... , 'coif17'
+                * Symlets: 'sym2', 'sym3', ... ,' sym20'
+                * Discrete Meyer: 'dmey'
+                * Biorthogonal: 'bior1.1', 'bior1.3', 'bior1.5',
+                                'bior2.2', 'bior2.4', 'bior2.6',
+                                'bior2.8', 'bior3.1', 'bior3.3',
+                                'bior3.5', 'bior3.7', 'bior3.9',
+                                'bior4.4', 'bior5.5', 'bior6.8'
+                * Reverse Biorthogonal: 'rbio1.1', 'rbio1.3',
+                                        'rbio1.5' 'rbio2.2',
+                                        'rbio2.4', 'rbio2.6',
+                                        'rbio2.8', 'rbio3.1',
+                                        'rbio3.3', 'rbio3.5',
+                                        'rbio3.7','rbio3.9',
+                                        'rbio4.4', 'rbio5.5',
+                                        'rbio6.8'
+            Note:
+                * If 'wavelet' is specified, do not include a second
+                  input series for the function. Otherwise, include
+                  a second input series to provide the filter.
+                * Data type is case-sensitive.
+            Types: str
+
+        mode:
+            Optional Argument.
+            Specifies the signal extension mode. Data type is
+            case-insensitive.
+            Permitted Values:
+                * symmetric, sym, symh
+                * reflect, symw
+                * smooth, spd, sp1
+                * constant, sp0
+                * zero, zpd
+                * periodic, ppd
+                * periodization, per
+                * antisymmetric, asym, asymh
+                * antireflect, asymw
+            Default Value: symmetric
+            Types: str
+
+        level:
+            Optional Argument.
+            Specifies the level of decomposition.
+            Valid values are [1,15].
+            Default Value: 1
+            Types: int
+
+        part:
+            Optional Argument.
+            Specifies the indicator that the input is partial decomposition
+            result.
+            Note:
+                Data type is case-insensitive.
+            Permitted Values:
+                * a - the approximation
+                * d - the detail of decomposition of result.
+            Types: str
+
+        input_fmt_input_mode:
+            Optional Argument.
+            Specifies the input mode supported by the function.
+            When there are two input series, then the input_fmt_input_mode
+            specification is mandatory.
+            Permitted Values:
+            The input_fmt_input_mode parameter has the following options:
+                * ONE2ONE: Both the primary and secondary series
+                           specifications contain a series name which
+                           identifies the two series in the function.
+                * MANY2ONE: The MANY specification is the primary series
+                            declaration. The secondary series specification
+                            contains a series name that identifies the single
+                            secondary series.
+                * MATCH: Both series are defined by their respective series
+                         specification instance name declarations.
+            Types: str
+
+        output_fmt_index_style:
+            Optional Argument.
+            Specifies the index style of the output format.
+            Permitted Values: NUMERICAL_SEQUENCE
+            Default Value: NUMERICAL_SEQUENCE
+            Types: str
+
+        **generic_arguments:
+            Specifies the generic keyword arguments of UAF functions.
+            Below are the generic keyword arguments:
+                persist:
+                    Optional Argument.
+                    Specifies whether to persist the results of the
+                    function in a table or not. When set to True,
+                    results are persisted in a table; otherwise,
+                    results are garbage collected at the end of the
+                    session.
+                    Note that, when UAF function is executed, an 
+                    analytic result table (ART) is created.
+                    Default Value: False
+                    Types: bool
+
+                volatile:
+                    Optional Argument.
+                    Specifies whether to put the results of the
+                    function in a volatile ART or not. When set to
+                    True, results are stored in a volatile ART,
+                    otherwise not.
+                    Default Value: False
+                    Types: bool
+
+                output_table_name:
+                    Optional Argument.
+                    Specifies the name of the table to store results. 
+                    If not specified, a unique table name is internally 
+                    generated.
+                    Types: str
+
+                output_db_name:
+                    Optional Argument.
+                    Specifies the name of the database to create output 
+                    table into. If not specified, table is created into 
+                    database specified by the user at the time of context 
+                    creation or configuration parameter. Argument is ignored,
+                    if "output_table_name" is not specified.
+                    Types: str
+
+
+    RETURNS:
+        Instance of DWT.
+        Output teradataml DataFrames can be accessed using attribute 
+        references, such as DWT_obj.<attribute_name>.
+        Output teradataml DataFrame attribute name is:
+            1. result
+
+
+    RAISES:
+        TeradataMlException, TypeError, ValueError
+
+
+    EXAMPLES:
+        # Notes:
+        #     1. Get the connection to Vantage, before importing the
+        #        function in user space.
+        #     2. User can import the function, if it is available on
+        #        Vantage user is connected to.
+        #     3. To check the list of UAF analytic functions available
+        #        on Vantage user connected to, use
+        #        "display_analytic_functions()".
+
+        # Check the list of available UAF analytic functions.
+        display_analytic_functions(type="UAF")
+
+        # Import function DWT.
+        from teradataml import DWT
+
+        # Load the example data.
+        load_example_data("uaf", ["dwt_dataTable", "dwt_filterTable"])
+
+        # Create teradataml DataFrame objects.
+        data1 = DataFrame.from_table("dwt_dataTable")
+        data2 = DataFrame.from_table("dwt_filterTable")
+
+        # Create teradataml TDSeries objects.
+        data1_series_df = TDSeries(data=data1,
+                                   id="id",
+                                   row_index="rowi",
+                                   row_index_style="SEQUENCE",
+                                   payload_field="v",
+                                   payload_content="REAL")
+
+        data2_series_df = TDSeries(data=data2,
+                                   id="id",
+                                   row_index="seq",
+                                   row_index_style="SEQUENCE",
+                                   payload_field=["lo", "hi"],
+                                   payload_content="MULTIVAR_REAL")
+
+        # Example 1: Perform discrete wavelet transform using two series as input.
+        uaf_out = DWT(data1=data1_series_df,
+                      data2=data2_series_df,
+                      data2_filter_expr=data2_series_df.id==1,
+                      input_fmt_input_mode='MANY2ONE')
+
+        # Print the result DataFrame.
+        print(uaf_out.result)
+
+       # Example 2: Perform discrete wavelet transform using single series as input and the wavelet parameter.
+        uaf_out = DWT(data1=data1_series_df,
+                      wavelet='haar')
+
+        # Print the result DataFrame.
+        print(uaf_out.result)
+    
+    """
+