libflame  revision_anchor
Functions | Variables
FLASH_Eig_gest.c File Reference

(r)

Functions

FLA_Error FLASH_Eig_gest (FLA_Inv inv, FLA_Uplo uplo, FLA_Obj A, FLA_Obj B)
 

Variables

fla_eig_gest_tflash_eig_gest_cntl
 

Function Documentation

◆ FLASH_Eig_gest()

FLA_Error FLASH_Eig_gest ( FLA_Inv  inv,
FLA_Uplo  uplo,
FLA_Obj  A,
FLA_Obj  B 
)
16 {
17  FLA_Obj Y;
18  FLA_Error r_val;
19 
20  // Check parameters.
21  if ( FLA_Check_error_level() >= FLA_MIN_ERROR_CHECKING )
22  FLA_Eig_gest_check( inv, uplo, A, B );
23 
24  // The temporary matrix object Y must exist when execution occurs, NOT just
25  // when enqueuing occurs. So if the SuperMatrix stack depth is positive, then
26  // it means the user has declared a "parallel region" in his code, and thus
27  // execution won't occur until sometime after FLASH_Eig_gest() returns, at
28  // which time Y will have been deallocated. Thus, we disallow this scenario
29  // for now, until we can think of a more general solution.
30  if ( FLASH_Queue_stack_depth() > 0 )
31  {
32  FLA_Print_message( "FLASH_Eig_gest() MUST be invoked with standalone parallelism, and may not be called from within a user-level parallel region",
33  __FILE__, __LINE__ );
34  FLA_Abort();
35  }
36 
37 
38  FLASH_Obj_create_conf_to( FLA_NO_TRANSPOSE, A, &Y );
39 
40  // Begin a parallel region.
42 
43  // Enqueue tasks via a SuperMatrix-aware control tree.
44  r_val = FLA_Eig_gest_internal( inv, uplo, A, Y, B, flash_eig_gest_cntl );
45 
46  // End the parallel region.
48 
49  FLASH_Obj_free( &Y );
50 
51  return r_val;
52 }
fla_eig_gest_t * flash_eig_gest_cntl
Definition: FLASH_Eig_gest_cntl_init.c:21
void FLASH_Queue_begin(void)
Definition: FLASH_Queue.c:59
unsigned int FLASH_Queue_stack_depth(void)
Definition: FLASH_Queue.c:106
void FLASH_Queue_end(void)
Definition: FLASH_Queue.c:81
void FLASH_Obj_free(FLA_Obj *H)
Definition: FLASH_Obj.c:638
FLA_Error FLASH_Obj_create_conf_to(FLA_Trans trans, FLA_Obj H_cur, FLA_Obj *H_new)
Definition: FLASH_Obj.c:406
FLA_Error FLA_Eig_gest_internal(FLA_Inv inv, FLA_Uplo uplo, FLA_Obj A, FLA_Obj Y, FLA_Obj B, fla_eig_gest_t *cntl)
Definition: FLA_Eig_gest_internal.c:17
FLA_Error FLA_Eig_gest_check(FLA_Inv inv, FLA_Uplo uplo, FLA_Obj A, FLA_Obj B)
Definition: FLA_Eig_gest_check.c:13
void FLA_Abort(void)
Definition: FLA_Error.c:248
unsigned int FLA_Check_error_level(void)
Definition: FLA_Check.c:18
void FLA_Print_message(char *str, char *file, int line)
Definition: FLA_Error.c:234
int FLA_Error
Definition: FLA_type_defs.h:47
Definition: FLA_type_defs.h:159

References FLA_Abort(), FLA_Check_error_level(), FLA_Eig_gest_check(), FLA_Eig_gest_internal(), FLA_Print_message(), flash_eig_gest_cntl, FLASH_Obj_create_conf_to(), FLASH_Obj_free(), FLASH_Queue_begin(), FLASH_Queue_end(), and FLASH_Queue_stack_depth().

Variable Documentation

◆ flash_eig_gest_cntl

fla_eig_gest_t* flash_eig_gest_cntl
extern