teradataml 20.0.0.8__py3-none-any.whl

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

@@ -0,0 +1,191 @@
+def IDFFT2(data=None, data_filter_expr=None, human_readable=True,
+           output_fmt_content=None,
+           **generic_arguments):
+    """
+    DESCRIPTION:
+        The IDFFT2() function simply reverses the 2D Fourier Transform. It
+        takes either a logical matrix containing
+        Fourier coefficients in the form of complex number
+        elements, or, alternatively, in the form of amplitude-phase
+        pair (polar form) elements as inputs. The function then runs them
+        through a reverse-transform summation formula, and outputs
+        the original logical matrix (original 2D array) that was
+        input into the DFFT2() to generate the Fourier
+        coefficients.
+
+    PARAMETERS:
+        data:
+            Required Argument.
+            Specifies a logical matrix or TDAnalyticResult object on the data
+            that has been populated previously with 2D Fourier Transform
+            coefficients. The calculated coefficients may exist
+            in either of the following forms:
+                1. complex numbers - real and imaginary pairs.
+                2. amplitude-phase pairs.
+            Types: TDMatrix, TDAnalyticResult
+
+        data_filter_expr:
+            Optional Argument.
+            Specifies the filter expression for "data".
+            Types: ColumnExpression
+
+        human_readable:
+            Optional Argument.
+            Specifies whether the input rows are in human-readable / plottable form,
+            or if they are output in the raw-form. Human-readable
+            output is symmetric around 0, such as -3, -2, -1, 0, 1, 2, 3.
+            Raw output is sequential, starting at zero, such as 0, 1, 2, 3.
+            When set to True the output is in human-readable form,
+            otherwise the output is in raw form.
+            Default Value: True
+            Types: bool
+
+        output_fmt_content:
+            Optional Argument.
+            Specifies the Fourier coefficient's output form.
+            The default value is dependent on the datatype
+            of the input series, a single var input
+            generates COMPLEX output content by default,
+            a multi var input generates
+            MULTIVAR_COMPLEX output content by default.
+            Note:
+                1. Users can use COMPLEX or MULTIVAR_COMPLEX to
+                   request the Fourier coefficients in rectangular form.
+                2. AMPL_PHASE_RADIANS, AMPL_PHASE_DEGREES, AMPL_PHASE,
+                   MULTIVAR_AMPL_PHASE_RADIANS, MULTIVAR_AMPL_PHASE or
+                   MULTIVAR_AMPL_PHASE_DEGREES can be used to output
+                   the Fourier coefficients in the polar form and to further
+                   request the phase to be output in
+                   radians or degrees.
+                3. AMPL_PHASE is one of the permitted
+                   values, it is synonymous with AMPL_PHASE_RADIANS.
+                4. MULTIVAR_AMPL_PHASE is equivalent to
+                   MULTIVAR_AMPL_PHASE_RADIANS.
+            Permitted Values: COMPLEX,
+                              AMPL_PHASE_RADIANS,
+                              AMPL_PHASE_DEGREES,
+                              AMPL_PHASE,
+                              MULTIVAR_COMPLEX,
+                              MULTIVAR_AMPL_PHASE_RADIANS,
+                              MULTIVAR_AMPL_PHASE_DEGREES,
+                              MULTIVAR_AMPL_PHASE
+            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 IDFFT2.
+        Output teradataml DataFrames can be accessed using attribute
+        references, such as IDFFT2_obj.<attribute_name>.
+        Output teradataml DataFrame attribute name is:
+            1. result
+
+    RAISES:
+        TeradataMlException, TypeError, ValueError
+
+    EXAMPLES:
+        # Notes:
+        #     1. Get the connection to Vantage to execute the function.
+        #     2. One must import the required functions mentioned in
+        #        the example from teradataml.
+        #     3. Function will raise error if not supported on the Vantage
+        #        user is connected to.
+
+        # Check the list of available UAF analytic functions.
+        display_analytic_functions(type="UAF")
+
+        # Load the example data.
+        load_example_data("uaf", ["dfft2conv_real_4_4"])
+
+        # Compute the two-dimension fourier transform using the
+        # input matrix with real numbers only for the matrix id 33.
+
+        # Create teradataml DataFrame object.
+        data = DataFrame.from_table("dfft2conv_real_4_4")
+
+        # Create teradataml TDMatrix object.
+        td_matrix = TDMatrix(data=data,
+                             id="id",
+                             row_index="row_i",
+                             row_index_style="SEQUENCE",
+                             column_index="column_i",
+                             column_index_style="SEQUENCE",
+                             payload_field="magnitude",
+                             payload_content="REAL")
+
+        filter_expr = td_matrix.id==33
+        dfft2 = DFFT2(data=td_matrix,
+                      data_filter_expr=filter_expr,
+                      freq_style="K_INTEGRAL",
+                      human_readable=False,
+                      output_fmt_content="COMPLEX")
+
+        # Example 1: Compute the inverse of two-dimension fourier transform using matrix
+        #            with complex numbers.
+
+        # Create teradataml TDMatrix object.
+        data_matrix_df = TDMatrix(data=dfft2.result,
+                                  id="id",
+                                  row_index="ROW_I",
+                                  row_index_style="SEQUENCE",
+                                  column_index="COLUMN_I",
+                                  column_index_style="SEQUENCE",
+                                  payload_field=["REAL_magnitude", "IMAG_magnitude"],
+                                  payload_content="COMPLEX")
+
+        uaf_out = IDFFT2(data=data_matrix_df, human_readable=False)
+
+        # Print the result DataFrame.
+        print(uaf_out.result)
+
+        # Example 2: Compute the inverse of two-dimension fourier transform using
+        #            TDAnalyticResult instead of matrix with complex numbers.
+
+        # Create teradataml TDAnalyticResult object.
+        art_df = TDAnalyticResult(data=dfft2.result)
+
+        uaf_out = IDFFT2(data=art_df, human_readable=False)
+
+        # Print the result DataFrame.
+        print(uaf_out.result)
+
+    """
+

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

