{- |

Module : $Header$

Description : Interface to the OWL Ontology prover via Pellet.

Copyright : (c) Heng Jiang, Uni Bremen 2004-2008

License : GPLv2 or higher

Maintainer : Christian.Maeder@dfki.de

Stability : provisional

Portability : needs POSIX

Interface for the Pellet service, uses GUI.GenericATP.

See <http://www.w3.org/2004/OWL/> for details on OWL, and

<http://pellet.owldl.com/> for Pellet (version 2.0.0-rc6)

-}

module OWL.ProvePellet

( runTimedPellet

, pelletJar

, pelletEnv

, pelletProver

, pelletConsChecker

) where

import Logic.Prover

import OWL.AS

import OWL.Morphism

import OWL.Sign

import OWL.Print

import OWL.Sublogic

import GUI.GenericATP

import Interfaces.GenericATPState

import Proofs.BatchProcessing

import Common.AS_Annotation

import Common.ProofTree

import Common.Result as Result

import Common.ProverTools

import Common.Utils

import Data.Char (isDigit)

import Data.List (isPrefixOf)

import Data.Maybe

import Data.Time (timeToTimeOfDay)

import Data.Time.Clock (secondsToDiffTime)

import System.Directory

import System.Process

import System.Timeout

import Control.Monad (when)

import Control.Concurrent

data PelletProverState = PelletProverState

{ ontologySign :: Sign

, initialState :: [Named Axiom]

} deriving (Show)

-- * Prover implementation

pelletProverState :: Sign

-> [Named Axiom]

-> [FreeDefMorphism Axiom OWLMorphism]

-- ^ freeness constraints

-> PelletProverState

pelletProverState sig oSens _ = PelletProverState

{ ontologySign = sig

, initialState = filter isAxiom oSens }

pelletS :: String

pelletS = "Pellet"

pelletJar :: String

pelletJar = "lib/pellet-cli.jar"

pelletEnv :: String

pelletEnv = "PELLET_PATH"

{- |

The Prover implementation. First runs the batch prover (with graphical

feedback), then starts the GUI prover.

-}

pelletProver :: Prover Sign Axiom OWLMorphism OWLSub ProofTree

pelletProver = mkAutomaticProver pelletS sl_top pelletGUI

pelletCMDLautomaticBatch

pelletConsChecker :: ConsChecker Sign Axiom OWLSub OWLMorphism ProofTree

pelletConsChecker = (mkConsChecker pelletS sl_top consCheck)

{ ccNeedsTimer = False }

{- |

Record for prover specific functions. This is used by both GUI and command

line interface.

-}

atpFun :: String -- ^ theory name

-> ATPFunctions Sign Axiom OWLMorphism ProofTree PelletProverState

atpFun _ = ATPFunctions

{ initialProverState = pelletProverState

, atpTransSenName = id -- transSenName,

, atpInsertSentence = insertOWLAxiom

, goalOutput = \ a b _ -> showOWLProblem a b

, proverHelpText = "http://clarkparsia.com/pellet/\n"

, batchTimeEnv = "HETS_Pellet_BATCH_TIME_LIMIT"

, fileExtensions = FileExtensions { problemOutput = ".owl" -- owl-hets

, proverOutput = ".pellet"

, theoryConfiguration = ".pconf" }

, runProver = runPellet

, createProverOptions = extraOpts }

{- |

Inserts a named OWL axiom into pellet prover state.

-}

insertOWLAxiom :: PelletProverState -- ^ prover state containing

-- initial logical part

-> Named Axiom -- ^ goal to add

-> PelletProverState

insertOWLAxiom pps s = pps { initialState = initialState pps ++ [s] }

-- ** GUI

{- |

Invokes the generic prover GUI.

-}

pelletGUI :: String -- ^ theory name

-> Theory Sign Axiom ProofTree

-> [FreeDefMorphism Axiom OWLMorphism] -- ^ freeness constraints

-> IO [ProofStatus ProofTree] -- ^ proof status for each goal

pelletGUI thName th freedefs =

genericATPgui (atpFun thName) True pelletS thName th

freedefs emptyProofTree

-- ** command line function

{- |

Implementation of 'Logic.Prover.proveCMDLautomaticBatch' which provides an

automatic command line interface to the Pellet prover via MathServe.

Pellet specific functions are omitted by data type ATPFunctions.

-}

