Loop removing transformation

The loop removing consists in transforming a loop into its body.

$\vartriangleright$ Example 61: 

  DO I=1,N 
    A=cos(B) 
    C=A*2 
  ENDDO

$\longrightarrow$

  A=cos(B) 
  C=A*2

The following functions are availables.

  $\blacktriangleright$ Fits:LoopRemoving:Check(LOOP,DIAGMES)

 
This functions check if the loop removing transformation can be applied to LOOP.

• LOOP (input AST) must be a do-loop statement
• The function returns an error code
  • 1 if all is correct
  • 0 if LOOP is not a do-loop statement
  • -1 if LOOP contains statements that are not handled by the transformation.
  • -2 if the body of LOOP contains statements that use the loop index.

  $\blacktriangleright$ Fits:LoopRemoving:Advice(LOOP,DIAGMES)

 
This function emits a diagnostic about the interest of the loop removing transformation

• LOOP (input AST) must be a do-loop statement
• DIAGMESG (output STRING) is a diagnostic string for the user
• The function returns a diagnostic code (return INT) :
  • 1 if the transformation is recommended
  • 0 if the transformation may be interesting
  • -1 if the transformation in not recommended

  $\blacktriangleright$ Fits:LoopRemoving:Safe(LOOP,DIAGMES)

 
This function emits a diagnostic about the code produced by the transformation

• LOOPS (input AST) must be a do-loop statement
• DIAGMESG (output STRING) is a diagnostic string for the user
• The function returns a diagnostic code (return INT) :
  • 1 if the transformation is safe
  • 0 if the transformation may be safe. More information is given by the text in DIAGMESG.
  • -1 if the transformation is not safe

  $\blacktriangleright$ Fits:LoopRemoving:Apply(LOOP,VERBOSE)

 
This function applies the loop removing transformation to LOOP

• AST (input AST) must be a do-loop statement.
• VERBOSE (input INT) is the comment level.
• The function returns the first statement created by the transformation (return AST).