module DatabaseDesign.Ampersand.Output.ToPandoc.ChapterConceptualAnalysis
where
import DatabaseDesign.Ampersand.Output.ToPandoc.SharedAmongChapters
import DatabaseDesign.Ampersand.ADL1 (Prop(..))
import DatabaseDesign.Ampersand.Output.PredLogic (PredLogicShow(..), showLatex)
import DatabaseDesign.Ampersand.Classes
import DatabaseDesign.Ampersand.Output.PandocAux
import Data.List (intercalate)
fatal :: Int -> String -> a
fatal = fatalMsg "Output.ToPandoc.ChapterConceptualAnalysis"
chpConceptualAnalysis :: Int -> Fspc -> Options -> (Blocks,[Picture])
chpConceptualAnalysis lev fSpec flags = (chptHeader flags ConceptualAnalysis <> caIntro <> caBlocks, pictures)
where
caIntro :: Blocks
caIntro
= fromList $ (case language flags of
Dutch -> [Para
[ Str "Dit hoofdstuk beschrijft een formele taal, waarin functionele eisen ten behoeve van "
, Quoted SingleQuote [Str (name fSpec)]
, Str " kunnen worden besproken en uitgedrukt. "
, Str "De formalisering dient om een bouwbare specificatie te verkrijgen. "
, Str "Een derde met voldoende deskundigheid kan op basis van dit hoofdstuk toetsen of de gemaakte afspraken "
, Str "overeenkomen met de formele regels en definities. "
]]
English -> [Para
[ Str "This chapter defines the formal language, in which functional requirements of "
, Quoted SingleQuote [Str (name fSpec)]
, Str " can be analysed and expressed."
, Str "The purpose of this formalisation is to obtain a buildable specification. "
, Str "This chapter allows an independent professional with sufficient background to check whether the agreements made "
, Str "correspond to the formal rules and definitions. "
]])
++ purposes2Blocks flags (purposesDefinedIn fSpec (language flags) fSpec)
caBlocks = fromList $ concat(map caSection (patterns fSpec))
pictures = map pict (patterns fSpec)
pict :: Pattern -> Picture
pict pat = (makePicture flags fSpec Plain_CG pat)
{caption = case language flags of
Dutch ->"Conceptdiagram van "++name pat
English ->"Concept diagram of "++name pat}
caSection :: Pattern -> [Block]
caSection pat
=
toList ( labeledThing flags (lev+1) (xLabel ConceptualAnalysis++"_"++name pat) (name pat))
++ purposes2Blocks flags (purposesDefinedIn fSpec (language flags) pat)
++ ( case (genGraphics flags, language flags) of
(True,Dutch ) ->
[Para [Str "Figuur ", xrefReference (pict pat), Str " geeft een conceptueel diagram van dit pattern."]
,Plain (xrefFigure1 (pict pat))]
(True,English) -> [Para [Str "Figure ", xrefReference (pict pat), Str " shows a conceptual diagram of this pattern."]
,Plain (xrefFigure1 (pict pat))]
_ -> [])
++ (case language flags of
Dutch -> [Para [Str "De definities van concepten zijn te vinden in de index."]
]++
toList (labeledThing flags (lev+2) (xLabel ConceptualAnalysis++"_relationsOf_"++name pat) "Gedeclareerde relaties")
++
[Para [Str "Deze paragraaf geeft een opsomming van de gedeclareerde relaties met eigenschappen en een betekenis."]]
English -> [Para [Str "The definitions of concepts can be found in the glossary."]
]++
toList (labeledThing flags (lev+2) (xLabel ConceptualAnalysis++"_relationsOf_"++name pat) "Declared relations")
++
[Para [Str "This section itemizes the declared relations with properties and a meaning."]])
++ [DefinitionList blocks | let blocks = map caRelation (declarations pat), not(null blocks)]
++ (case language flags of
Dutch -> toList (labeledThing flags (lev+2) (xLabel ConceptualAnalysis++"_rulesOf_"++name pat) "Formele regels")
++
[Plain [Str "Deze paragraaf geeft een opsomming van de formele regels met een verwijzing naar de gemeenschappelijke taal van de belanghebbenden ten behoeve van de traceerbaarheid."]]
English -> toList (labeledThing flags (lev+2) (xLabel ConceptualAnalysis++"_rulesOf_"++name pat) "Formal rules")
++
[Plain [Str "This section itemizes the formal rules with a reference to the shared language of stakeholders for the sake of traceability."]])
++ [DefinitionList blocks | let blocks = map caRule (invariants pat `isc` udefrules pat), not(null blocks)]
caRelation :: Declaration -> ([Inline], [[Block]])
caRelation d
= let purp = purposes2Blocks flags [p | p<-purposesDefinedIn fSpec (language flags) d]
in ([]
,[
( if null purp
then [ Plain$[ Str ("De volgende "++nladjs d++" relatie is gedeclareerd ") | language flags==Dutch]
++ [ Str ("The following "++ukadjs d++" relation has been declared ") | language flags==English] ]
else purp )
++ pandocEqnArray
[ ( texOnly_Id(name d)
, ":"
, texOnly_Id(name (source d))++(if isFunction d then texOnly_fun else texOnly_rel)++texOnly_Id(name(target d))++symDefLabel d
) ]
++ [Plain$[Str "(Geen betekenis gespecificeerd)"| language flags==Dutch]
++ [Str "(No meaning has been specified)" | language flags==English]
| null (meaning2Blocks (language flags) d)]
++ meaning2Blocks (language flags) d
])
ukadjs d = intercalate ", " (map ukadj (multiplicities d))
ukadj Uni = "univalent"
ukadj Inj = "injective"
ukadj Sur = "surjective"
ukadj Tot = "total"
ukadj Sym = "symmetric"
ukadj Asy = "antisymmetric"
ukadj Trn = "transitive"
ukadj Rfx = "reflexive"
ukadj Irf = "irreflexive"
nladjs d = intercalate ", " (map nladj (multiplicities d))
nladj Uni = "univalente"
nladj Inj = "injectieve"
nladj Sur = "surjectieve"
nladj Tot = "totale"
nladj Sym = "symmetrische"
nladj Asy = "antisymmetrische"
nladj Trn = "transitieve"
nladj Rfx = "reflexieve"
nladj Irf = "irreflexieve"
caRule :: Rule -> ([Inline], [[Block]])
caRule r
= let purp = purposes2Blocks flags (purposesDefinedIn fSpec (language flags) r)
in ( []
, [
purp
++ [Plain$[if null purp then Str "De volgende afspraak is gesteld in paragraaf "
else Str "Daarom is als afspraak gesteld in paragraaf " | language flags==Dutch]
++ [if null purp then Str "The following requirement has been defined in section "
else Str "Therefore the following requirement has been defined in section " | language flags==English]
++ [RawInline (DatabaseDesign.Ampersand.Output.ToPandoc.SharedAmongChapters.Format "latex") "~"
,RawInline (DatabaseDesign.Ampersand.Output.ToPandoc.SharedAmongChapters.Format "latex") $ symReqRef r
,Str " p."
,RawInline (DatabaseDesign.Ampersand.Output.ToPandoc.SharedAmongChapters.Format "latex") "~"
,RawInline (DatabaseDesign.Ampersand.Output.ToPandoc.SharedAmongChapters.Format "latex") $ symReqPageRef r
,Str ": "]]
++ meaning2Blocks (language flags) r
++ [Plain$[Str "Dit is geformaliseerd - gebruikmakend van relaties " | language flags==Dutch]
++ [Str "This is formalized - using relations " | language flags==English]
++ intercalate [Str ", "] [[RawInline (DatabaseDesign.Ampersand.Output.ToPandoc.SharedAmongChapters.Format "latex") $ symDefRef d] | d@Sgn{}<-declsUsedIn r]
++ [Str " - als " | language flags==Dutch]
++ [Str " - as " | language flags==English]]
++ (if showPredExpr flags
then pandocEqnArrayOnelabel (symDefLabel r) ((showLatex.toPredLogic) r)
else pandocEquation (showMath r++symDefLabel r)
)
])