FLA_Lyap.h File Reference

(r)

Go to the source code of this file.

Functions
FLA_Error	FLASH_Lyap (FLA_Trans trans, FLA_Obj isgn, FLA_Obj A, FLA_Obj C, FLA_Obj scale)
FLA_Error	FLA_Lyap (FLA_Trans trans, FLA_Obj isgn, FLA_Obj A, FLA_Obj C, FLA_Obj scale)
FLA_Error	FLA_Lyap_internal (FLA_Trans trans, FLA_Obj isgn, FLA_Obj A, FLA_Obj C, FLA_Obj scale, fla_lyap_t *cntl)
FLA_Error	FLA_Lyap_n (FLA_Obj isgn, FLA_Obj A, FLA_Obj C, FLA_Obj scale, fla_lyap_t *cntl)
FLA_Error	FLA_Lyap_h (FLA_Obj isgn, FLA_Obj A, FLA_Obj C, FLA_Obj scale, fla_lyap_t *cntl)

Function Documentation

FLA_Lyap()

FLA_Error FLA_Lyap	(	FLA_Trans	trans,
		FLA_Obj	isgn,
		FLA_Obj	A,
		FLA_Obj	C,
		FLA_Obj	scale
	)

{
  FLA_Error r_val;
 
  // Check parameters.
  if ( FLA_Check_error_level() >= FLA_MIN_ERROR_CHECKING )
    FLA_Lyap_check( trans, isgn, A, C, scale );
 
  // Invoke FLA_Lyap_internal() with the appropriate control tree.
  r_val = FLA_Lyap_internal( trans, isgn, A, C, scale, fla_lyap_cntl );
 
  return r_val;
}

References FLA_Check_error_level(), FLA_Lyap_check(), fla_lyap_cntl, FLA_Lyap_internal(), and i.

FLA_Lyap_h()

FLA_Error FLA_Lyap_h	(	FLA_Obj	isgn,
		FLA_Obj	A,
		FLA_Obj	C,
		FLA_Obj	scale,
		fla_lyap_t *	cntl
	)