pelletCMDLautomaticBatch ::

Bool -- ^ True means include proved theorems

-> Bool -- ^ True means save problem file

-> MVar (Result.Result [ProofStatus ProofTree])

-- ^ used to store the result of the batch run

-> String -- ^ theory name

-> TacticScript -- ^ default tactic script

-> Theory Sign Axiom ProofTree -- ^ theory

-> [FreeDefMorphism Axiom OWLMorphism] -- ^ freeness constraints

-> IO (ThreadId, MVar ())

-- ^ fst: identifier of the batch thread for killing it

-- snd: MVar to wait for the end of the thread

pelletCMDLautomaticBatch inclProvedThs saveProblem_batch resultMVar

thName defTS th freedefs =

genericCMDLautomaticBatch (atpFun thName) inclProvedThs saveProblem_batch

resultMVar pelletS thName

(parseTacticScript batchTimeLimit [] defTS) th freedefs emptyProofTree

-- * Main prover functions

{- |

Runs the Pellet service.

-}

consCheck :: String

-> TacticScript

-> TheoryMorphism Sign Axiom OWLMorphism ProofTree

-> [FreeDefMorphism Axiom OWLMorphism] -- ^ freeness constraints

-> IO (CCStatus ProofTree)

consCheck thName (TacticScript tl) tm freedefs = case tTarget tm of

Theory sig nSens -> do

let proverStateI = pelletProverState sig (toNamedList nSens) freedefs

prob = showOWLProblemS proverStateI

pStatus out tUsed = CCStatus

{ ccResult = Nothing

, ccProofTree = ProofTree $ unlines out ++ "\n\n" ++ prob

, ccUsedTime = timeToTimeOfDay $ secondsToDiffTime $ toInteger tUsed }

tLim = readMaybe tl

res <- runTimedPellet "consistency" (basename thName) prob Nothing

$ fromMaybe (-1) $ readMaybe tl

return $ case res of

Nothing -> pStatus ["Timeout after " ++ tl ++ " seconds"]

(fromMaybe (0 :: Int) tLim)

Just (progTh, outp, eOut) -> if progTh then

let (_, exCode, out, tUsed) = analyseOutput outp eOut

in (pStatus out tUsed) { ccResult = exCode }

else pStatus ["Pellet not found"] (0 :: Int)

runPelletAux :: String -- ^ pellet subcommand

-> FilePath -- ^ basename of problem file without extension

-> String -- ^ problem content

-> Maybe String -- ^ entail content

-> IO (Bool, String, String) -- ^ (success, stdout, stderr)

runPelletAux opts tmpFileName prob entail = do

(progTh, pPath) <- check4jarFile pelletEnv pelletJar

if progTh then withinDirectory pPath $ do

tempDir <- getTemporaryDirectory

let tmpFile = tmpFileName ++ ".owl"

timeTmpFile <- writeTempFile prob tempDir tmpFile

let entFile = timeTmpFile ++ ".entail.owl"

doEntail = isJust entail

args = "-Xmx512m" : "-jar" : pelletJar

: (if doEntail then ["entail", "-e", entFile] else words opts)

++ ["file://" ++ timeTmpFile]

case entail of

Just c -> writeFile entFile c

Nothing -> return ()

(_, outS, errS) <- readProcessWithExitCode "java" args ""

removeFile timeTmpFile

when doEntail $ removeFile entFile

return (True, outS, errS)

else return (False, "", "")

runTimedPellet :: String -- ^ pellet subcommand

-> FilePath -- ^ basename of problem file without extension

-> String -- ^ problem content

-> Maybe String -- ^ entail content

-> Int -- ^ time limit in seconds

-> IO (Maybe (Bool, String, String)) -- ^ timeout or (success, stdout, stderr)

runTimedPellet opts tmpFileName prob entail secs =

timeout (1000000 * secs) $ runPelletAux opts tmpFileName prob entail

runPellet :: PelletProverState

-- ^ logical part containing the input Sign and axioms and possibly

-- goals that have been proved earlier as additional axioms

-> GenericConfig ProofTree -- ^ configuration to use

-> Bool -- ^ True means save TPTP file

-> String -- ^ name of the theory in the DevGraph

-> Named Axiom -- ^ goal to prove

-> IO (ATPRetval, GenericConfig ProofTree)

