<note warning>This page is still under construction and its content should be ignored. Thank you! 8-)</note>

====== MANET Examples ======

==== Instrumentation ====
==== Code Transformations ====
==== Some More Complex Examples ====

==== Select ====

Select with full join point chain:

<code lara>
select program.file.function.body.loop end
</code>

Select with only last join point. The chain is induced, produces the same result as above:

<code lara>
select loop end
</code>

Assign the selected join points to a variable for later use:

<code lara>
LOOPS: select loop end
</code>

Assign an alias for specific join points:

<code lara>
select ($p=loop).($c=loop) end
</code>
==== Apply ====

Apply after a select:

<code lara>
select loop end
apply
    println($loop.rank);
end
</code>

Apply on a previously selected set of join points:

<code lara>
apply to LOOPS
    println($loop.rank);
end
</code>

It is possible to perform a natural join on two sets of join points:

<code lara>
LOOP_START: 	select function.body.loop.($loop_start = first) end
FUNCTION_FIRST: select function.body.first end

apply to LOOP_START::FUNCTION_FIRST  
    // Init counters at the beginning of the function
    $first.insert before%{counter_[[$loop.uid]] = 0;}%;

    // Increment counters when entering the loop
    $loop_start.insert before%{counter_[[$loop.uid]] = counter_[[$loop.uid]] +1;}%;

    // ...
end
</code>

Use of join points with aliases inside the apply statement:

<code lara>
select ($p=loop).($c=loop) end
apply
   $p.perform Interchange($c);
end
</code>

==== Conditions ====

Using a condition block:

<code lara>
select function end
apply
    // ...
end
condition
    $function.name == 'kernel'
end
</code>

Combining conditions using && (and) and && (or) operators:

<code lara>
select loop end
apply
    $loop.perform Unroll(2);
end
condition
    $loop.is_innermost &&
    $loop.type=="for"
end
</code>

Using "filter" conditions on the join point chain:

<code lara>
select function{name=='kernel'} end
apply
    // ...
end

// OR
select function{'kernel'} end // uses the default attribute of the join point
apply
    // ...
end
</code>

==== Aspect Inputs and Outputs ====

Input parameter definition:

<code lara>
input
    funcs,
    opt
end
</code>

Input parameter definition with default values:

<code lara>
input
    funcs = ['kernel'],
    opt = ['unroll', 'interchange', 'tile']
end
</code>

Output definition. Output cannot be initialized inside the **output** block:

<code lara>
output
    optFuncs,
    code
end

optFuncs = [];
code = '';
</code>

==== Calling Aspects ====

Simple aspect call:

<code lara>
call OptimizeProgram();
</code>

Calling an aspect with arguments:

<code lara>
call OptimizeFunctions(functions, optimizations);
</code>

Calling an aspect with named arguments:

<code lara>
call OptimizeFunctions(opt: optimizations, funcs: ['gridIterate']);
</code>


Calling an aspect and retrieving the outputs:

<code lara>
call optimizer: OptimizeFunctions(functions, optimizations);

var changedFuncs = optimizer.optFuncs;
var finalCode = optimizer.code;
</code>

Assigning an aspect call to a variable for later use. Can still use input arguments and outputs as shown before:

<code lara>
var optimizer = new OptimizeFunctions(functions, optimizations);

call optimizer();

var changedFuncs = optimizer.optFuncs;
var finalCode = optimizer.code;
</code>

==== Using LARA Actions ====

Actions are used inside apply statements. There are two default actions, **insert** and **def**. Then, it is possible to use weaver-specific actions, which are called with the **perform** keyword:

<code lara>
select function{'kernel'} end
apply
    insert before '/* Creating a clone. */';  // add a comment before the function
    def name = 'original_kernel';  // redefine the name of the kernel function
    perform Clone('cloned_kernel');  // use a MANET-specific action to create a 'kernel' clone named 'cloned_kernel'
end
</code>

When calling an action we can specify any join point in the chain to be the action target:

<code lara>
select function.loop end
apply
    $loop.perform Tile(8);
    $function.insert before '/* This function was transformed. */';
end
</code>

It is possible to omit the target, the last join point in the chain is used:

<code lara>
select function.loop end
apply
    perform Unroll(2);  // performed on the same loop as below
    $loop.perform Tile(8);  // performed on the same loop as above
end
</code>