{
    FLA_Error r_val = FLA_SUCCESS;
 
    if      ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT1 )
    {
        r_val = FLA_Lyap_h_unb_var1( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT2 )
    {
        r_val = FLA_Lyap_h_unb_var2( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT3 )
    {
        r_val = FLA_Lyap_h_unb_var3( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT4 )
    {
        r_val = FLA_Lyap_h_unb_var4( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT1 )
    {
        r_val = FLA_Lyap_h_opt_var1( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT2 )
    {
        r_val = FLA_Lyap_h_opt_var2( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT3 )
    {
        r_val = FLA_Lyap_h_opt_var3( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT4 )
    {
        r_val = FLA_Lyap_h_opt_var4( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT1 )
    {
        r_val = FLA_Lyap_h_blk_var1( isgn, A, C, scale, cntl );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT2 )
    {
        r_val = FLA_Lyap_h_blk_var2( isgn, A, C, scale, cntl );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT3 )
    {
        r_val = FLA_Lyap_h_blk_var3( isgn, A, C, scale, cntl );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT4 )
    {
        r_val = FLA_Lyap_h_blk_var4( isgn, A, C, scale, cntl );
    }
    else
    {
        FLA_Check_error_code( FLA_NOT_YET_IMPLEMENTED );
    }
 
    return r_val;
}

References FLA_Lyap_h_blk_var1(), FLA_Lyap_h_blk_var2(), FLA_Lyap_h_blk_var3(), FLA_Lyap_h_blk_var4(), FLA_Lyap_h_opt_var1(), FLA_Lyap_h_opt_var2(), FLA_Lyap_h_opt_var3(), FLA_Lyap_h_opt_var4(), FLA_Lyap_h_unb_var1(), FLA_Lyap_h_unb_var2(), FLA_Lyap_h_unb_var3(), FLA_Lyap_h_unb_var4(), and i.

Referenced by FLA_Lyap_internal().

FLA_Lyap_internal()

FLA_Error FLA_Lyap_internal	(	FLA_Trans	trans,
		FLA_Obj	isgn,
		FLA_Obj	A,
		FLA_Obj	C,
		FLA_Obj	scale,
		fla_lyap_t *	cntl
	)

{
    FLA_Error r_val = FLA_SUCCESS;
 
    if ( FLA_Check_error_level() == FLA_FULL_ERROR_CHECKING )
        FLA_Lyap_internal_check( trans, isgn, A, C, scale, cntl );
 
    if      ( FLA_Cntl_matrix_type( cntl ) == FLA_HIER &&
              FLA_Obj_elemtype( A ) == FLA_MATRIX &&
              FLA_Cntl_variant( cntl ) == FLA_SUBPROBLEM )
    {
        // Recurse
        r_val = FLA_Lyap_internal( trans,
                                   isgn,
                                   *FLASH_OBJ_PTR_AT( A ),
                                   *FLASH_OBJ_PTR_AT( C ),
                                   scale,
                                   flash_lyap_cntl );
    }
    else if ( FLA_Cntl_matrix_type( cntl ) == FLA_HIER &&
              FLA_Obj_elemtype( A ) == FLA_SCALAR &&
              FLASH_Queue_get_enabled( ) )
    {
        // Enqueue
        ENQUEUE_FLASH_Lyap( trans, isgn, A, C, scale, cntl );
    }
    else
    {
        if ( FLA_Cntl_matrix_type( cntl ) == FLA_HIER &&
             FLA_Obj_elemtype( A ) == FLA_SCALAR &&
             !FLASH_Queue_get_enabled( ) )
        {
            // Execute leaf
            cntl = fla_lyap_cntl_leaf;
        }
 
        // Parameter combinations
        if      ( trans == FLA_NO_TRANSPOSE )
        {
            r_val = FLA_Lyap_n( isgn, A, C, scale, cntl );
        }
        else if ( trans == FLA_TRANSPOSE || trans == FLA_CONJ_TRANSPOSE )
        {
            r_val = FLA_Lyap_h( isgn, A, C, scale, cntl );
        }
    }
 
    return r_val;
}

References FLA_Check_error_level(), fla_lyap_cntl_leaf, FLA_Lyap_h(), FLA_Lyap_internal(), FLA_Lyap_internal_check(), FLA_Lyap_n(), FLA_Obj_elemtype(), flash_lyap_cntl, FLASH_Queue_get_enabled(), and i.

Referenced by FLA_Lyap(), FLA_Lyap_h_blk_var1(), FLA_Lyap_h_blk_var2(), FLA_Lyap_h_blk_var3(), FLA_Lyap_h_blk_var4(), FLA_Lyap_h_task(), FLA_Lyap_internal(), FLA_Lyap_n_blk_var1(), FLA_Lyap_n_blk_var2(), FLA_Lyap_n_blk_var3(), FLA_Lyap_n_blk_var4(), FLA_Lyap_n_task(), FLA_Lyap_task(), and FLASH_Lyap().

FLA_Lyap_n()

FLA_Error FLA_Lyap_n	(	FLA_Obj	isgn,
		FLA_Obj	A,
		FLA_Obj	C,
		FLA_Obj	scale,
		fla_lyap_t *	cntl
	)

{
    FLA_Error r_val = FLA_SUCCESS;
 
    if      ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT1 )
    {
        r_val = FLA_Lyap_n_unb_var1( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT2 )
    {
        r_val = FLA_Lyap_n_unb_var2( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT3 )
    {
        r_val = FLA_Lyap_n_unb_var3( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNBLOCKED_VARIANT4 )
    {
        r_val = FLA_Lyap_n_unb_var4( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT1 )
    {
        r_val = FLA_Lyap_n_opt_var1( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT2 )
    {
        r_val = FLA_Lyap_n_opt_var2( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT3 )
    {
        r_val = FLA_Lyap_n_opt_var3( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_UNB_OPT_VARIANT4 )
    {
        r_val = FLA_Lyap_n_opt_var4( isgn, A, C );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT1 )
    {
        r_val = FLA_Lyap_n_blk_var1( isgn, A, C, scale, cntl );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT2 )
    {
        r_val = FLA_Lyap_n_blk_var2( isgn, A, C, scale, cntl );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT3 )
    {
        r_val = FLA_Lyap_n_blk_var3( isgn, A, C, scale, cntl );
    }
    else if ( FLA_Cntl_variant( cntl ) == FLA_BLOCKED_VARIANT4 )
    {
        r_val = FLA_Lyap_n_blk_var4( isgn, A, C, scale, cntl );
    }
    else
    {
        FLA_Check_error_code( FLA_NOT_YET_IMPLEMENTED );
    }
 
    return r_val;
}

References FLA_Lyap_n_blk_var1(), FLA_Lyap_n_blk_var2(), FLA_Lyap_n_blk_var3(), FLA_Lyap_n_blk_var4(), FLA_Lyap_n_opt_var1(), FLA_Lyap_n_opt_var2(), FLA_Lyap_n_opt_var3(), FLA_Lyap_n_opt_var4(), FLA_Lyap_n_unb_var1(), FLA_Lyap_n_unb_var2(), FLA_Lyap_n_unb_var3(), FLA_Lyap_n_unb_var4(), and i.

Referenced by FLA_Lyap_internal().

FLASH_Lyap()

FLA_Error FLASH_Lyap	(	FLA_Trans	trans,
		FLA_Obj	isgn,
		FLA_Obj	A,
		FLA_Obj	C,
		FLA_Obj	scale
	)

{
  FLA_Error r_val;
 
  // Check parameters.
  if ( FLA_Check_error_level() >= FLA_MIN_ERROR_CHECKING )
    FLA_Lyap_check( trans, isgn, A, C, scale );
 
  // Begin a parallel region.
  FLASH_Queue_begin();
  
  // Enqueue tasks via a SuperMatrix-aware control tree.
  r_val = FLA_Lyap_internal( trans, isgn, A, C, scale, flash_lyap_cntl );
  
  // End the parallel region.
  FLASH_Queue_end();
 
  return r_val;
}

References FLA_Check_error_level(), FLA_Lyap_check(), FLA_Lyap_internal(), flash_lyap_cntl, FLASH_Queue_begin(), FLASH_Queue_end(), and i.