-- ^ (retval, configuration with proof status and complete output)

runPellet sps cfg savePellet thName nGoal = do

let simpleOptions = extraOpts cfg

tLimit = fromMaybe 800 $ timeLimit cfg

goalSuffix = '_' : senAttr nGoal

tmpFileName = basename thName ++ goalSuffix

tScript = TacticScript $ show ATPTacticScript

{ tsTimeLimit = configTimeLimit cfg

, tsExtraOpts = simpleOptions }

defaultProofStatus out =

(openProofStatus (senAttr nGoal) pelletS $ ProofTree out)

{ tacticScript = tScript }

prob = showOWLProblemS sps

entail = showOWLProblemS

sps { initialState = [ nGoal {isAxiom = True } ] }

when savePellet $ do

writeFile (tmpFileName ++ ".owl") prob

writeFile (tmpFileName ++ ".entail.owl") entail

res <- runTimedPellet "" tmpFileName prob (Just entail) tLimit

((err, retval), output, tUsed) <- return $ case res of

Nothing ->

((ATPTLimitExceeded, defaultProofStatus "Timeout"), [], tLimit)

Just (progTh, output, eOut) ->

if progTh then

let (atpr, exCode, outp, tUsed) = analyseOutput output eOut

openStat = defaultProofStatus $ unlines outp

disProvedStatus = openStat

{ goalStatus = Disproved

, usedTime =

timeToTimeOfDay $ secondsToDiffTime $ toInteger tUsed }

provedStatus = disProvedStatus

{ goalStatus = Proved True

, usedAxioms = map senAttr $ initialState sps }

proofStat = case exCode of

Just True -> provedStatus

Just False -> disProvedStatus

_ -> openStat

in ((atpr, proofStat), outp, tUsed)

else

((ATPError "Could not find pellet prover. Is $PELLET_PATH set?"

, defaultProofStatus ""), [], 0)

return (err, cfg

{ proofStatus = retval

, resultOutput = output

, timeUsed = timeToTimeOfDay $ secondsToDiffTime $ toInteger tUsed

})

analyseOutput :: String -> String -> (ATPRetval, Maybe Bool, [String], Int)

analyseOutput err outp =

let ls = lines outp ++ lines err

anaHelp (atp, exCode, to) line =

case words line of

"Consistent:" : v : _ -> case v of

"Yes" -> (ATPSuccess, Just True, to)

"No" -> (ATPSuccess, Just False, to)

_ -> (atp, exCode, to)

"All" : "axioms" : "are" : e : _ | isPrefixOf "entailed" e ->

(ATPSuccess, Just True, to)

"Non-entailments:" : _ -> (ATPSuccess, Just False, to)

"Usage:" : "java" : "Pellet" : _ -> (ATPError line, Nothing, to)

"ERROR:" : _ -> (ATPError line, Nothing, to)

tm : num : _ | isPrefixOf "Time" tm && all isDigit num ->

(atp, exCode, read num)

_ -> (atp, exCode, to)

(atpr, st, tmo) = foldl anaHelp (ATPError "", Nothing, -1) ls

in case atpr of

ATPError s | null s -> (ATPError "unexpected pellet output", st, ls, tmo)

_ -> (atpr, st, ls, tmo)

showOWLProblemS :: PelletProverState -- ^ prover state containing

-- initial logical part

-> String -- ^ formatted output of the goal

showOWLProblemS pst =

let namedSens = initialState $ genPelletProblemS pst Nothing

sign = ontologySign $ genPelletProblemS pst Nothing

in show $ printOWLBasicTheory (sign, filter isAxiom namedSens)

{- |

Pretty printing OWL goal for pellet.

-}

showOWLProblem :: PelletProverState -- ^ prover state containing

-- initial logical part

-> Named Axiom -- ^ goal to print

-> IO String -- ^ formatted output of the goal

showOWLProblem pst nGoal =

let sign = ontologySign $ genPelletProblemS pst Nothing

in return $ showOWLProblemS pst

++ "\n\nEntailments:\n\n" ++ show (printOWLBasicTheory (sign, [nGoal]))

{- |

Generate an OWL problem.

-}

genPelletProblemS :: PelletProverState

-> Maybe (Named Axiom)

-> PelletProverState

genPelletProblemS pps m_nGoal =

pps { initialState = initialState pps ++ maybeToList m_nGoal }