<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <!-- Generated by HsColour, http://www.cs.york.ac.uk/fp/darcs/hscolour/ --> <title>src/ForSyDe/Backend/GraphML/Traverse/GraphMLM.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>{-# LANGUAGE FlexibleContexts #-}</span> <a name="line-2"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span> <a name="line-3"></a><span class='hs-comment'>-- |</span> <a name="line-4"></a><span class='hs-comment'>-- Module : ForSyDe.Backend.GraphML.Traverse.GraphMLM</span> <a name="line-5"></a><span class='hs-comment'>-- Copyright : (c) SAM Group, KTH/ICT/ECS 2007-2008</span> <a name="line-6"></a><span class='hs-comment'>-- License : BSD-style (see the file LICENSE)</span> <a name="line-7"></a><span class='hs-comment'>-- </span> <a name="line-8"></a><span class='hs-comment'>-- Maintainer : forsyde-dev@ict.kth.se</span> <a name="line-9"></a><span class='hs-comment'>-- Stability : experimental</span> <a name="line-10"></a><span class='hs-comment'>-- Portability : portable</span> <a name="line-11"></a><span class='hs-comment'>--</span> <a name="line-12"></a><span class='hs-comment'>-- 'GraphMLM' (GraphML Monad), related types and functions</span> <a name="line-13"></a><span class='hs-comment'>--</span> <a name="line-14"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span> <a name="line-15"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>ForSyDe</span><span class='hs-varop'>.</span><span class='hs-conid'>Backend</span><span class='hs-varop'>.</span><span class='hs-conid'>GraphML</span><span class='hs-varop'>.</span><span class='hs-conid'>Traverse</span><span class='hs-varop'>.</span><span class='hs-conid'>GraphMLM</span> <span class='hs-keyword'>where</span> <a name="line-16"></a> <a name="line-17"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>ForSyDe</span><span class='hs-varop'>.</span><span class='hs-conid'>Backend</span><span class='hs-varop'>.</span><span class='hs-conid'>GraphML</span><span class='hs-varop'>.</span><span class='hs-conid'>AST</span> <a name="line-18"></a> <a name="line-19"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>ForSyDe</span><span class='hs-varop'>.</span><span class='hs-conid'>Ids</span> <a name="line-20"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>ForSyDe</span><span class='hs-varop'>.</span><span class='hs-conid'>ForSyDeErr</span> <a name="line-21"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>ForSyDe</span><span class='hs-varop'>.</span><span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>SysDef</span> <span class='hs-layout'>(</span><span class='hs-conid'>SysDefVal</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-22"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>ForSyDe</span><span class='hs-varop'>.</span><span class='hs-conid'>Netlist</span><span class='hs-varop'>.</span><span class='hs-conid'>Traverse</span> <span class='hs-layout'>(</span><span class='hs-conid'>TravSEIO</span><span class='hs-layout'>)</span> <a name="line-23"></a> <a name="line-24"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span><span class='hs-varop'>.</span><span class='hs-conid'>State</span> <a name="line-25"></a> <a name="line-26"></a> <a name="line-27"></a><span class='hs-comment'>--------------</span> <a name="line-28"></a><span class='hs-comment'>-- GraphMLM --</span> <a name="line-29"></a><span class='hs-comment'>--------------</span> <a name="line-30"></a> <a name="line-31"></a><a name="GraphMLM"></a><span class='hs-comment'>-- | GraphMLM backend monad</span> <a name="line-32"></a><a name="GraphMLM"></a><span class='hs-keyword'>type</span> <span class='hs-conid'>GraphMLM</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>TravSEIO</span> <span class='hs-conid'>GraphMLTravST</span> <span class='hs-conid'>ContextErr</span> <span class='hs-varid'>a</span> <a name="line-33"></a> <a name="line-34"></a> <a name="line-35"></a><span class='hs-comment'>-------------------</span> <a name="line-36"></a><span class='hs-comment'>-- GraphMLTravST --</span> <a name="line-37"></a><span class='hs-comment'>-------------------</span> <a name="line-38"></a> <a name="line-39"></a><a name="GraphMLTravST"></a><span class='hs-comment'>-- | GraphML traversing State. (see 'ForSyDe.Netlist.Traverse.traverseSIO')</span> <a name="line-40"></a><a name="GraphMLTravST"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>GraphMLTravST</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>GraphMLTravST</span> <a name="line-41"></a> <span class='hs-layout'>{</span><span class='hs-varid'>local</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>LocalGraphMLST</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- Local State (related to the system currently </span> <a name="line-42"></a> <span class='hs-comment'>-- compiled)</span> <a name="line-43"></a> <span class='hs-varid'>global</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GlobalGraphMLST</span><span class='hs-layout'>}</span> <span class='hs-comment'>-- Global state (related to all systems being </span> <a name="line-44"></a> <span class='hs-comment'>-- recursively compiled) </span> <a name="line-45"></a> <a name="line-46"></a><a name="LocalGraphMLST"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>LocalGraphMLST</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>LocalGraphMLST</span> <a name="line-47"></a> <span class='hs-layout'>{</span><span class='hs-varid'>currSysDef</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>SysDefVal</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- System definition which is currently </span> <a name="line-48"></a> <span class='hs-comment'>-- being compiled</span> <a name="line-49"></a> <span class='hs-varid'>context</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Context</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- Error Context</span> <a name="line-50"></a> <span class='hs-varid'>localRes</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>LocalTravResult</span><span class='hs-layout'>}</span> <span class='hs-comment'>-- Result accumulated during the </span> <a name="line-51"></a> <span class='hs-comment'>-- traversal of current System Definition </span> <a name="line-52"></a> <span class='hs-comment'>-- netlist</span> <a name="line-53"></a> <a name="line-54"></a> <a name="line-55"></a> <a name="line-56"></a> <a name="line-57"></a><a name="initLocalST"></a><span class='hs-comment'>-- | initialize the local state</span> <a name="line-58"></a><span class='hs-definition'>initLocalST</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>SysDefVal</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>LocalGraphMLST</span> <a name="line-59"></a><span class='hs-definition'>initLocalST</span> <span class='hs-varid'>sysDefVal</span> <span class='hs-keyglyph'>=</span> <a name="line-60"></a> <span class='hs-conid'>LocalGraphMLST</span> <span class='hs-varid'>sysDefVal</span> <span class='hs-layout'>(</span><span class='hs-conid'>SysDefC</span> <span class='hs-layout'>(</span><span class='hs-varid'>sid</span> <span class='hs-varid'>sysDefVal</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>loc</span> <span class='hs-varid'>sysDefVal</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-61"></a> <span class='hs-varid'>emptyLocalTravResult</span> <a name="line-62"></a> <a name="line-63"></a><a name="withLocalST"></a><span class='hs-comment'>-- | Execute certain operation with a concrete local state.</span> <a name="line-64"></a><span class='hs-comment'>-- The initial local state is restored after the operation is executed</span> <a name="line-65"></a><span class='hs-definition'>withLocalST</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>LocalGraphMLST</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GraphMLM</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GraphMLM</span> <span class='hs-varid'>a</span> <a name="line-66"></a><span class='hs-definition'>withLocalST</span> <span class='hs-varid'>l'</span> <span class='hs-varid'>action</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-67"></a> <span class='hs-comment'>-- get the initial local state</span> <a name="line-68"></a> <span class='hs-varid'>st</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>get</span> <a name="line-69"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>local</span> <span class='hs-varid'>st</span> <a name="line-70"></a> <span class='hs-comment'>-- set the modified state</span> <a name="line-71"></a> <span class='hs-varid'>put</span> <span class='hs-varid'>st</span><span class='hs-layout'>{</span><span class='hs-varid'>local</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>l'</span><span class='hs-layout'>}</span> <a name="line-72"></a> <span class='hs-comment'>-- execute the action</span> <a name="line-73"></a> <span class='hs-varid'>res</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>action</span> <a name="line-74"></a> <span class='hs-comment'>-- restore the initial local state</span> <a name="line-75"></a> <span class='hs-varid'>st'</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>get</span> <a name="line-76"></a> <span class='hs-varid'>put</span> <span class='hs-varid'>st'</span><span class='hs-layout'>{</span><span class='hs-varid'>local</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>l</span><span class='hs-layout'>}</span> <a name="line-77"></a> <span class='hs-comment'>-- return the result</span> <a name="line-78"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>res</span> <a name="line-79"></a> <a name="line-80"></a><a name="GlobalGraphMLST"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>GlobalGraphMLST</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>GlobalGraphMLST</span> <a name="line-81"></a> <span class='hs-layout'>{</span><span class='hs-varid'>globalSysDef</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>SysDefVal</span><span class='hs-layout'>,</span> <a name="line-82"></a> <span class='hs-varid'>ops</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GraphMLOps</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- Compilation options</span> <a name="line-83"></a> <span class='hs-varid'>globalRes</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GlobalTravResult</span><span class='hs-layout'>}</span> <span class='hs-comment'>-- Result accumulated during the </span> <a name="line-84"></a> <span class='hs-comment'>-- whole compilation</span> <a name="line-85"></a> <a name="line-86"></a> <a name="line-87"></a> <a name="line-88"></a> <a name="line-89"></a><a name="initGlobalGraphMLST"></a><span class='hs-comment'>-- | Empty initial traversing state</span> <a name="line-90"></a><span class='hs-definition'>initGlobalGraphMLST</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>SysDefVal</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GlobalGraphMLST</span> <a name="line-91"></a><span class='hs-definition'>initGlobalGraphMLST</span> <span class='hs-varid'>sysDefVal</span> <span class='hs-keyglyph'>=</span> <a name="line-92"></a> <span class='hs-conid'>GlobalGraphMLST</span> <span class='hs-varid'>sysDefVal</span> <span class='hs-varid'>defaultGraphMLOps</span> <span class='hs-varid'>emptyGlobalTravResult</span> <a name="line-93"></a> <a name="line-94"></a><a name="initGraphMLTravST"></a><span class='hs-comment'>-- | Empty initial traversing state </span> <a name="line-95"></a><span class='hs-definition'>initGraphMLTravST</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>SysDefVal</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GraphMLTravST</span> <a name="line-96"></a><span class='hs-definition'>initGraphMLTravST</span> <span class='hs-varid'>sysDefVal</span> <span class='hs-keyglyph'>=</span> <a name="line-97"></a> <span class='hs-conid'>GraphMLTravST</span> <span class='hs-layout'>(</span><span class='hs-varid'>initLocalST</span> <span class='hs-varid'>sysDefVal</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>initGlobalGraphMLST</span> <span class='hs-varid'>sysDefVal</span><span class='hs-layout'>)</span> <a name="line-98"></a> <a name="line-99"></a><span class='hs-comment'>-------------</span> <a name="line-100"></a><span class='hs-comment'>-- TravResult</span> <a name="line-101"></a><span class='hs-comment'>-------------</span> <a name="line-102"></a> <a name="line-103"></a><a name="LocalTravResult"></a><span class='hs-comment'>-- | Local result accumulated during the traversal of a netlist</span> <a name="line-104"></a><a name="LocalTravResult"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>LocalTravResult</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>LocalTravResult</span> <a name="line-105"></a> <span class='hs-layout'>{</span><span class='hs-varid'>nodes</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>GraphMLNode</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- generated nodes</span> <a name="line-106"></a> <span class='hs-varid'>edges</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>GraphMLEdge</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>}</span> <span class='hs-comment'>-- generated edges</span> <a name="line-107"></a> <a name="line-108"></a> <a name="line-109"></a> <a name="line-110"></a><a name="emptyLocalTravResult"></a><span class='hs-comment'>-- | empty local GraphML compilation result</span> <a name="line-111"></a><span class='hs-definition'>emptyLocalTravResult</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>LocalTravResult</span> <a name="line-112"></a><span class='hs-definition'>emptyLocalTravResult</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>LocalTravResult</span> <span class='hs-conid'>[]</span> <span class='hs-conid'>[]</span> <a name="line-113"></a> <a name="line-114"></a> <a name="line-115"></a><a name="GlobalTravResult"></a><span class='hs-comment'>-- | Global Results accumulated throughout the whole compilation</span> <a name="line-116"></a><a name="GlobalTravResult"></a><span class='hs-comment'>-- (empty right now)</span> <a name="line-117"></a><a name="GlobalTravResult"></a><span class='hs-keyword'>type</span> <span class='hs-conid'>GlobalTravResult</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>()</span> <a name="line-118"></a> <a name="line-119"></a> <a name="line-120"></a><a name="emptyGlobalTravResult"></a><span class='hs-comment'>-- | empty global GraphML compilation result</span> <a name="line-121"></a><span class='hs-definition'>emptyGlobalTravResult</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GlobalTravResult</span> <a name="line-122"></a><span class='hs-definition'>emptyGlobalTravResult</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>()</span> <a name="line-123"></a> <a name="line-124"></a> <a name="line-125"></a><span class='hs-comment'>-------------</span> <a name="line-126"></a><span class='hs-comment'>-- GraphMLOps</span> <a name="line-127"></a><span class='hs-comment'>-------------</span> <a name="line-128"></a> <a name="line-129"></a><a name="GraphMLOps"></a><span class='hs-comment'>-- | GraphML Compilation options</span> <a name="line-130"></a><a name="GraphMLOps"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>GraphMLOps</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>GraphMLOps</span> <a name="line-131"></a> <span class='hs-layout'>{</span><span class='hs-varid'>debugGraphML</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GraphMLDebugLevel</span><span class='hs-layout'>,</span> <a name="line-132"></a> <span class='hs-varid'>recursivityGraphML</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GraphMLRecursivity</span><span class='hs-layout'>,</span> <a name="line-133"></a> <span class='hs-varid'>yFilesMarkup</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Bool</span> <span class='hs-comment'>-- ^ Generate yFiles markup? </span> <a name="line-134"></a> <span class='hs-layout'>}</span> <a name="line-135"></a> <span class='hs-keyword'>deriving</span> <span class='hs-layout'>(</span><span class='hs-conid'>Eq</span><span class='hs-layout'>,</span> <span class='hs-conid'>Show</span><span class='hs-layout'>)</span> <a name="line-136"></a> <a name="line-137"></a><a name="GraphMLDebugLevel"></a><span class='hs-comment'>-- | Debug level</span> <a name="line-138"></a><a name="GraphMLDebugLevel"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>GraphMLDebugLevel</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>GraphMLNormal</span> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>GraphMLVerbose</span> <a name="line-139"></a> <span class='hs-keyword'>deriving</span> <span class='hs-layout'>(</span><span class='hs-conid'>Eq</span><span class='hs-layout'>,</span> <span class='hs-conid'>Ord</span><span class='hs-layout'>,</span> <span class='hs-conid'>Show</span><span class='hs-layout'>)</span> <a name="line-140"></a> <a name="line-141"></a><a name="debugMsg"></a><span class='hs-comment'>-- | Print a message to stdout if in verbose mode</span> <a name="line-142"></a><span class='hs-definition'>debugMsg</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GraphMLM</span> <span class='hs-conid'>()</span> <a name="line-143"></a><span class='hs-definition'>debugMsg</span> <span class='hs-varid'>str</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-144"></a> <span class='hs-varid'>debugLevel</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>gets</span> <span class='hs-layout'>(</span><span class='hs-varid'>debugGraphML</span><span class='hs-varop'>.</span><span class='hs-varid'>ops</span><span class='hs-varop'>.</span><span class='hs-varid'>global</span><span class='hs-layout'>)</span> <a name="line-145"></a> <span class='hs-varid'>when</span> <span class='hs-layout'>(</span><span class='hs-varid'>debugLevel</span> <span class='hs-varop'>></span> <span class='hs-conid'>GraphMLNormal</span><span class='hs-layout'>)</span> <a name="line-146"></a> <span class='hs-layout'>(</span><span class='hs-varid'>liftIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>putStr</span> <span class='hs-layout'>(</span><span class='hs-str'>"DEBUG: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>str</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-147"></a> <a name="line-148"></a><a name="GraphMLRecursivity"></a><span class='hs-comment'>-- | Recursivity, should the parent systems of system instances be compiled as </span> <a name="line-149"></a><a name="GraphMLRecursivity"></a><span class='hs-comment'>-- well?</span> <a name="line-150"></a><a name="GraphMLRecursivity"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>GraphMLRecursivity</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>GraphMLRecursive</span> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>GraphMLNonRecursive</span> <a name="line-151"></a> <span class='hs-keyword'>deriving</span> <span class='hs-layout'>(</span><span class='hs-conid'>Eq</span><span class='hs-layout'>,</span> <span class='hs-conid'>Show</span><span class='hs-layout'>)</span> <a name="line-152"></a> <a name="line-153"></a><a name="isRecursiveSet"></a><span class='hs-comment'>-- | Check if we are in recursive mode</span> <a name="line-154"></a><span class='hs-definition'>isRecursiveSet</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GraphMLM</span> <span class='hs-conid'>Bool</span> <a name="line-155"></a><span class='hs-definition'>isRecursiveSet</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-156"></a> <span class='hs-varid'>recOp</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>gets</span> <span class='hs-layout'>(</span><span class='hs-varid'>recursivityGraphML</span><span class='hs-varop'>.</span><span class='hs-varid'>ops</span><span class='hs-varop'>.</span><span class='hs-varid'>global</span><span class='hs-layout'>)</span> <a name="line-157"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-varid'>recOp</span> <span class='hs-varop'>==</span> <span class='hs-conid'>GraphMLRecursive</span> <a name="line-158"></a> <a name="line-159"></a><a name="genyFilesMarkup"></a><span class='hs-comment'>-- | Check if we want to generate yFiles markup</span> <a name="line-160"></a><span class='hs-definition'>genyFilesMarkup</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GraphMLM</span> <span class='hs-conid'>Bool</span> <a name="line-161"></a><span class='hs-definition'>genyFilesMarkup</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>gets</span> <span class='hs-layout'>(</span><span class='hs-varid'>yFilesMarkup</span><span class='hs-varop'>.</span><span class='hs-varid'>ops</span><span class='hs-varop'>.</span><span class='hs-varid'>global</span><span class='hs-layout'>)</span> <a name="line-162"></a> <a name="line-163"></a> <a name="line-164"></a><a name="defaultGraphMLOps"></a><span class='hs-comment'>-- | Default traversing options</span> <a name="line-165"></a><span class='hs-definition'>defaultGraphMLOps</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GraphMLOps</span> <a name="line-166"></a><span class='hs-definition'>defaultGraphMLOps</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>GraphMLOps</span> <span class='hs-conid'>GraphMLNormal</span> <span class='hs-conid'>GraphMLRecursive</span> <span class='hs-conid'>False</span> <a name="line-167"></a> <a name="line-168"></a> <a name="line-169"></a><a name="setGraphMLOps"></a><span class='hs-comment'>-- | Set GraphML options inside the GraphML monad</span> <a name="line-170"></a><span class='hs-definition'>setGraphMLOps</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GraphMLOps</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GraphMLM</span> <span class='hs-conid'>()</span> <a name="line-171"></a><span class='hs-definition'>setGraphMLOps</span> <span class='hs-varid'>options</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>modify</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>st</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>st</span><span class='hs-layout'>{</span><span class='hs-varid'>global</span><span class='hs-keyglyph'>=</span><span class='hs-layout'>(</span><span class='hs-varid'>global</span> <span class='hs-varid'>st</span><span class='hs-layout'>)</span><span class='hs-layout'>{</span><span class='hs-varid'>ops</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>options</span><span class='hs-layout'>}</span><span class='hs-layout'>}</span><span class='hs-layout'>)</span> <a name="line-172"></a> <a name="line-173"></a> <a name="line-174"></a><span class='hs-comment'>----------------------------------------</span> <a name="line-175"></a><span class='hs-comment'>-- Useful functions in the GraphML Monad</span> <a name="line-176"></a><span class='hs-comment'>----------------------------------------</span> <a name="line-177"></a> <a name="line-178"></a><a name="addEdge"></a><span class='hs-comment'>-- | Add a signal declaration to the 'LocalTravResult' in the State</span> <a name="line-179"></a><span class='hs-definition'>addEdge</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GraphMLEdge</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GraphMLM</span> <span class='hs-conid'>()</span> <a name="line-180"></a><span class='hs-definition'>addEdge</span> <span class='hs-varid'>e</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>modify</span> <span class='hs-varid'>addFun</span> <a name="line-181"></a> <span class='hs-comment'>-- FIXME: use a queue for the declarations</span> <a name="line-182"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>addFun</span> <span class='hs-varid'>st</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>st</span><span class='hs-layout'>{</span><span class='hs-varid'>local</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>l</span><span class='hs-layout'>{</span><span class='hs-varid'>localRes</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>r</span><span class='hs-layout'>{</span><span class='hs-varid'>edges</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>edg</span> <span class='hs-varop'>++</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>e</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>}</span><span class='hs-layout'>}</span><span class='hs-layout'>}</span> <a name="line-183"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>local</span> <span class='hs-varid'>st</span> <a name="line-184"></a> <span class='hs-varid'>r</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>localRes</span> <span class='hs-varid'>l</span> <a name="line-185"></a> <span class='hs-varid'>edg</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>edges</span> <span class='hs-varid'>r</span> <a name="line-186"></a> <a name="line-187"></a> <a name="line-188"></a><a name="addNode"></a><span class='hs-comment'>-- | Add a statement to the 'LocalTravResult' in the State</span> <a name="line-189"></a><span class='hs-definition'>addNode</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>GraphMLNode</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GraphMLM</span> <span class='hs-conid'>()</span> <a name="line-190"></a><span class='hs-definition'>addNode</span> <span class='hs-varid'>node</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>modify</span> <span class='hs-varid'>addFun</span> <a name="line-191"></a> <span class='hs-comment'>-- FIXME: use a queue for the statements</span> <a name="line-192"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>addFun</span> <span class='hs-varid'>st</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>st</span><span class='hs-layout'>{</span><span class='hs-varid'>local</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>l</span><span class='hs-layout'>{</span><span class='hs-varid'>localRes</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>r</span><span class='hs-layout'>{</span><span class='hs-varid'>nodes</span><span class='hs-keyglyph'>=</span> <span class='hs-varid'>nds</span> <span class='hs-varop'>++</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>node</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>}</span><span class='hs-layout'>}</span><span class='hs-layout'>}</span> <a name="line-193"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>local</span> <span class='hs-varid'>st</span> <a name="line-194"></a> <span class='hs-varid'>r</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>localRes</span> <span class='hs-varid'>l</span> <a name="line-195"></a> <span class='hs-varid'>nds</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>nodes</span> <span class='hs-varid'>r</span> <a name="line-196"></a> <a name="line-197"></a> <a name="line-198"></a> <a name="line-199"></a><a name="liftEProne"></a><span class='hs-comment'>-- | Lift an 'EProne' value to the GraphML monad setting current error context</span> <a name="line-200"></a><span class='hs-comment'>-- for the error</span> <a name="line-201"></a><span class='hs-definition'>liftEProne</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>EProne</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GraphMLM</span> <span class='hs-varid'>a</span> <a name="line-202"></a><span class='hs-definition'>liftEProne</span> <span class='hs-varid'>ep</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-203"></a> <span class='hs-varid'>cxt</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>gets</span> <span class='hs-layout'>(</span><span class='hs-varid'>context</span><span class='hs-varop'>.</span><span class='hs-varid'>local</span><span class='hs-layout'>)</span> <a name="line-204"></a> <span class='hs-varid'>either</span> <span class='hs-layout'>(</span><span class='hs-varid'>throwError</span><span class='hs-varop'>.</span><span class='hs-layout'>(</span><span class='hs-conid'>ContextErr</span> <span class='hs-varid'>cxt</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>return</span> <span class='hs-varid'>ep</span> <a name="line-205"></a> <a name="line-206"></a><a name="throwFError"></a><span class='hs-comment'>-- | Throw a ForSyDe error, setting current error context</span> <a name="line-207"></a><span class='hs-definition'>throwFError</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ForSyDeErr</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GraphMLM</span> <span class='hs-varid'>a</span> <a name="line-208"></a><span class='hs-definition'>throwFError</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftEProne</span><span class='hs-varop'>.</span><span class='hs-conid'>Left</span> <a name="line-209"></a> <a name="line-210"></a> <a name="line-211"></a> <a name="line-212"></a><a name="withProcC"></a><span class='hs-comment'>-- | Execute certain operation with a concrete process context.</span> <a name="line-213"></a><span class='hs-comment'>-- The initial context is restored after the operation is executed</span> <a name="line-214"></a><span class='hs-comment'>-- Note: the initial context must be a system context or 'InconsistenContexts'</span> <a name="line-215"></a><span class='hs-comment'>-- will be raised.</span> <a name="line-216"></a><span class='hs-definition'>withProcC</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ProcId</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GraphMLM</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>GraphMLM</span> <span class='hs-varid'>a</span> <a name="line-217"></a><span class='hs-definition'>withProcC</span> <span class='hs-varid'>pid</span> <span class='hs-varid'>action</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-218"></a> <span class='hs-comment'>-- get the initial context</span> <a name="line-219"></a> <span class='hs-varid'>st</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>get</span> <a name="line-220"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>local</span> <span class='hs-varid'>st</span> <a name="line-221"></a> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>context</span> <span class='hs-varid'>l</span> <a name="line-222"></a> <span class='hs-comment'>-- set the modified name context</span> <a name="line-223"></a> <span class='hs-varid'>put</span> <span class='hs-varid'>st</span><span class='hs-layout'>{</span><span class='hs-varid'>local</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>l</span><span class='hs-layout'>{</span><span class='hs-varid'>context</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>setProcC</span> <span class='hs-varid'>pid</span> <span class='hs-varid'>c</span><span class='hs-layout'>}</span><span class='hs-layout'>}</span> <a name="line-224"></a> <span class='hs-comment'>-- execute the action</span> <a name="line-225"></a> <span class='hs-varid'>res</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>action</span> <a name="line-226"></a> <span class='hs-comment'>-- restore the initial name context</span> <a name="line-227"></a> <span class='hs-varid'>st'</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>get</span> <a name="line-228"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>l'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>local</span> <span class='hs-varid'>st'</span> <a name="line-229"></a> <span class='hs-varid'>put</span> <span class='hs-varid'>st'</span><span class='hs-layout'>{</span><span class='hs-varid'>local</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>l'</span><span class='hs-layout'>{</span><span class='hs-varid'>context</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>c</span><span class='hs-layout'>}</span><span class='hs-layout'>}</span> <a name="line-230"></a> <span class='hs-comment'>-- return the result</span> <a name="line-231"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>res</span> <a name="line-232"></a> <a name="line-233"></a> <a name="line-234"></a> <a name="line-235"></a> <a name="line-236"></a><span class='hs-comment'>----------------</span> <a name="line-237"></a><span class='hs-comment'>-- IntSignalInfo</span> <a name="line-238"></a><span class='hs-comment'>----------------</span> <a name="line-239"></a> <a name="line-240"></a><a name="IntSignalInfo"></a><span class='hs-comment'>-- | Intermediate edge information. Tag generated for each output of each</span> <a name="line-241"></a><a name="IntSignalInfo"></a><span class='hs-comment'>-- node found during the traversal. </span> <a name="line-242"></a><a name="IntSignalInfo"></a><span class='hs-comment'>-- (see ForSyDe.Netlist.Traverse.traverseSIO).</span> <a name="line-243"></a><a name="IntSignalInfo"></a><span class='hs-comment'>-- It contains the GraphML node identifier </span> <a name="line-244"></a><a name="IntSignalInfo"></a><span class='hs-comment'>-- and port identifier associated with the process output.</span> <a name="line-245"></a><a name="IntSignalInfo"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>IntSignalInfo</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>IntSignalInfo</span> <span class='hs-conid'>GraphMLNode</span> <span class='hs-comment'>-- Source Node </span> <a name="line-246"></a> <span class='hs-conid'>GraphMLPortId</span> <span class='hs-comment'>-- Source Port Identifier</span> <a name="line-247"></a> </pre></body> </html>