futhark-0.20.3: src/Futhark/CodeGen/Backends/GenericPython.hs
{-# LANGUAGE GeneralizedNewtypeDeriving #-}
{-# LANGUAGE LambdaCase #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE TupleSections #-}
-- | A generic Python code generator which is polymorphic in the type
-- of the operations. Concretely, we use this to handle both
-- sequential and PyOpenCL Python code.
module Futhark.CodeGen.Backends.GenericPython
( compileProg,
CompilerMode,
Constructor (..),
emptyConstructor,
compileName,
compileVar,
compileDim,
compileExp,
compilePrimExp,
compileCode,
compilePrimValue,
compilePrimType,
compilePrimTypeExt,
compilePrimToNp,
compilePrimToExtNp,
fromStorage,
toStorage,
Operations (..),
defaultOperations,
unpackDim,
CompilerM (..),
OpCompiler,
WriteScalar,
ReadScalar,
Allocate,
Copy,
StaticArray,
EntryOutput,
EntryInput,
CompilerEnv (..),
CompilerState (..),
stm,
atInit,
collect',
collect,
simpleCall,
copyMemoryDefaultSpace,
)
where
import Control.Monad.Identity
import Control.Monad.RWS
import qualified Data.Map as M
import Data.Maybe
import qualified Data.Text as T
import Futhark.CodeGen.Backends.GenericPython.AST
import Futhark.CodeGen.Backends.GenericPython.Options
import qualified Futhark.CodeGen.ImpCode as Imp
import Futhark.CodeGen.RTS.Python
import Futhark.Compiler.CLI (CompilerMode (..))
import Futhark.IR.Primitive hiding (Bool)
import Futhark.IR.Prop (isBuiltInFunction, subExpVars)
import Futhark.IR.Syntax (Space (..))
import Futhark.MonadFreshNames
import Futhark.Util (zEncodeString)
import Futhark.Util.Pretty (pretty, prettyText)
-- | A substitute expression compiler, tried before the main
-- compilation function.
type OpCompiler op s = op -> CompilerM op s ()
-- | Write a scalar to the given memory block with the given index and
-- in the given memory space.
type WriteScalar op s =
PyExp ->
PyExp ->
PrimType ->
Imp.SpaceId ->
PyExp ->
CompilerM op s ()
-- | Read a scalar from the given memory block with the given index and
-- in the given memory space.
type ReadScalar op s =
PyExp ->
PyExp ->
PrimType ->
Imp.SpaceId ->
CompilerM op s PyExp
-- | Allocate a memory block of the given size in the given memory
-- space, saving a reference in the given variable name.
type Allocate op s =
PyExp ->
PyExp ->
Imp.SpaceId ->
CompilerM op s ()
-- | Copy from one memory block to another.
type Copy op s =
PyExp ->
PyExp ->
Imp.Space ->
PyExp ->
PyExp ->
Imp.Space ->
PyExp ->
PrimType ->
CompilerM op s ()
-- | Create a static array of values - initialised at load time.
type StaticArray op s = VName -> Imp.SpaceId -> PrimType -> Imp.ArrayContents -> CompilerM op s ()
-- | Construct the Python array being returned from an entry point.
type EntryOutput op s =
VName ->
Imp.SpaceId ->
PrimType ->
Imp.Signedness ->
[Imp.DimSize] ->
CompilerM op s PyExp
-- | Unpack the array being passed to an entry point.
type EntryInput op s =
PyExp ->
Imp.SpaceId ->
PrimType ->
Imp.Signedness ->
[Imp.DimSize] ->
PyExp ->
CompilerM op s ()
data Operations op s = Operations
{ opsWriteScalar :: WriteScalar op s,
opsReadScalar :: ReadScalar op s,
opsAllocate :: Allocate op s,
opsCopy :: Copy op s,
opsStaticArray :: StaticArray op s,
opsCompiler :: OpCompiler op s,
opsEntryOutput :: EntryOutput op s,
opsEntryInput :: EntryInput op s
}
-- | A set of operations that fail for every operation involving
-- non-default memory spaces. Uses plain pointers and @malloc@ for
-- memory management.
defaultOperations :: Operations op s
defaultOperations =
Operations
{ opsWriteScalar = defWriteScalar,
opsReadScalar = defReadScalar,
opsAllocate = defAllocate,
opsCopy = defCopy,
opsStaticArray = defStaticArray,
opsCompiler = defCompiler,
opsEntryOutput = defEntryOutput,
opsEntryInput = defEntryInput
}
where
defWriteScalar _ _ _ _ _ =
error "Cannot write to non-default memory space because I am dumb"
defReadScalar _ _ _ _ =
error "Cannot read from non-default memory space"
defAllocate _ _ _ =
error "Cannot allocate in non-default memory space"
defCopy _ _ _ _ _ _ _ _ =
error "Cannot copy to or from non-default memory space"
defStaticArray _ _ _ _ =
error "Cannot create static array in non-default memory space"
defCompiler _ =
error "The default compiler cannot compile extended operations"
defEntryOutput _ _ _ _ =
error "Cannot return array not in default memory space"
defEntryInput _ _ _ _ =
error "Cannot accept array not in default memory space"
data CompilerEnv op s = CompilerEnv
{ envOperations :: Operations op s,
envVarExp :: M.Map VName PyExp
}
envOpCompiler :: CompilerEnv op s -> OpCompiler op s
envOpCompiler = opsCompiler . envOperations
envReadScalar :: CompilerEnv op s -> ReadScalar op s
envReadScalar = opsReadScalar . envOperations
envWriteScalar :: CompilerEnv op s -> WriteScalar op s
envWriteScalar = opsWriteScalar . envOperations
envAllocate :: CompilerEnv op s -> Allocate op s
envAllocate = opsAllocate . envOperations
envCopy :: CompilerEnv op s -> Copy op s
envCopy = opsCopy . envOperations
envStaticArray :: CompilerEnv op s -> StaticArray op s
envStaticArray = opsStaticArray . envOperations
envEntryOutput :: CompilerEnv op s -> EntryOutput op s
envEntryOutput = opsEntryOutput . envOperations
envEntryInput :: CompilerEnv op s -> EntryInput op s
envEntryInput = opsEntryInput . envOperations
newCompilerEnv :: Operations op s -> CompilerEnv op s
newCompilerEnv ops =
CompilerEnv
{ envOperations = ops,
envVarExp = mempty
}
data CompilerState s = CompilerState
{ compNameSrc :: VNameSource,
compInit :: [PyStmt],
compUserState :: s
}
newCompilerState :: VNameSource -> s -> CompilerState s
newCompilerState src s =
CompilerState
{ compNameSrc = src,
compInit = [],
compUserState = s
}
newtype CompilerM op s a = CompilerM (RWS (CompilerEnv op s) [PyStmt] (CompilerState s) a)
deriving
( Functor,
Applicative,
Monad,
MonadState (CompilerState s),
MonadReader (CompilerEnv op s),
MonadWriter [PyStmt]
)
instance MonadFreshNames (CompilerM op s) where
getNameSource = gets compNameSrc
putNameSource src = modify $ \s -> s {compNameSrc = src}
collect :: CompilerM op s () -> CompilerM op s [PyStmt]
collect m = pass $ do
((), w) <- listen m
return (w, const mempty)
collect' :: CompilerM op s a -> CompilerM op s (a, [PyStmt])
collect' m = pass $ do
(x, w) <- listen m
return ((x, w), const mempty)
atInit :: PyStmt -> CompilerM op s ()
atInit x = modify $ \s ->
s {compInit = compInit s ++ [x]}
stm :: PyStmt -> CompilerM op s ()
stm x = tell [x]
futharkFun :: String -> String
futharkFun s = "futhark_" ++ zEncodeString s
compileOutput :: [Imp.Param] -> [PyExp]
compileOutput = map (Var . compileName . Imp.paramName)
runCompilerM ::
Operations op s ->
VNameSource ->
s ->
CompilerM op s a ->
a
runCompilerM ops src userstate (CompilerM m) =
fst $ evalRWS m (newCompilerEnv ops) (newCompilerState src userstate)
standardOptions :: [Option]
standardOptions =
[ Option
{ optionLongName = "tuning",
optionShortName = Nothing,
optionArgument = RequiredArgument "open",
optionAction = [Exp $ simpleCall "read_tuning_file" [Var "sizes", Var "optarg"]]
},
Option
{ optionLongName = "log",
optionShortName = Just 'L',
optionArgument = NoArgument,
optionAction = [Pass]
}
]
executableOptions :: [Option]
executableOptions =
standardOptions
++ [ Option
{ optionLongName = "write-runtime-to",
optionShortName = Just 't',
optionArgument = RequiredArgument "str",
optionAction =
[ If
(Var "runtime_file")
[Exp $ simpleCall "runtime_file.close" []]
[],
Assign (Var "runtime_file") $
simpleCall "open" [Var "optarg", String "w"]
]
},
Option
{ optionLongName = "runs",
optionShortName = Just 'r',
optionArgument = RequiredArgument "str",
optionAction =
[ Assign (Var "num_runs") $ Var "optarg",
Assign (Var "do_warmup_run") $ Bool True
]
},
Option
{ optionLongName = "entry-point",
optionShortName = Just 'e',
optionArgument = RequiredArgument "str",
optionAction =
[Assign (Var "entry_point") $ Var "optarg"]
},
Option
{ optionLongName = "binary-output",
optionShortName = Just 'b',
optionArgument = NoArgument,
optionAction = [Assign (Var "binary_output") $ Bool True]
}
]
functionExternalValues :: Imp.Function a -> [Imp.ExternalValue]
functionExternalValues fun = Imp.functionResult fun ++ map snd (Imp.functionArgs fun)
opaqueDefs :: Imp.Functions a -> M.Map String [PyExp]
opaqueDefs (Imp.Functions funs) =
mconcat . map evd . concatMap (functionExternalValues . snd) $
filter (isJust . Imp.functionEntry . snd) funs
where
evd Imp.TransparentValue {} = mempty
evd (Imp.OpaqueValue _ name vds) =
M.singleton name $ map (String . vd) vds
vd (Imp.ScalarValue pt s _) =
readTypeEnum pt s
vd (Imp.ArrayValue _ _ pt s dims) =
concat (replicate (length dims) "[]") ++ readTypeEnum pt s
-- | The class generated by the code generator must have a
-- constructor, although it can be vacuous.
data Constructor = Constructor [String] [PyStmt]
-- | A constructor that takes no arguments and does nothing.
emptyConstructor :: Constructor
emptyConstructor = Constructor ["self"] [Pass]
constructorToFunDef :: Constructor -> [PyStmt] -> PyFunDef
constructorToFunDef (Constructor params body) at_init =
Def "__init__" params $ body <> at_init
compileProg ::
MonadFreshNames m =>
CompilerMode ->
String ->
Constructor ->
[PyStmt] ->
[PyStmt] ->
Operations op s ->
s ->
[PyStmt] ->
[Option] ->
Imp.Definitions op ->
m T.Text
compileProg mode class_name constructor imports defines ops userstate sync options prog = do
src <- getNameSource
let prog' = runCompilerM ops src userstate compileProg'
pure . prettyText . PyProg $
imports
++ [ Import "argparse" Nothing,
Assign (Var "sizes") $ Dict []
]
++ defines
++ [ Escape valuesPy,
Escape memoryPy,
Escape panicPy,
Escape tuningPy,
Escape scalarPy,
Escape serverPy
]
++ prog'
where
Imp.Definitions consts (Imp.Functions funs) = prog
compileProg' = withConstantSubsts consts $ do
compileConstants consts
definitions <- mapM compileFunc funs
at_inits <- gets compInit
let constructor' = constructorToFunDef constructor at_inits
case mode of
ToLibrary -> do
(entry_points, entry_point_types) <-
unzip . catMaybes <$> mapM (compileEntryFun sync DoNotReturnTiming) funs
return
[ ClassDef $
Class class_name $
Assign (Var "entry_points") (Dict entry_point_types) :
Assign
(Var "opaques")
(Dict $ zip (map String opaque_names) (map Tuple opaque_payloads)) :
map FunDef (constructor' : definitions ++ entry_points)
]
ToServer -> do
(entry_points, entry_point_types) <-
unzip . catMaybes <$> mapM (compileEntryFun sync ReturnTiming) funs
return $
parse_options_server
++ [ ClassDef
( Class class_name $
Assign (Var "entry_points") (Dict entry_point_types) :
Assign
(Var "opaques")
(Dict $ zip (map String opaque_names) (map Tuple opaque_payloads)) :
map FunDef (constructor' : definitions ++ entry_points)
),
Assign
(Var "server")
(simpleCall "Server" [simpleCall class_name []]),
Exp $ simpleCall "server.run" []
]
ToExecutable -> do
let classinst = Assign (Var "self") $ simpleCall class_name []
(entry_point_defs, entry_point_names, entry_points) <-
unzip3 . catMaybes <$> mapM (callEntryFun sync) funs
return $
parse_options_executable
++ ClassDef
( Class class_name $
map FunDef $
constructor' : definitions
) :
classinst :
map FunDef entry_point_defs
++ selectEntryPoint entry_point_names entry_points
parse_options_executable =
Assign (Var "runtime_file") None :
Assign (Var "do_warmup_run") (Bool False) :
Assign (Var "num_runs") (Integer 1) :
Assign (Var "entry_point") (String "main") :
Assign (Var "binary_output") (Bool False) :
generateOptionParser (executableOptions ++ options)
parse_options_server =
generateOptionParser (standardOptions ++ options)
(opaque_names, opaque_payloads) =
unzip $ M.toList $ opaqueDefs $ Imp.defFuns prog
selectEntryPoint entry_point_names entry_points =
[ Assign (Var "entry_points") $
Dict $ zip (map String entry_point_names) entry_points,
Assign (Var "entry_point_fun") $
simpleCall "entry_points.get" [Var "entry_point"],
If
(BinOp "==" (Var "entry_point_fun") None)
[ Exp $
simpleCall
"sys.exit"
[ Call
( Field
(String "No entry point '{}'. Select another with --entry point. Options are:\n{}")
"format"
)
[ Arg $ Var "entry_point",
Arg $
Call
(Field (String "\n") "join")
[Arg $ simpleCall "entry_points.keys" []]
]
]
]
[Exp $ simpleCall "entry_point_fun" []]
]
withConstantSubsts :: Imp.Constants op -> CompilerM op s a -> CompilerM op s a
withConstantSubsts (Imp.Constants ps _) =
local $ \env -> env {envVarExp = foldMap constExp ps}
where
constExp p =
M.singleton (Imp.paramName p) $
Index (Var "self.constants") $
IdxExp $ String $ pretty $ Imp.paramName p
compileConstants :: Imp.Constants op -> CompilerM op s ()
compileConstants (Imp.Constants _ init_consts) = do
atInit $ Assign (Var "self.constants") $ Dict []
mapM_ atInit =<< collect (compileCode init_consts)
compileFunc :: (Name, Imp.Function op) -> CompilerM op s PyFunDef
compileFunc (fname, Imp.Function _ outputs inputs body _ _) = do
body' <- collect $ compileCode body
let inputs' = map (compileName . Imp.paramName) inputs
let ret = Return $ tupleOrSingle $ compileOutput outputs
return $
Def (futharkFun . nameToString $ fname) ("self" : inputs') $
body' ++ [ret]
tupleOrSingle :: [PyExp] -> PyExp
tupleOrSingle [e] = e
tupleOrSingle es = Tuple es
-- | A 'Call' where the function is a variable and every argument is a
-- simple 'Arg'.
simpleCall :: String -> [PyExp] -> PyExp
simpleCall fname = Call (Var fname) . map Arg
compileName :: VName -> String
compileName = zEncodeString . pretty
compileDim :: Imp.DimSize -> CompilerM op s PyExp
compileDim (Imp.Constant v) = pure $ compilePrimValue v
compileDim (Imp.Var v) = compileVar v
unpackDim :: PyExp -> Imp.DimSize -> Int32 -> CompilerM op s ()
unpackDim arr_name (Imp.Constant c) i = do
let shape_name = Field arr_name "shape"
let constant_c = compilePrimValue c
let constant_i = Integer $ toInteger i
stm $
Assert (BinOp "==" constant_c (Index shape_name $ IdxExp constant_i)) $
String "Entry point arguments have invalid sizes."
unpackDim arr_name (Imp.Var var) i = do
let shape_name = Field arr_name "shape"
src = Index shape_name $ IdxExp $ Integer $ toInteger i
var' <- compileVar var
stm $
If
(BinOp "==" var' None)
[Assign var' $ simpleCall "np.int64" [src]]
[ Assert (BinOp "==" var' src) $
String "Error: entry point arguments have invalid sizes."
]
entryPointOutput :: Imp.ExternalValue -> CompilerM op s PyExp
entryPointOutput (Imp.OpaqueValue u desc vs) =
simpleCall "opaque" . (String (pretty desc) :)
<$> mapM (entryPointOutput . Imp.TransparentValue u) vs
entryPointOutput (Imp.TransparentValue _ (Imp.ScalarValue bt ept name)) = do
name' <- compileVar name
return $ simpleCall tf [name']
where
tf = compilePrimToExtNp bt ept
entryPointOutput (Imp.TransparentValue _ (Imp.ArrayValue mem (Imp.Space sid) bt ept dims)) = do
pack_output <- asks envEntryOutput
pack_output mem sid bt ept dims
entryPointOutput (Imp.TransparentValue _ (Imp.ArrayValue mem _ bt ept dims)) = do
mem' <- Cast <$> compileVar mem <*> pure (compilePrimTypeExt bt ept)
dims' <- mapM compileDim dims
return $ simpleCall "createArray" [mem', Tuple dims', Var $ compilePrimToExtNp bt ept]
badInput :: Int -> PyExp -> String -> PyStmt
badInput i e t =
Raise $
simpleCall
"TypeError"
[ Call
(Field (String err_msg) "format")
[Arg (String t), Arg $ simpleCall "type" [e], Arg e]
]
where
err_msg =
unlines
[ "Argument #" ++ show i ++ " has invalid value",
"Futhark type: {}",
"Argument has Python type {} and value: {}"
]
badInputType :: Int -> PyExp -> String -> PyExp -> PyExp -> PyStmt
badInputType i e t de dg =
Raise $
simpleCall
"TypeError"
[ Call
(Field (String err_msg) "format")
[Arg (String t), Arg $ simpleCall "type" [e], Arg e, Arg de, Arg dg]
]
where
err_msg =
unlines
[ "Argument #" ++ show i ++ " has invalid value",
"Futhark type: {}",
"Argument has Python type {} and value: {}",
"Expected array with elements of dtype: {}",
"The array given has elements of dtype: {}"
]
badInputDim :: Int -> PyExp -> String -> Int -> PyStmt
badInputDim i e typ dimf =
Raise $
simpleCall
"TypeError"
[ Call
(Field (String err_msg) "format")
[Arg eft, Arg aft]
]
where
eft = String (concat (replicate dimf "[]") ++ typ)
aft = BinOp "+" (BinOp "*" (String "[]") (Field e "ndim")) (String typ)
err_msg =
unlines
[ "Argument #" ++ show i ++ " has invalid value",
"Dimensionality mismatch",
"Expected Futhark type: {}",
"Bad Python value passed",
"Actual Futhark type: {}"
]
declEntryPointInputSizes :: [Imp.ExternalValue] -> CompilerM op s ()
declEntryPointInputSizes = mapM_ onSize . concatMap sizes
where
sizes (Imp.TransparentValue _ v) = valueSizes v
sizes (Imp.OpaqueValue _ _ vs) = concatMap valueSizes vs
valueSizes (Imp.ArrayValue _ _ _ _ dims) = subExpVars dims
valueSizes Imp.ScalarValue {} = []
onSize v = stm $ Assign (Var (compileName v)) None
entryPointInput :: (Int, Imp.ExternalValue, PyExp) -> CompilerM op s ()
entryPointInput (i, Imp.OpaqueValue u desc vs, e) = do
let type_is_ok =
BinOp
"and"
(simpleCall "isinstance" [e, Var "opaque"])
(BinOp "==" (Field e "desc") (String desc))
stm $ If (UnOp "not" type_is_ok) [badInput i e desc] []
mapM_ entryPointInput $
zip3 (repeat i) (map (Imp.TransparentValue u) vs) $
map (Index (Field e "data") . IdxExp . Integer) [0 ..]
entryPointInput (i, Imp.TransparentValue _ (Imp.ScalarValue bt s name), e) = do
vname' <- compileVar name
let -- HACK: A Numpy int64 will signal an OverflowError if we pass
-- it a number bigger than 2**63. This does not happen if we
-- pass e.g. int8 a number bigger than 2**7. As a workaround,
-- we first go through the corresponding ctypes type, which does
-- not have this problem.
ctobject = compilePrimType bt
npobject = compilePrimToNp bt
npcall =
simpleCall
npobject
[ case bt of
IntType Int64 -> simpleCall ctobject [e]
_ -> e
]
stm $
Try
[Assign vname' npcall]
[ Catch
(Tuple [Var "TypeError", Var "AssertionError"])
[badInput i e $ prettySigned (s == Imp.TypeUnsigned) bt]
]
entryPointInput (i, Imp.TransparentValue _ (Imp.ArrayValue mem (Imp.Space sid) bt ept dims), e) = do
unpack_input <- asks envEntryInput
mem' <- compileVar mem
unpack <- collect $ unpack_input mem' sid bt ept dims e
stm $
Try
unpack
[ Catch
(Tuple [Var "TypeError", Var "AssertionError"])
[ badInput i e $
concat (replicate (length dims) "[]")
++ prettySigned (ept == Imp.TypeUnsigned) bt
]
]
entryPointInput (i, Imp.TransparentValue _ (Imp.ArrayValue mem _ t s dims), e) = do
let type_is_wrong = UnOp "not" $ BinOp "in" (simpleCall "type" [e]) $ List [Var "np.ndarray"]
let dtype_is_wrong = UnOp "not" $ BinOp "==" (Field e "dtype") $ Var $ compilePrimToExtNp t s
let dim_is_wrong = UnOp "not" $ BinOp "==" (Field e "ndim") $ Integer $ toInteger $ length dims
stm $
If
type_is_wrong
[ badInput i e $
concat (replicate (length dims) "[]")
++ prettySigned (s == Imp.TypeUnsigned) t
]
[]
stm $
If
dtype_is_wrong
[ badInputType
i
e
(concat (replicate (length dims) "[]") ++ prettySigned (s == Imp.TypeUnsigned) t)
(simpleCall "np.dtype" [Var (compilePrimToExtNp t s)])
(Field e "dtype")
]
[]
stm $
If
dim_is_wrong
[badInputDim i e (prettySigned (s == Imp.TypeUnsigned) t) (length dims)]
[]
zipWithM_ (unpackDim e) dims [0 ..]
dest <- compileVar mem
let unwrap_call = simpleCall "unwrapArray" [e]
stm $ Assign dest unwrap_call
extValueDescName :: Imp.ExternalValue -> String
extValueDescName (Imp.TransparentValue _ v) = extName $ valueDescName v
extValueDescName (Imp.OpaqueValue _ desc []) = extName $ zEncodeString desc
extValueDescName (Imp.OpaqueValue _ desc (v : _)) =
extName $ zEncodeString desc ++ "_" ++ pretty (baseTag (valueDescVName v))
extName :: String -> String
extName = (++ "_ext")
valueDescName :: Imp.ValueDesc -> String
valueDescName = compileName . valueDescVName
valueDescVName :: Imp.ValueDesc -> VName
valueDescVName (Imp.ScalarValue _ _ vname) = vname
valueDescVName (Imp.ArrayValue vname _ _ _ _) = vname
-- Key into the FUTHARK_PRIMTYPES dict.
readTypeEnum :: PrimType -> Imp.Signedness -> String
readTypeEnum (IntType Int8) Imp.TypeUnsigned = "u8"
readTypeEnum (IntType Int16) Imp.TypeUnsigned = "u16"
readTypeEnum (IntType Int32) Imp.TypeUnsigned = "u32"
readTypeEnum (IntType Int64) Imp.TypeUnsigned = "u64"
readTypeEnum (IntType Int8) Imp.TypeDirect = "i8"
readTypeEnum (IntType Int16) Imp.TypeDirect = "i16"
readTypeEnum (IntType Int32) Imp.TypeDirect = "i32"
readTypeEnum (IntType Int64) Imp.TypeDirect = "i64"
readTypeEnum (FloatType Float16) _ = "f16"
readTypeEnum (FloatType Float32) _ = "f32"
readTypeEnum (FloatType Float64) _ = "f64"
readTypeEnum Imp.Bool _ = "bool"
readTypeEnum Unit _ = "bool"
readInput :: Imp.ExternalValue -> PyStmt
readInput (Imp.OpaqueValue _ desc _) =
Raise $
simpleCall
"Exception"
[String $ "Cannot read argument of type " ++ desc ++ "."]
readInput decl@(Imp.TransparentValue _ (Imp.ScalarValue bt ept _)) =
let type_name = readTypeEnum bt ept
in Assign (Var $ extValueDescName decl) $ simpleCall "read_value" [String type_name]
readInput decl@(Imp.TransparentValue _ (Imp.ArrayValue _ _ bt ept dims)) =
let type_name = readTypeEnum bt ept
in Assign (Var $ extValueDescName decl) $
simpleCall
"read_value"
[String $ concat (replicate (length dims) "[]") ++ type_name]
printValue :: [(Imp.ExternalValue, PyExp)] -> CompilerM op s [PyStmt]
printValue = fmap concat . mapM (uncurry printValue')
where
-- We copy non-host arrays to the host before printing. This is
-- done in a hacky way - we assume the value has a .get()-method
-- that returns an equivalent Numpy array. This works for PyOpenCL,
-- but we will probably need yet another plugin mechanism here in
-- the future.
printValue' (Imp.OpaqueValue _ desc _) _ =
return
[ Exp $
simpleCall
"sys.stdout.write"
[String $ "#<opaque " ++ desc ++ ">"]
]
printValue' (Imp.TransparentValue u (Imp.ArrayValue mem (Space _) bt ept shape)) e =
printValue' (Imp.TransparentValue u (Imp.ArrayValue mem DefaultSpace bt ept shape)) $
simpleCall (pretty e ++ ".get") []
printValue' (Imp.TransparentValue _ _) e =
return
[ Exp $
Call
(Var "write_value")
[ Arg e,
ArgKeyword "binary" (Var "binary_output")
],
Exp $ simpleCall "sys.stdout.write" [String "\n"]
]
prepareEntry ::
(Name, Imp.Function op) ->
CompilerM
op
s
( [String],
[PyStmt],
[PyStmt],
[PyStmt],
[PyStmt],
[(Imp.ExternalValue, PyExp)],
[PyStmt]
)
prepareEntry (fname, Imp.Function _ outputs inputs _ results args) = do
let output_paramNames = map (compileName . Imp.paramName) outputs
funTuple = tupleOrSingle $ fmap Var output_paramNames
(argexps_mem_copies, prepare_run) <- collect' $
forM inputs $ \case
Imp.MemParam name space -> do
-- A program might write to its input parameters, so create a new memory
-- block and copy the source there. This way the program can be run more
-- than once.
name' <- newVName $ baseString name <> "_copy"
copy <- asks envCopy
allocate <- asks envAllocate
let size = Var (extName (compileName name) ++ ".nbytes") -- FIXME
dest = name'
src = name
offset = Integer 0
case space of
Space sid ->
allocate (Var (compileName name')) size sid
_ ->
stm $
Assign
(Var (compileName name'))
(simpleCall "allocateMem" [size]) -- FIXME
dest' <- compileVar dest
src' <- compileVar src
copy dest' offset space src' offset space size (IntType Int32) -- FIXME
return $ Just $ compileName name'
_ -> return Nothing
prepareIn <- collect $ do
declEntryPointInputSizes $ map snd args
mapM_ entryPointInput . zip3 [0 ..] (map snd args) $
map (Var . extValueDescName . snd) args
(res, prepareOut) <- collect' $ mapM entryPointOutput results
let argexps_lib = map (compileName . Imp.paramName) inputs
argexps_bin = zipWith fromMaybe argexps_lib argexps_mem_copies
fname' = "self." ++ futharkFun (nameToString fname)
-- We ignore overflow errors and the like for executable entry
-- points. These are (somewhat) well-defined in Futhark.
ignore s = ArgKeyword s $ String "ignore"
errstate = Call (Var "np.errstate") $ map ignore ["divide", "over", "under", "invalid"]
call argexps =
[ With
errstate
[Assign funTuple $ simpleCall fname' (fmap Var argexps)]
]
return
( map (extValueDescName . snd) args,
prepareIn,
call argexps_lib,
call argexps_bin,
prepareOut,
zip results res,
prepare_run
)
copyMemoryDefaultSpace ::
PyExp ->
PyExp ->
PyExp ->
PyExp ->
PyExp ->
CompilerM op s ()
copyMemoryDefaultSpace destmem destidx srcmem srcidx nbytes = do
let offset_call1 =
simpleCall
"addressOffset"
[destmem, destidx, Var "ct.c_byte"]
let offset_call2 =
simpleCall
"addressOffset"
[srcmem, srcidx, Var "ct.c_byte"]
stm $ Exp $ simpleCall "ct.memmove" [offset_call1, offset_call2, nbytes]
data ReturnTiming = ReturnTiming | DoNotReturnTiming
compileEntryFun ::
[PyStmt] ->
ReturnTiming ->
(Name, Imp.Function op) ->
CompilerM op s (Maybe (PyFunDef, (PyExp, PyExp)))
compileEntryFun sync timing entry
| Just ename <- Imp.functionEntry $ snd entry = do
(params, prepareIn, body_lib, _, prepareOut, res, _) <- prepareEntry entry
let (maybe_sync, ret) =
case timing of
DoNotReturnTiming ->
( [],
Return $ tupleOrSingle $ map snd res
)
ReturnTiming ->
( sync,
Return $
Tuple
[ Var "runtime",
tupleOrSingle $ map snd res
]
)
(pts, rts) = entryTypes $ snd entry
do_run =
Assign (Var "time_start") (simpleCall "time.time" []) :
body_lib ++ maybe_sync
++ [ Assign (Var "runtime") $
BinOp
"-"
(toMicroseconds (simpleCall "time.time" []))
(toMicroseconds (Var "time_start"))
]
pure $
Just
( Def (nameToString ename) ("self" : params) $
prepareIn ++ do_run ++ prepareOut ++ sync ++ [ret],
(String (nameToString ename), Tuple [List (map String pts), List (map String rts)])
)
| otherwise = pure Nothing
entryTypes :: Imp.Function op -> ([String], [String])
entryTypes func =
( map (desc . snd) $ Imp.functionArgs func,
map desc $ Imp.functionResult func
)
where
desc (Imp.OpaqueValue u d _) = pretty u <> d
desc (Imp.TransparentValue u (Imp.ScalarValue pt s _)) = pretty u <> readTypeEnum pt s
desc (Imp.TransparentValue u (Imp.ArrayValue _ _ pt s dims)) =
pretty u <> concat (replicate (length dims) "[]") <> readTypeEnum pt s
callEntryFun ::
[PyStmt] ->
(Name, Imp.Function op) ->
CompilerM op s (Maybe (PyFunDef, String, PyExp))
callEntryFun _ (_, Imp.Function Nothing _ _ _ _ _) = pure Nothing
callEntryFun pre_timing entry@(fname, Imp.Function (Just ename) _ _ _ _ decl_args) = do
(_, prepare_in, _, body_bin, _, res, prepare_run) <- prepareEntry entry
let str_input = map (readInput . snd) decl_args
end_of_input = [Exp $ simpleCall "end_of_input" [String $ pretty fname]]
exitcall = [Exp $ simpleCall "sys.exit" [Field (String "Assertion.{} failed") "format(e)"]]
except' = Catch (Var "AssertionError") exitcall
do_run = body_bin ++ pre_timing
(do_run_with_timing, close_runtime_file) = addTiming do_run
do_warmup_run =
If (Var "do_warmup_run") (prepare_run ++ do_run) []
do_num_runs =
For
"i"
(simpleCall "range" [simpleCall "int" [Var "num_runs"]])
(prepare_run ++ do_run_with_timing)
str_output <- printValue res
let fname' = "entry_" ++ nameToString fname
pure $
Just
( Def fname' [] $
str_input ++ end_of_input ++ prepare_in
++ [Try [do_warmup_run, do_num_runs] [except']]
++ [close_runtime_file]
++ str_output,
nameToString ename,
Var fname'
)
addTiming :: [PyStmt] -> ([PyStmt], PyStmt)
addTiming statements =
( [Assign (Var "time_start") $ simpleCall "time.time" []]
++ statements
++ [ Assign (Var "time_end") $ simpleCall "time.time" [],
If (Var "runtime_file") print_runtime []
],
If (Var "runtime_file") [Exp $ simpleCall "runtime_file.close" []] []
)
where
print_runtime =
[ Exp $
simpleCall
"runtime_file.write"
[ simpleCall
"str"
[ BinOp
"-"
(toMicroseconds (Var "time_end"))
(toMicroseconds (Var "time_start"))
]
],
Exp $ simpleCall "runtime_file.write" [String "\n"],
Exp $ simpleCall "runtime_file.flush" []
]
toMicroseconds :: PyExp -> PyExp
toMicroseconds x =
simpleCall "int" [BinOp "*" x $ Integer 1000000]
compileUnOp :: Imp.UnOp -> String
compileUnOp op =
case op of
Not -> "not"
Complement {} -> "~"
Abs {} -> "abs"
FAbs {} -> "abs"
SSignum {} -> "ssignum"
USignum {} -> "usignum"
FSignum {} -> "np.sign"
compileBinOpLike ::
Monad m =>
(v -> m PyExp) ->
Imp.PrimExp v ->
Imp.PrimExp v ->
m (PyExp, PyExp, String -> m PyExp)
compileBinOpLike f x y = do
x' <- compilePrimExp f x
y' <- compilePrimExp f y
let simple s = return $ BinOp s x' y'
return (x', y', simple)
-- | The ctypes type corresponding to a 'PrimType'.
compilePrimType :: PrimType -> String
compilePrimType t =
case t of
IntType Int8 -> "ct.c_int8"
IntType Int16 -> "ct.c_int16"
IntType Int32 -> "ct.c_int32"
IntType Int64 -> "ct.c_int64"
FloatType Float16 -> "ct.c_uint16"
FloatType Float32 -> "ct.c_float"
FloatType Float64 -> "ct.c_double"
Imp.Bool -> "ct.c_bool"
Unit -> "ct.c_bool"
-- | The ctypes type corresponding to a 'PrimType', taking sign into account.
compilePrimTypeExt :: PrimType -> Imp.Signedness -> String
compilePrimTypeExt t ept =
case (t, ept) of
(IntType Int8, Imp.TypeUnsigned) -> "ct.c_uint8"
(IntType Int16, Imp.TypeUnsigned) -> "ct.c_uint16"
(IntType Int32, Imp.TypeUnsigned) -> "ct.c_uint32"
(IntType Int64, Imp.TypeUnsigned) -> "ct.c_uint64"
(IntType Int8, _) -> "ct.c_int8"
(IntType Int16, _) -> "ct.c_int16"
(IntType Int32, _) -> "ct.c_int32"
(IntType Int64, _) -> "ct.c_int64"
(FloatType Float16, _) -> "ct.c_uint16"
(FloatType Float32, _) -> "ct.c_float"
(FloatType Float64, _) -> "ct.c_double"
(Imp.Bool, _) -> "ct.c_bool"
(Unit, _) -> "ct.c_byte"
-- | The Numpy type corresponding to a 'PrimType'.
compilePrimToNp :: Imp.PrimType -> String
compilePrimToNp bt =
case bt of
IntType Int8 -> "np.int8"
IntType Int16 -> "np.int16"
IntType Int32 -> "np.int32"
IntType Int64 -> "np.int64"
FloatType Float16 -> "np.float16"
FloatType Float32 -> "np.float32"
FloatType Float64 -> "np.float64"
Imp.Bool -> "np.byte"
Unit -> "np.byte"
-- | The Numpy type corresponding to a 'PrimType', taking sign into account.
compilePrimToExtNp :: Imp.PrimType -> Imp.Signedness -> String
compilePrimToExtNp bt ept =
case (bt, ept) of
(IntType Int8, Imp.TypeUnsigned) -> "np.uint8"
(IntType Int16, Imp.TypeUnsigned) -> "np.uint16"
(IntType Int32, Imp.TypeUnsigned) -> "np.uint32"
(IntType Int64, Imp.TypeUnsigned) -> "np.uint64"
(IntType Int8, _) -> "np.int8"
(IntType Int16, _) -> "np.int16"
(IntType Int32, _) -> "np.int32"
(IntType Int64, _) -> "np.int64"
(FloatType Float16, _) -> "np.float16"
(FloatType Float32, _) -> "np.float32"
(FloatType Float64, _) -> "np.float64"
(Imp.Bool, _) -> "np.bool_"
(Unit, _) -> "np.byte"
-- | Convert from scalar to storage representation for the given type.
toStorage :: PrimType -> PyExp -> PyExp
toStorage (FloatType Float16) e =
simpleCall "ct.c_int16" [simpleCall "futhark_to_bits16" [e]]
toStorage t e = simpleCall (compilePrimType t) [e]
-- | Convert from storage to scalar representation for the given type.
fromStorage :: PrimType -> PyExp -> PyExp
fromStorage (FloatType Float16) e =
simpleCall "futhark_from_bits16" [simpleCall "np.int16" [e]]
fromStorage t e = simpleCall (compilePrimToNp t) [e]
compilePrimValue :: Imp.PrimValue -> PyExp
compilePrimValue (IntValue (Int8Value v)) =
simpleCall "np.int8" [Integer $ toInteger v]
compilePrimValue (IntValue (Int16Value v)) =
simpleCall "np.int16" [Integer $ toInteger v]
compilePrimValue (IntValue (Int32Value v)) =
simpleCall "np.int32" [Integer $ toInteger v]
compilePrimValue (IntValue (Int64Value v)) =
simpleCall "np.int64" [Integer $ toInteger v]
compilePrimValue (FloatValue (Float16Value v))
| isInfinite v =
if v > 0 then Var "np.inf" else Var "-np.inf"
| isNaN v =
Var "np.nan"
| otherwise = simpleCall "np.float16" [Float $ fromRational $ toRational v]
compilePrimValue (FloatValue (Float32Value v))
| isInfinite v =
if v > 0 then Var "np.inf" else Var "-np.inf"
| isNaN v =
Var "np.nan"
| otherwise = simpleCall "np.float32" [Float $ fromRational $ toRational v]
compilePrimValue (FloatValue (Float64Value v))
| isInfinite v =
if v > 0 then Var "np.inf" else Var "-np.inf"
| isNaN v =
Var "np.nan"
| otherwise = simpleCall "np.float64" [Float $ fromRational $ toRational v]
compilePrimValue (BoolValue v) = Bool v
compilePrimValue UnitValue = Var "None"
compileVar :: VName -> CompilerM op s PyExp
compileVar v =
asks $ fromMaybe (Var $ compileName v) . M.lookup v . envVarExp
-- | Tell me how to compile a @v@, and I'll Compile any @PrimExp v@ for you.
compilePrimExp :: Monad m => (v -> m PyExp) -> Imp.PrimExp v -> m PyExp
compilePrimExp _ (Imp.ValueExp v) = return $ compilePrimValue v
compilePrimExp f (Imp.LeafExp v _) = f v
compilePrimExp f (Imp.BinOpExp op x y) = do
(x', y', simple) <- compileBinOpLike f x y
case op of
Add {} -> simple "+"
Sub {} -> simple "-"
Mul {} -> simple "*"
FAdd {} -> simple "+"
FSub {} -> simple "-"
FMul {} -> simple "*"
FDiv {} -> simple "/"
FMod {} -> simple "%"
Xor {} -> simple "^"
And {} -> simple "&"
Or {} -> simple "|"
Shl {} -> simple "<<"
LogAnd {} -> simple "and"
LogOr {} -> simple "or"
_ -> return $ simpleCall (pretty op) [x', y']
compilePrimExp f (Imp.ConvOpExp conv x) = do
x' <- compilePrimExp f x
return $ simpleCall (pretty conv) [x']
compilePrimExp f (Imp.CmpOpExp cmp x y) = do
(x', y', simple) <- compileBinOpLike f x y
case cmp of
CmpEq {} -> simple "=="
FCmpLt {} -> simple "<"
FCmpLe {} -> simple "<="
CmpLlt -> simple "<"
CmpLle -> simple "<="
_ -> return $ simpleCall (pretty cmp) [x', y']
compilePrimExp f (Imp.UnOpExp op exp1) =
UnOp (compileUnOp op) <$> compilePrimExp f exp1
compilePrimExp f (Imp.FunExp h args _) =
simpleCall (futharkFun (pretty h)) <$> mapM (compilePrimExp f) args
compileExp :: Imp.Exp -> CompilerM op s PyExp
compileExp = compilePrimExp compileLeaf
where
compileLeaf (Imp.ScalarVar vname) =
compileVar vname
compileLeaf (Imp.Index _ _ Unit _ _) =
return $ compilePrimValue UnitValue
compileLeaf (Imp.Index src (Imp.Count iexp) restype (Imp.Space space) _) =
join $
asks envReadScalar
<*> compileVar src
<*> compileExp (Imp.untyped iexp)
<*> pure restype
<*> pure space
compileLeaf (Imp.Index src (Imp.Count iexp) bt _ _) = do
iexp' <- compileExp $ Imp.untyped iexp
let bt' = compilePrimType bt
src' <- compileVar src
return $ fromStorage bt $ simpleCall "indexArray" [src', iexp', Var bt']
errorMsgString :: Imp.ErrorMsg Imp.Exp -> CompilerM op s (String, [PyExp])
errorMsgString (Imp.ErrorMsg parts) = do
let onPart (Imp.ErrorString s) = return ("%s", String s)
onPart (Imp.ErrorVal IntType {} x) = ("%d",) <$> compileExp x
onPart (Imp.ErrorVal FloatType {} x) = ("%f",) <$> compileExp x
onPart (Imp.ErrorVal Imp.Bool x) = ("%r",) <$> compileExp x
onPart (Imp.ErrorVal Unit {} x) = ("%r",) <$> compileExp x
(formatstrs, formatargs) <- unzip <$> mapM onPart parts
pure (mconcat formatstrs, formatargs)
compileCode :: Imp.Code op -> CompilerM op s ()
compileCode Imp.DebugPrint {} =
return ()
compileCode Imp.TracePrint {} =
return ()
compileCode (Imp.Op op) =
join $ asks envOpCompiler <*> pure op
compileCode (Imp.If cond tb fb) = do
cond' <- compileExp $ Imp.untyped cond
tb' <- collect $ compileCode tb
fb' <- collect $ compileCode fb
stm $ If cond' tb' fb'
compileCode (c1 Imp.:>>: c2) = do
compileCode c1
compileCode c2
compileCode (Imp.While cond body) = do
cond' <- compileExp $ Imp.untyped cond
body' <- collect $ compileCode body
stm $ While cond' body'
compileCode (Imp.For i bound body) = do
bound' <- compileExp bound
let i' = compileName i
body' <- collect $ compileCode body
counter <- pretty <$> newVName "counter"
one <- pretty <$> newVName "one"
stm $ Assign (Var i') $ simpleCall (compilePrimToNp (Imp.primExpType bound)) [Integer 0]
stm $ Assign (Var one) $ simpleCall (compilePrimToNp (Imp.primExpType bound)) [Integer 1]
stm $
For counter (simpleCall "range" [bound']) $
body' ++ [AssignOp "+" (Var i') (Var one)]
compileCode (Imp.SetScalar name exp1) =
stm =<< Assign <$> compileVar name <*> compileExp exp1
compileCode Imp.DeclareMem {} = return ()
compileCode (Imp.DeclareScalar v _ Unit) = do
v' <- compileVar v
stm $ Assign v' $ Var "True"
compileCode Imp.DeclareScalar {} = return ()
compileCode (Imp.DeclareArray name (Space space) t vs) =
join $
asks envStaticArray
<*> pure name
<*> pure space
<*> pure t
<*> pure vs
compileCode (Imp.DeclareArray name _ t vs) = do
let arr_name = compileName name <> "_arr"
-- It is important to store the Numpy array in a temporary variable
-- to prevent it from going "out-of-scope" before calling
-- unwrapArray (which internally uses the .ctype method); see
-- https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.ctypes.html
atInit $
Assign (Field (Var "self") arr_name) $ case vs of
Imp.ArrayValues vs' ->
Call
(Var "np.array")
[ Arg $ List $ map compilePrimValue vs',
ArgKeyword "dtype" $ Var $ compilePrimToNp t
]
Imp.ArrayZeros n ->
Call
(Var "np.zeros")
[ Arg $ Integer $ fromIntegral n,
ArgKeyword "dtype" $ Var $ compilePrimToNp t
]
atInit $
Assign (Field (Var "self") (compileName name)) $
simpleCall "unwrapArray" [Field (Var "self") arr_name]
name' <- compileVar name
stm $ Assign name' $ Field (Var "self") (compileName name)
compileCode (Imp.Comment s code) = do
code' <- collect $ compileCode code
stm $ Comment s code'
compileCode (Imp.Assert e msg (loc, locs)) = do
e' <- compileExp e
(formatstr, formatargs) <- errorMsgString msg
stm $
Assert
e'
( BinOp
"%"
(String $ "Error: " ++ formatstr ++ "\n\nBacktrace:\n" ++ stacktrace)
(Tuple formatargs)
)
where
stacktrace = prettyStacktrace 0 $ map locStr $ loc : locs
compileCode (Imp.Call dests fname args) = do
args' <- mapM compileArg args
dests' <- tupleOrSingle <$> mapM compileVar dests
let fname'
| isBuiltInFunction fname = futharkFun (pretty fname)
| otherwise = "self." ++ futharkFun (pretty fname)
call' = simpleCall fname' args'
-- If the function returns nothing (is called only for side
-- effects), take care not to assign to an empty tuple.
stm $
if null dests
then Exp call'
else Assign dests' call'
where
compileArg (Imp.MemArg m) = compileVar m
compileArg (Imp.ExpArg e) = compileExp e
compileCode (Imp.SetMem dest src _) =
stm =<< Assign <$> compileVar dest <*> compileVar src
compileCode (Imp.Allocate name (Imp.Count (Imp.TPrimExp e)) (Imp.Space space)) =
join $
asks envAllocate
<*> compileVar name
<*> compileExp e
<*> pure space
compileCode (Imp.Allocate name (Imp.Count (Imp.TPrimExp e)) _) = do
e' <- compileExp e
let allocate' = simpleCall "allocateMem" [e']
stm =<< Assign <$> compileVar name <*> pure allocate'
compileCode (Imp.Free name _) =
stm =<< Assign <$> compileVar name <*> pure None
compileCode (Imp.Copy dest (Imp.Count destoffset) DefaultSpace src (Imp.Count srcoffset) DefaultSpace (Imp.Count size)) = do
destoffset' <- compileExp $ Imp.untyped destoffset
srcoffset' <- compileExp $ Imp.untyped srcoffset
dest' <- compileVar dest
src' <- compileVar src
size' <- compileExp $ Imp.untyped size
let offset_call1 = simpleCall "addressOffset" [dest', destoffset', Var "ct.c_byte"]
let offset_call2 = simpleCall "addressOffset" [src', srcoffset', Var "ct.c_byte"]
stm $ Exp $ simpleCall "ct.memmove" [offset_call1, offset_call2, size']
compileCode (Imp.Copy dest (Imp.Count destoffset) destspace src (Imp.Count srcoffset) srcspace (Imp.Count size)) = do
copy <- asks envCopy
join $
copy
<$> compileVar dest
<*> compileExp (Imp.untyped destoffset)
<*> pure destspace
<*> compileVar src
<*> compileExp (Imp.untyped srcoffset)
<*> pure srcspace
<*> compileExp (Imp.untyped size)
<*> pure (IntType Int32) -- FIXME
compileCode (Imp.Write _ _ Unit _ _ _) = pure ()
compileCode (Imp.Write dest (Imp.Count idx) elemtype (Imp.Space space) _ elemexp) =
join $
asks envWriteScalar
<*> compileVar dest
<*> compileExp (Imp.untyped idx)
<*> pure elemtype
<*> pure space
<*> compileExp elemexp
compileCode (Imp.Write dest (Imp.Count idx) elemtype _ _ elemexp) = do
idx' <- compileExp $ Imp.untyped idx
elemexp' <- toStorage elemtype <$> compileExp elemexp
dest' <- compileVar dest
stm $ Exp $ simpleCall "writeScalarArray" [dest', idx', elemexp']
compileCode Imp.Skip = return ()