libflame  revision_anchor
Functions
FLA_Hess_UT.h File Reference

(r)

Go to the source code of this file.

Functions

FLA_Error FLA_Hess_UT (FLA_Obj A, FLA_Obj T)
FLA_Error FLA_Hess_UT_internal (FLA_Obj A, FLA_Obj T, fla_hessut_t *cntl)
FLA_Error FLA_Hess_UT_create_T (FLA_Obj A, FLA_Obj *T)
FLA_Error FLA_Hess_UT_recover_tau (FLA_Obj T, FLA_Obj t)

Function Documentation

References FLA_Check_error_level(), FLA_Hess_UT_check(), and FLA_Hess_UT_internal().

{
  FLA_Error r_val;

  // Check parameters.
  if ( FLA_Check_error_level() >= FLA_MIN_ERROR_CHECKING )
    FLA_Hess_UT_check( A, T );

  // Invoke FLA_Hess_UT_internal() with the standard control tree.
  r_val = FLA_Hess_UT_internal( A, T, fla_hessut_cntl_leaf );

  return r_val;
}

References FLA_Obj_create(), FLA_Obj_datatype(), FLA_Obj_min_dim(), FLA_Obj_row_stride(), and FLA_Query_blocksize().

{
  FLA_Datatype datatype;
  dim_t        b_alg, k;
  dim_t        rs_T, cs_T;

  // Query the datatype of A.
  datatype = FLA_Obj_datatype( A );

  // Query the blocksize from the library.
  b_alg = FLA_Query_blocksize( datatype, FLA_DIMENSION_MIN );

  // Scale the blocksize by a pre-set global constant.
  b_alg = ( dim_t )( ( ( double ) b_alg ) * FLA_HESS_INNER_TO_OUTER_B_RATIO );

  // Query the minimum dimension of A.
  k = FLA_Obj_min_dim( A );

  // Figure out whether T should be row-major or column-major.
  if ( FLA_Obj_row_stride( A ) == 1 )
  {
    rs_T = 1;
    cs_T = b_alg;
  }
  else // if ( FLA_Obj_col_stride( A ) == 1 )
  {
    rs_T = k;
    cs_T = 1;
  }

  // Create a b_alg x k matrix to hold the block Householder transforms that
  // will be accumulated within the Hessenberg reduction algorithm.
  FLA_Obj_create( datatype, b_alg, k, rs_T, cs_T, T );

  return FLA_SUCCESS;
}

References FLA_Check_error_level(), FLA_Hess_UT_blf_var2(), FLA_Hess_UT_blf_var3(), FLA_Hess_UT_blf_var4(), FLA_Hess_UT_blk_var1(), FLA_Hess_UT_blk_var2(), FLA_Hess_UT_blk_var3(), FLA_Hess_UT_blk_var4(), FLA_Hess_UT_blk_var5(), FLA_Hess_UT_internal_check(), FLA_Hess_UT_opt_var1(), FLA_Hess_UT_opt_var2(), FLA_Hess_UT_opt_var3(), FLA_Hess_UT_opt_var4(), FLA_Hess_UT_opt_var5(), FLA_Hess_UT_unb_var1(), FLA_Hess_UT_unb_var2(), FLA_Hess_UT_unb_var3(), FLA_Hess_UT_unb_var4(), and FLA_Hess_UT_unb_var5().

Referenced by FLA_Hess_UT().

{
    FLA_Error r_val = FLA_SUCCESS;
    
    if ( FLA_Check_error_level() == FLA_FULL_ERROR_CHECKING )
        FLA_Hess_UT_internal_check( A, T, cntl );

    {
        if      ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT1 )
        {
            r_val = FLA_Hess_UT_unb_var1( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT2 )
        {
            r_val = FLA_Hess_UT_unb_var2( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT3 )
        {
            r_val = FLA_Hess_UT_unb_var3( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT4 )
        {
            r_val = FLA_Hess_UT_unb_var4( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT5 )
        {
            r_val = FLA_Hess_UT_unb_var5( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT1 )
        {
            r_val = FLA_Hess_UT_opt_var1( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT2 )
        {
            r_val = FLA_Hess_UT_opt_var2( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT3 )
        {
            r_val = FLA_Hess_UT_opt_var3( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT4 )
        {
            r_val = FLA_Hess_UT_opt_var4( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT5 )
        {
            r_val = FLA_Hess_UT_opt_var5( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT1 )
        {
            r_val = FLA_Hess_UT_blk_var1( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT2 )
        {
            r_val = FLA_Hess_UT_blk_var2( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT3 )
        {
            r_val = FLA_Hess_UT_blk_var3( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT4 )
        {
            r_val = FLA_Hess_UT_blk_var4( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT5 )
        {
            r_val = FLA_Hess_UT_blk_var5( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_BLK_FUS_VARIANT2 )
        {
            r_val = FLA_Hess_UT_blf_var2( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_BLK_FUS_VARIANT3 )
        {
            r_val = FLA_Hess_UT_blf_var3( A, T );
        }
        else if ( FLA_Cntl_variant( cntl ) == FLA_BLK_FUS_VARIANT4 )
        {
            r_val = FLA_Hess_UT_blf_var4( A, T );
        }
        else
        {
            FLA_Check_error_code( FLA_NOT_YET_IMPLEMENTED );
        }
    }

    return r_val;
}

References FLA_Check_error_level(), FLA_Cont_with_1x3_to_1x2(), FLA_Cont_with_3x1_to_2x1(), FLA_Hess_UT_recover_tau_check(), FLA_Hess_UT_recover_tau_submatrix(), FLA_Obj_length(), FLA_Part_1x2(), FLA_Part_2x1(), FLA_Repart_1x2_to_1x3(), and FLA_Repart_2x1_to_3x1().

{
  FLA_Obj TL,    TR,       T0,  T1,  T2;

  FLA_Obj tT,              t0,
          tB,              t1,
                           t2;

  dim_t b_alg, b;

  if ( FLA_Check_error_level() >= FLA_MIN_ERROR_CHECKING )
    FLA_Hess_UT_recover_tau_check( T, t );

  b_alg = FLA_Obj_length( T );

  FLA_Part_1x2( T,    &TL,  &TR,      0, FLA_LEFT );

  FLA_Part_2x1( t,    &tT, 
                      &tB,            0, FLA_TOP );

  while ( FLA_Obj_length( tT ) < FLA_Obj_length( t ) ){

    b = min( FLA_Obj_length( tB ), b_alg );

    FLA_Repart_1x2_to_1x3( TL,  /**/ TR,        &T0, /**/ &T1, &T2,
                           b, FLA_RIGHT );

    FLA_Repart_2x1_to_3x1( tT,                &t0, 
                        /* ** */            /* ** */
                                              &t1, 
                           tB,                &t2,        b, FLA_BOTTOM );

    /*------------------------------------------------------------*/

    FLA_Hess_UT_recover_tau_submatrix( T1, t1 );

    /*------------------------------------------------------------*/

    FLA_Cont_with_1x3_to_1x2( &TL,  /**/ &TR,        T0, T1, /**/ T2,
                              FLA_LEFT );

    FLA_Cont_with_3x1_to_2x1( &tT,                t0, 
                                                  t1, 
                            /* ** */           /* ** */
                              &tB,                t2,     FLA_TOP );
  }

  return FLA_SUCCESS;
}