@@ -0,0 +1,236 @@
+def IDWT(data1=None, data1_filter_expr=None, data2=None, 
+         data2_filter_expr=None, wavelet=None, mode="symmetric", 
+         part=None, input_fmt_input_mode=None, 
+         output_fmt_index_style="NUMERICAL_SEQUENCE", 
+         **generic_arguments):
+    """
+    DESCRIPTION:
+        IDWT() is a function that performs inverse discrete wavelet transform (IDWT).
+
+    PARAMETERS:
+        data1:
+            Required Argument.
+            Specifies the input series. 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 input series. 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.
+            Permitted Values:
+                * 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
+
+        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:
+                * 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 IDWT.
+        Output teradataml DataFrames can be accessed using attribute 
+        references, such as IDWT_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 IDWT.
+        from teradataml import IDWT
+
+        # Load the example data.
+        load_example_data("uaf", ["idwt_dataTable", "idwt_filterTable"])
+
+        # Create teradataml DataFrame objects.
+        data1 = DataFrame.from_table("idwt_dataTable")
+        data2 = DataFrame.from_table("idwt_filterTable")
+
+        # Create teradataml TDSeries objects.
+        data1_series_df = TDSeries(data=data1,
+                                   id="id",
+                                   row_index="rowi",
+                                   row_index_style="SEQUENCE",
+                                   payload_field=["approx"],
+                                   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 inverse discrete wavelet transform using 2 series as input.
+        uaf_out = IDWT(data1=data1_series_df,
+                       data2=data2_series_df,
+                       data2_filter_expr=data2.id==1,
+                       input_fmt_input_mode="MANY2ONE",
+                       part='a')
+
+        # Print the result DataFrame.
+        print(uaf_out.result)
+
+        # Example 2: Perform inverse discrete wavelet transform using 1 series as input and wavelet parameter.
+
+        # Create teradataml TDSeries objects.
+        data_series_df = TDSeries(data=data1,
+                                  id="id",
+                                  row_index="rowi",
+                                  row_index_style="SEQUENCE",
+                                  payload_field=["approx", "detail"],
+                                  payload_content="MULTIVAR_REAL")
+
+        uaf_out = IDWT(data1=data_series_df,
+                       wavelet='haar')
+
+        # Print the result DataFrame.
+        print(uaf_out.result)
+    
+    """
+    

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

