Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
Q
QueryR
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Container Registry
Model registry
Operate
Environments
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Julien Lopez
QueryR
Commits
7d146841
Commit
7d146841
authored
11 years ago
by
Mick Jordan
Browse files
Options
Downloads
Patches
Plain Diff
refer to the Wiki from README
parent
7f14abdd
No related branches found
Branches containing commit
No related tags found
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
README.md
+1
-62
1 addition, 62 deletions
README.md
with
1 addition
and
62 deletions
README.md
+
1
−
62
View file @
7d146841
...
...
@@ -6,65 +6,4 @@ Graal is a dynamic compiler that is used to generate efficient machine code from
FastR is an open-source effort of Purdue University, Johannes Kepler University Linz, and Oracle Labs.
## Quick Start
To build and run FastR, you need a
[
recent JDK
](
http://www.oracle.com/technetwork/java/javase/downloads/index.html
)
and a C/C++ compiler tool chain.
You also need to use the
`mx`
build tool, which is used in all projects built around Graal.
`mx`
requires Python 2.7.
1.
Clone
`mx`
(version 2):
`hg clone https://hg.java.net/hg/mxtool2~code mxtool`
2.
Append the
`mxtool`
directory to your
`PATH`
.
FastR requires Graal.
Both projects are hosted in different repositories.
To obtain both, use the split-repository support in
`mx`
:
1.
Create a directory, e.g.,
`r`
, that serves as the project root.
2.
In the project root, issue
`mx sclone https://bitbucket.org/allr/fastr`
. This will clone both the FastR and Graal repositories.
After this, you should find two directories called
`fastr`
and
`graal`
in the project root.
`mx`
manages projects in "suites".
For each project, there is a primary suite, which in this case is FastR.
To build a project and the projects it depends on, the
`mx build`
command is used:
1.
Move to the primary suite directory:
`cd fastr`
2.
Build Graal and FastR:
`mx build`
When building for the first time, the build script will prompt you for a VM configuration to build.
In general, choosing the
`server`
configuration is advised.
For details, see
`README_GRAAL.txt`
in the
`graal`
subdirectory of the project root.
The first build will also download various required libraries, so there should be a network connection.
If you are behind a firewall, make sure that you have the 'http_proxy' environment variable set appropriately.
After building, running the FastR console is done with
`mx r`
or 'mx R'.
FastR supports the same command line arguments as R, so running an R script is done with
`mx R -f <file>`
.
However, many of the command line options are not yet implemented.
## IDE Usage
For IDE usage instructions, see the
[
corresponding page
](
https://wiki.openjdk.java.net/display/Graal/Eclipse
)
on the Graal wiki.
## Completeness
FastR is a work in progress: please expect many rough edges and non-working language features.
The tests in the
`com.oracle.truffle.r.test`
project can give you an idea of what is currently supported.
## Contributing
We would like to grow the FastR open-source community to provide a free R implementation atop the Truffle/Graal stack.
We encourage contributions, and invite interested developers to join in.
Prospective contributors need to sign the
[
Oracle Contributor Agreement (OCA)
](
http://www.oracle.com/technetwork/community/oca-486395.html
)
.
## Contact
Please direct questions and comments to the
[
FastR mailing list
](
<
<TBD
>
>).
## Authors
*
Purdue University: Tomas Kalibera, Petr Maj, Jan Vitek
*
Johannes Kepler University Linz: Christian Humer, Andreas Woess
*
Oracle Labs: Michael Haupt, Mick Jordan, Adam Welc, Christian Wirth, Thomas Wuerthinger
For more details and instructions for downloading and building the system, please visit the
[
FastR Wiki
](
https://bitbucket.org/allr/fastr/wiki/Home
)
.
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment