descriptionnone
ownerskimo-pet@kotnet.org
last changeThu, 4 May 2017 13:47:18 +0000 (4 15:47 +0200)
content tags
add:
README
Requirements:

- pkg-config (http://www.freedesktop.org/wiki/Software/pkg-config)
	(not needed when compiling a release using the included isl)
- gmp (http://gmplib.org/)
- libyaml (http://pyyaml.org/wiki/LibYAML)
	(only needed if you want to compile the pet executable)
- LLVM/clang libraries, 2.9 or higher (http://clang.llvm.org/get_started.html)
	Unless you have some other reasons for wanting to use the svn version,
	it's best to install the latest release (3.8).
	The svn version occasionally introduces incompatibilities.
	Nevertheless, if you encounter any such incompatibilities, please
	report them so that they can be fixed.
	However, development versions from before the latest release
	are not supported.

	Also, if you are following the instructions on how to build
	from source, make sure you also install LLVM
	(through "make install").  You may want to specify an installation
	directory using the CMAKE_INSTALL_PREFIX cmake option.
	You may also want to set the LLVM_BUILD_LLVM_DYLIB option
	to enable the creation of a single shared library.

	If you configure older versions of LLVM using cmake, you may end up
	with clang libraries that have been compiled with -fno-rtti without
	this option appearing in the output of "llvm-config --cxxflags".
	You may then run into errors about undefined reference to the
	'typeinfo' of some classes.
	You will then have to add this option manually to CXXFLAGS while
	configuring pet.

	If you want to use the ubuntu package libclang-dev, then you need
	version 3.2 (ubuntu raring) or later.
	Older versions of this package did not include the required libraries.

Preparing:

Grab the latest release and extract it or get the source from
the git repository as follows.  This process requires autoconf,
automake and libtool.

	git clone git://repo.or.cz/pet.git
	cd pet
	./get_submodules.sh
	./autogen.sh

Compilation:

	./configure
	make
	make check

Use:

The main entry point is pet_scop_extract_from_C_source.
This function extracts a scop from the C source file with the given name
and returns it as a pet_scop.  The scop corresponds to the piece
of code delimited by

    #pragma scop

and

    #pragma endscop

The code in between needs to consist only of expression statements,
if statements and for statements.  All access relations and loop initializations
need to be piecewise quasi-affine.  Conditions are allowed to be non-affine,
in which case a separate statement is constructed to evaluate the condition.

If the autodetect option has been set, pet will try to automatically
detect a scop and no pragmas are required.  On the other hand, pet
will not produce any warnings in this case as any code that does not
satisfy the requirements is considered to lie outside of the scop.

The layout of pet_scop is documented in include/pet.h.


New releases are announced on http://freecode.com/projects/libpet

If you use pet, you can let me know by stacking
https://www.ohloh.net/p/libpet on ohloh.

For bug reports, feature requests and questions,
contact isl-development@googlegroups.com

If you use pet for your research, you are invited to cite
the following paper.

@InProceedings{Verdoolaege2012pet,
    author = {Sven Verdoolaege and Tobias Grosser},
    title = {Polyhedral Extraction Tool},
    booktitle = {Second Int. Workshop on Polyhedral Compilation Techniques
		(IMPACT'12)},
    address = {Paris, France},
    month = jan,
    year = {2012}
}
shortlog
2017-05-04 Sven Verdoolaegeinterface/isl.py.top: explicitly cast self.ptr of Conte... master
2017-05-04 Sven Verdoolaegeinterface/pet.py: specify argument types of called...
2017-05-04 Sven Verdoolaegeupdate isl for fixes in python bindings
2017-05-04 Sven Verdoolaegeupdate isl for change in interface/extract_interface...
2017-03-09 Sven Verdoolaegesupport inlining of non-outermost call expressions
2017-03-09 Sven Verdoolaegemake PetScan::extract_inlined_call public
2017-03-09 Sven Verdoolaegeadd pet_id_ret_from_type
2017-03-09 Sven Verdoolaegeadd pet_tree_map_top_down
2017-03-09 Sven Verdoolaegeallow return statements in summary functions
2017-03-09 Sven Verdoolaegepet_tree: support return statements
2017-03-09 Sven Verdoolaegepet_inliner::assign: drop redundant QualType argument
2017-03-09 Sven Verdoolaegeextract out (nearly) shared pet_expr_access_from_id
2017-03-09 Sven Verdoolaegeexpr_plus.cc: extract_depth: use pet_id_get_array_type...
2017-03-09 Sven VerdoolaegePetScan: extract out pet_expr_access_from_index
2017-03-08 Sven Verdoolaegepet_scop_collect_arrays: only collect siblings of acces...
2017-03-08 Sven Verdoolaegepet_scop_collect_arrays: consider all accessed data...
...
tags
5 months ago pet-0.10 pet 0.10
12 months ago pet-0.09 pet 0.09
16 months ago pet-0.08 pet 0.08
23 months ago pet-0.07 pet 0.07
2 years ago pet-0.06 pet 0.06
3 years ago pet-0.05 pet 0.05
3 years ago pet-0.04 pet 0.04
4 years ago pet-0.03 pet 0.03
4 years ago pet-0.02 pet 0.02
5 years ago pet-0.01 pet 0.01
heads
3 weeks ago master