@@ -0,0 +1,226 @@
+def IDWT2D(data1=None, data1_filter_expr=None, data2=None, 
+           data2_filter_expr=None, wavelet=None, mode="symmetric", 
+           input_fmt_input_mode=None, 
+           output_fmt_index_style="NUMERICAL_SEQUENCE", 
+           **generic_arguments):
+    """
+    DESCRIPTION:
+        IDWT2D() function performs inverse discrete wavelet transform
+        (IDWT) for two-dimensional data. The algorithm is applied 
+        first horizontally by row axis, then vertically by column 
+        axis.
+
+    PARAMETERS:
+        data1:
+            Required Argument.
+            Specifies the input matrix. Multiple
+            payloads are supported, and each payload column is 
+            transformed independently. Only MULTIVAR_REAL payload
+            content type is supported.
+            Types: TDMatrix
+
+        data1_filter_expr:
+            Optional Argument.
+            Specifies the filter expression for "data1".
+            Types: ColumnExpression
+
+        data2:
+            Optional Argument.
+            Specifies the input series. 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
+
+        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:
+                * 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 IDWT2D.
+        Output teradataml DataFrames can be accessed using attribute 
+        references, such as IDWT2D_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 IDWT2D.
+        from teradataml import IDWT2D
+
+        # Load the example data.
+        load_example_data("uaf", ["idwt2d_dataTable", "idwt_filterTable"])
+
+        # Create teradataml DataFrame objects.
+        data1 = DataFrame.from_table("idwt2d_dataTable")
+        data2 = DataFrame.from_table("idwt_filterTable")
+
+        # Create teradataml TDMatrix object.
+        data1_matrix_df = TDMatrix(data=data1,
+                                   id="id",
+                                   row_index="y",
+                                   row_index_style="SEQUENCE",
+                                   column_index="x",
+                                   column_index_style="SEQUENCE",
+                                   payload_field="v",
+                                   payload_content="REAL")
+
+        # Execute DWT2D
+        uaf_out = DWT2D(data1=data1_matrix_df,
+                        wavelet='haar')
+
+        # Example 1: Perform inverse discrete wavelet transform using TDAnalyticResult
+        #            from DWT2D() as input and wavelet as 'haar'
+
+        # Create teradataml TDAnalyticResult object.
+        art_df = TDAnalyticResult(data=uaf_out.result)
+
+        uaf_out = IDWT2D(data1=art_df,
+                         wavelet='haar')
+
+        # Print the result DataFrame.
+        print(uaf_out.result)
+
+        # Example 1: Perform inverse discrete wavelet transform using TDAnalyticResult from DWT2D()
+        #            and TDSeries as input.
+
+        # Create teradataml TDSeries object.
+        data2_series_df = TDSeries(data=data2,
+                                   id="id",
+                                   row_index="seq",
+                                   row_index_style="SEQUENCE",
+                                   payload_field=["lo", "hi"],
+                                   payload_content="MULTIVAR_REAL")
+
+        uaf_out = IDWT2D(data1=art_df,
+                         data2=data2_series_df,
+                         data2_filter_expr=data2.id==1,
+                         input_fmt_input_mode='MANY2ONE')
+
+        # Print the result DataFrame.
+        print(uaf_out.result)
+    
+    """
+