bel 0.3.0.beta1-x86-mingw32

data/INSTALL.md

@@ -0,0 +1,19 @@
+Install
+=======
+
+This library requires [Ruby](https://www.ruby-lang.org) (**>= 1.9.2**).  See [how to install ruby](https://github.com/OpenBEL/bel.rb/blob/master/INSTALL_RUBY.md).
+
+Install from [RubyGems.org](http://rubygems.org/gems/bel)
+
+```bash
+    gem install bel
+```
+
+Build from master branch
+
+1. Obtain source for master branch.
+  - `git clone git@github.com:OpenBEL/bel.rb.git`
+
+2. Build
+  - `gem build bel.gemspec`
+  - `gem install bel-[VERSION].gem`

data/INSTALL_RUBY.md

@@ -0,0 +1,107 @@
+# Install Ruby
+
+
+## Install Ruby (Windows)
+
+1. Download [RubyInstaller](http://rubyinstaller.org/downloads).
+   * Versions 1.9.3 and 2.x.x are supported.
+2. Install RubyInstaller version.
+   * Enable the _Add Ruby executables to your PATH_ option presented during installation.
+3. Open a command prompt (Windows Key + R then type `cmd`).
+   * Confirm installation by typing `ruby -v`.
+   * The output should show the ruby version (e.g. `ruby 2.0.0p451 (2014-02-24) [x64-mingw32]`).
+
+Continue with <a href="#install_bel_gem">Install the bel gem</a>.
+
+## Install Ruby (Mac OSX)
+
+_Option 1: Homebrew_
+
+1. Install with homebrew by typing `brew install ruby`.
+2. Add ruby commands to your PATH.
+   * Add to .bash_profile.
+     * `echo 'export PATH="/usr/local/Cellar/ruby/VERSION/bin:$PATH"' >> .bash_profile`
+   * Update environment by sourcing .bash_profile.
+     * `source ~/.bash_profile`
+3. Confirm installation by typing `ruby -v`.
+
+_Option 2: rbenv_
+
+* _Install with homebrew._
+   * `brew update`
+   * `brew install rbenv ruby-build`
+   * More details [here] (https://github.com/sstephenson/rbenv#homebrew-on-mac-os-x).
+
+* _Install with git._
+   * Clone rbenv repository.
+     * `git clone https://github.com/sstephenson/rbenv.git ~/.rbenv`
+   * Add to .bash_profile.
+     * `echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile`
+   * Enable shims and autocompletion from the terminal.
+     * `echo 'eval "$(rbenv init -)"' >> ~/.bash_profile`
+   * Clone ruby-build repository.
+     * `git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build`
+   * More details [here] (https://github.com/sstephenson/rbenv#installation).
+
+Continue with <a href="#install_bel_gem">Install the bel gem</a>.
+
+## Install Ruby (Linux)
+
+_Option 1: Install via package manager._
+
+* Example installation with Ubuntu.
+   * Type `sudo apt-get install ruby` in the terminal.
+
+_Option 2: rbenv_
+
+* _Install with git._
+   * Clone rbenv repository.
+     * `git clone https://github.com/sstephenson/rbenv.git ~/.rbenv`
+   * Add to .bash_profile.
+     * `echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile`
+   * Enable shims and autocompletion from the terminal.
+     * `echo 'eval "$(rbenv init -)"' >> ~/.bash_profile`
+   * Clone ruby-build repository.
+     * `git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build`
+   * More details [here] (https://github.com/sstephenson/rbenv#installation).
+
+Continue with <a href="#install_bel_gem">Install the bel gem</a>.
+
+<br><br>
+<div id="install_bel_gem"></div>
+## Install the _bel_ gem
+
+1. Open a terminal or command prompt.
+2. Use the `gem` command to install the `bel` gem.
+   * `gem install bel`
+3. You should see the following:
+
+<pre>
+    Fetching: bel-0.2.1.gem (100%)
+    Successfully installed bel-0.2.1
+    Parsing documentation for bel-0.2.1
+    Installing ri documentation for bel-0.2.1
+    1 gem installed
+</pre>
+4. Confirm you can access the `bel_upgrade` command.
+5. Continue with <a href="#upgrading_bel">Upgrading BEL</a>.
+
+<br><br>
+<div id="upgrading_bel"></div>
+## Upgrading BEL
+
+1. Type `bel_upgrade --help` for option details.
+2. Run command
+   * Example 1 - convert a BEL file
+     * `bel_upgrade --bel small_corpus.bel --changelog "http://resource.belframework.org/belframework/20131211/change_log.json"
+   * Example 2 - convert BEL from standard in
+     * `curl "http://resource.belframework.org/belframework/1.0/knowledge/small_corpus.bel" | bel_upgrade --changelog "http://resource.belframework.org/belframework/20131211/change_log.json"`
+   * More details [here] (https://github.com/OpenBEL/bel.rb).
+3. The upgraded BEL will be written to standard out.  Simply redirect to a file after that.
+   * `bel_upgrade ... > upgraded-version.bel`
+
+<br><br>
+## Issues
+
+* If you have questions with `bel_upgrade` or the `bel` gem please post to the [openbel-discuss] (https://groups.google.com/forum/#!forum/openbel-discuss) google group.
+* If you encounter errors please post an issue to [github issues] (https://github.com/OpenBEL/bel.rb/issues).

data/LICENSE

@@ -0,0 +1,191 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether by
+contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including
+but not limited to software source code, documentation source, and configuration
+files.
+
+"Object" form shall mean any form resulting from mechanical transformation or
+translation of a Source form, including but not limited to compiled object code,
+generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made
+available under the License, as indicated by a copyright notice that is included
+in or attached to the work (an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that
+is based on (or derived from) the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship. For the purposes of this License, Derivative Works
+shall not include works that remain separable from, or merely link (or bind by
+name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version
+of the Work and any modifications or additions to that Work or Derivative Works
+thereof, that is intentionally submitted to Licensor for inclusion in the Work
+by the copyright owner or by an individual or Legal Entity authorized to submit
+on behalf of the copyright owner. For the purposes of this definition,
+"submitted" means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems, and
+issue tracking systems that are managed by, or on behalf of, the Licensor for
+the purpose of discussing and improving the Work, but excluding communication
+that is conspicuously marked or otherwise designated in writing by the copyright
+owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License.
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the Work and such
+Derivative Works in Source or Object form.
+
+3. Grant of Patent License.
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable (except as stated in this section) patent license to make, have
+made, use, offer to sell, sell, import, and otherwise transfer the Work, where
+such license applies only to those patent claims licensable by such Contributor
+that are necessarily infringed by their Contribution(s) alone or by combination
+of their Contribution(s) with the Work to which such Contribution(s) was
+submitted. If You institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work or a
+Contribution incorporated within the Work constitutes direct or contributory
+patent infringement, then any patent licenses granted to You under this License
+for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution.
+
+You may reproduce and distribute copies of the Work or Derivative Works thereof
+in any medium, with or without modifications, and in Source or Object form,
+provided that You meet the following conditions:
+
+You must give any other recipients of the Work or Derivative Works a copy of
+this License; and
+You must cause any modified files to carry prominent notices stating that You
+changed the files; and
+You must retain, in the Source form of any Derivative Works that You distribute,
+all copyright, patent, trademark, and attribution notices from the Source form
+of the Work, excluding those notices that do not pertain to any part of the
+Derivative Works; and
+If the Work includes a "NOTICE" text file as part of its distribution, then any
+Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file, excluding those notices
+that do not pertain to any part of the Derivative Works, in at least one of the
+following places: within a NOTICE text file distributed as part of the
+Derivative Works; within the Source form or documentation, if provided along
+with the Derivative Works; or, within a display generated by the Derivative
+Works, if and wherever such third-party notices normally appear. The contents of
+the NOTICE file are for informational purposes only and do not modify the
+License. You may add Your own attribution notices within Derivative Works that
+You distribute, alongside or as an addendum to the NOTICE text from the Work,
+provided that such additional attribution notices cannot be construed as
+modifying the License.
+You may add Your own copyright statement to Your modifications and may provide
+additional or different license terms and conditions for use, reproduction, or
+distribution of Your modifications, or for any such Derivative Works as a whole,
+provided Your use, reproduction, and distribution of the Work otherwise complies
+with the conditions stated in this License.
+
+5. Submission of Contributions.
+
+Unless You explicitly state otherwise, any Contribution intentionally submitted
+for inclusion in the Work by You to the Licensor shall be under the terms and
+conditions of this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify the terms of
+any separate license agreement you may have executed with Licensor regarding
+such Contributions.
+
+6. Trademarks.
+
+This License does not grant permission to use the trade names, trademarks,
+service marks, or product names of the Licensor, except as required for
+reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty.
+
+Unless required by applicable law or agreed to in writing, Licensor provides the
+Work (and each Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied,
+including, without limitation, any warranties or conditions of TITLE,
+NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are
+solely responsible for determining the appropriateness of using or
+redistributing the Work and assume any risks associated with Your exercise of
+permissions under this License.
+
+8. Limitation of Liability.
+
+In no event and under no legal theory, whether in tort (including negligence),
+contract, or otherwise, unless required by applicable law (such as deliberate
+and grossly negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special, incidental,
+or consequential damages of any character arising as a result of this License or
+out of the use or inability to use the Work (including but not limited to
+damages for loss of goodwill, work stoppage, computer failure or malfunction, or
+any and all other commercial damages or losses), even if such Contributor has
+been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability.
+
+While redistributing the Work or Derivative Works thereof, You may choose to
+offer, and charge a fee for, acceptance of support, warranty, indemnity, or
+other liability obligations and/or rights consistent with this License. However,
+in accepting such obligations, You may act only on Your own behalf and on Your
+sole responsibility, not on behalf of any other Contributor, and only if You
+agree to indemnify, defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason of your
+accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work
+
+To apply the Apache License to your work, attach the following boilerplate
+notice, with the fields enclosed by brackets "[]" replaced with your own
+identifying information. (Don't include the brackets!) The text should be
+enclosed in the appropriate comment syntax for the file format. We also
+recommend that a file or class name and description of purpose be included on
+the same "printed page" as the copyright notice for easier identification within
+third-party archives.
+
+   Copyright 2013 OpenBEL Consortium
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1,319 @@
+bel ruby
+========
+
+[![Gem Version](https://badge.fury.io/rb/bel.svg)](http://badge.fury.io/rb/bel)
+
+The bel ruby gem allows the reading, writing, and processing of BEL (Biological Expression Language) with a natural DSL.
+
+Learn more on [BEL](http://www.openbel.org/content/bel-lang-language).
+
+License: [Apache License, Version 2.0](http://opensource.org/licenses/Apache-2.0)
+
+Dependencies
+
+- Required
+
+    - Ruby 1.9.2 or greater ([how to install ruby](INSTALL_RUBY.md))
+
+- Optional
+
+    - *rdf gem*, *addressable gem*, and *uuid gem* for RDF conversion
+    - *rdf-turtle gem* for serializing to RDF turtle format
+
+Install / Build: See [INSTALL](INSTALL.md).
+
+branches
+--------
+
+- master branch
+  - [![Travis CI Build](https://travis-ci.org/OpenBEL/bel.rb.svg?branch=master)](https://travis-ci.org/OpenBEL/bel.rb)
+
+- next branch
+  - [![Build Status for next branch](https://travis-ci.org/OpenBEL/bel.rb.svg?branch=next)](https://travis-ci.org/OpenBEL/bel.rb)
+
+
+executable commands
+-------------------
+
+**bel_upgrade**: Upgrade namespaces in BEL content to another version (i.e. *1.0* to *20131211*)
+
+```bash
+
+    # using BEL file and change log JSON file
+    bel_upgrade --bel small_corpus.bel --changelog change_log.json
+
+    # using BEL file and change log from a URL
+    bel_upgrade --bel small_corpus.bel --changelog http://resource.belframework.org/belframework/20131211/change_log.json
+
+    # using BEL from STDIN and change log from a URL
+    cat small_corpus.bel | bel_upgrade --changelog http://resource.belframework.org/belframework/20131211/change_log.json
+```
+
+**bel_upgrade_term**: Upgrade BEL terms to another version (e.g. *1.0* to *20131211*)
+
+```bash
+
+    # using BEL terms and change log JSON file
+    bel_upgrade_term -t "p(HGNC:A2LD1)\np(EGID:84)\n" -n "1.0" -c change_log.json
+
+    # using BEL terms and change log from a URL
+    bel_upgrade_term -t "p(HGNC:A2LD1)\np(EGID:84)\n" -n "1.0" -c http://resource.belframework.org/belframework/20131211/change_log.json
+
+    # using BEL from STDIN
+    echo -e "p(EGID:84)\np(HGNC:A2LD1)" | bel_upgrade_term -n "1.0" -c change_log.json
+    cat terms.bel | bel_upgrade_term -n "1.0" -c change_log.json
+```
+
+**bel_rdfschema**: Dumps the RDF Schema triples for BEL.
+
+```bash
+
+    # dumps schema in ntriples format (default)
+    bel_rdfschema
+
+    # dumps schema in turtle format
+    # note: requires the 'rdf-turtle' gem
+    bel_rdfschema --format turtle
+```
+
+**bel2rdf**: Converts BEL to RDF.
+
+```bash
+
+    # dumps RDF to standard out in ntriples format (default)
+    #   (from file)
+    bel2rdf --bel small_corpus.bel
+
+    #   (from standard in)
+    cat small_corpus.bel | bel2rdf
+
+    # dumps RDF to standard out in turtle format
+    #   (from file)
+    bel2rdf --bel small_corpus.bel --format turtle
+
+    #   (from standard in)
+    cat small_corpus.bel | bel2rdf --format turtle
+```
+
+**bel_parse**: Show parsed objects from BEL content for debugging purposes
+
+```bash
+
+    # ...from file
+    bel_parse --bel small_corpus.bel
+
+    # ...from standard in
+    cat small_corpus.bel | bel_parse
+```
+
+api examples
+------------
+
+**Use OpenBEL namespaces from the latest release.**
+
+```ruby
+
+    require 'bel'
+  
+    # reference namespace value using standard prefixes (HGNC, MGI, RGD, etc.)
+    HGNC['AKT1']
+    => #<BEL::Language::Parameter:0x00000004df5bc0
+      @enc=:GRP,
+      @ns_def="BEL::Namespace::HGNC",
+      @value=:AKT1>
+```
+
+**Load your own namespace**
+
+```ruby
+
+    require 'bel'
+
+    # define a NamespaceDefinition with prefix symbol and url
+    PUBCHEM = NamespaceDefinition.new(:PUBCHEM, 'http://your-url.org/pubchem.belns')
+
+    # reference caffeine compound, sip, and enjoy
+    PUBCHEM['2519']
+```
+
+**Load namespaces from a published OpenBEL version**
+
+```ruby
+
+    require 'bel'
+
+    ResourceIndex.openbel_published_index('1.0').namespaces.find { |x| x.prefix == :HGU133P2 }
+    ResourceIndex.openbel_published_index('20131211').namespaces.find { |x| x.prefix == :AFFX }
+    ResourceIndex.openbel_published_index('latest-release').namespaces.find { |x| x.prefix == :AFFX }
+```
+
+**Load namespaces from a custom resource index**
+
+```ruby
+
+    require 'bel'
+
+    ResourceIndex.new('/home/bel/index.xml').namespaces.map(&:prefix)
+    => ["AFFX", "CHEBIID", "CHEBI", "DOID", "DO", "EGID", "GOBPID", "GOBP",
+        "GOCCID", "GOCC", "HGNC", "MESHPP", "MESHCS", "MESHD", "MGI", "RGD",
+        "SCHEM", "SDIS", "SFAM", "SCOMP", "SPAC", "SP"]
+```
+
+**Validate BEL parameters**
+
+```ruby
+
+    require 'bel'
+
+    # AKT1 contained within HGNC NamespaceDefinition
+    HGNC[:AKT1].valid?
+    => true
+
+    # not_in_namespace is not contained with HGNC NamespaceDefinition
+    HGNC[:not_in_namespace].valid?
+    => false
+
+    # namespace is nil so :some_value MAY exist
+    Parameter.new(nil, :some_value).valid?
+    => true
+```
+
+**Validate BEL terms**
+
+```ruby
+
+    require 'bel'
+
+    tscript(g(HGNC['AKT1'])).valid?
+    => false
+    tscript(g(HGNC['AKT1'])).valid_signatures
+    => []
+    tscript(g(HGNC['AKT1'])).invalid_signatures.map(&:to_s)
+    => ["tscript(F:complex)a", "tscript(F:p)a"]
+
+    tscript(p(HGNC['AKT1'])).valid?
+    => true
+    tscript(p(HGNC['AKT1'])).valid_signatures.map(&:to_s)
+    => ["tscript(F:p)a"]
+    tscript(p(HGNC['AKT1'])).invalid_signatures.map(&:to_s)
+    => ["tscript(F:complex)a"]
+```
+
+**Write BEL in Ruby with a DSL**
+
+```ruby
+
+    require 'bel'
+    
+    # create BEL statements
+    p(HGNC['SKIL']).directlyDecreases tscript(p(HGNC['SMAD3']))
+    bp(GO['response to hypoxia']).increases tscript(p(EGID['7157']))
+```
+
+**Parse BEL input**
+
+```ruby
+
+    require 'bel'
+
+    # example BEL document
+    BEL_SCRIPT = <<-EOF
+    SET DOCUMENT Name = "Spec"
+    SET DOCUMENT Authors = User
+    SET Disease = "Atherosclerosis"
+    path(MESHD:Atherosclerosis)
+    path(Atherosclerosis)
+    bp(GO:"lipid oxidation")
+    p(MGI:Mapkap1) -> p(MGI:Akt1,pmod(P,S,473))
+    path(MESHD:Atherosclerosis) => bp(GO:"lipid oxidation")
+    path(MESHD:Atherosclerosis) =| (p(HGNC:MYC) -> bp(GO:"apoptotic process"))
+    EOF
+
+    # BEL::Script.parse returns BEL::Script::Parser
+    BEL::Script.parse('tscript(p(HGNC:AKT1))')
+    => #<BEL::Script::Parser:0x007f179261d270>
+
+    # BEL::Script::Parser is Enumerable so we can analyze as we parse
+    #   for example: count all function types into a hash
+    BEL::Script.parse('tscript(p(HGNC:AKT1))', {HGNC: HGNC}).find_all { |obj|
+      obj.is_a? Term
+    }.map { |term|
+      term.fx  
+    }.reduce(Hash.new {|h,k| h[k] = 0}) { |result, function|  
+      result[function.short_form] += 1  
+      result
+    }
+    => {:p=>1, :tscript=>1} 
+
+    # parse; yield each parsed object to the block
+    namespace_mapping = {GO: GOBP, HGNC: HGNC, MGI: MGI, MESHD: MESHD}
+    BEL::Script.parse(BEL_SCRIPT, namespace_mapping) do |obj|
+      puts "#{obj.class} #{obj}"  
+    end
+    => BEL::Script::DocumentProperty: SET DOCUMENT Name = "Spec"
+    => BEL::Script::DocumentProperty: SET DOCUMENT Authors = "User"
+    => BEL::Script::Annotation: SET Disease = "Atherosclerosis"
+    => BEL::Script::Parameter: MESHD:Atherosclerosis
+    => BEL::Script::Term: path(MESHD:Atherosclerosis)
+    => BEL::Script::Statement: path(MESHD:Atherosclerosis)
+    => BEL::Script::Parameter: Atherosclerosis
+    => BEL::Script::Term: path(Atherosclerosis)
+    => BEL::Script::Statement: path(Atherosclerosis)
+    => BEL::Script::Parameter: GO:"lipid oxidation"
+    => BEL::Script::Term: bp(GO:"lipid oxidation")
+    => BEL::Script::Statement: bp(GO:"lipid oxidation")
+    => BEL::Script::Parameter: MGI:Mapkap1
+    => BEL::Script::Term: p(MGI:Mapkap1)
+    => BEL::Script::Parameter: MGI:Akt1
+    => BEL::Script::Parameter: P
+    => BEL::Script::Parameter: S
+    => BEL::Script::Parameter: 473
+    => BEL::Script::Term: p(MGI:Akt1,pmod(P,S,473))
+    => BEL::Script::Statement: p(MGI:Mapkap1) -> p(MGI:Akt1,pmod(P,S,473))
+    => BEL::Script::Parameter: MESHD:Atherosclerosis
+    => BEL::Script::Term: path(MESHD:Atherosclerosis)
+    => BEL::Script::Parameter: GO:"lipid oxidation"
+    => BEL::Script::Term: bp(GO:"lipid oxidation")
+    => BEL::Script::Statement: path(MESHD:Atherosclerosis) => bp(GO:"lipid oxidation")
+    => BEL::Script::Parameter: MESHD:Atherosclerosis
+    => BEL::Script::Term: path(MESHD:Atherosclerosis)
+    => BEL::Script::Parameter: HGNC:MYC
+    => BEL::Script::Term: p(HGNC:MYC)
+    => BEL::Script::Parameter: GO:"apoptotic process"
+    => BEL::Script::Term: bp(GO:"apoptotic process")
+    => BEL::Script::Statement: path(MESHD:Atherosclerosis) =| (p(HGNC:MYC) -> bp(GO:"apoptotic process"))
+```
+
+**Iteratively parse BEL from file-like object**
+
+```ruby
+
+    require 'bel'
+    BEL::Script.parse(File.open('/home/user/small_corpus.bel')).find_all { |obj|
+      obj.is_a? Statement
+    }.to_a.size
+```
+
+**Parse BEL and convert to RDF (requires the *rdf*, *addressable*, and *uuid* gems)**
+
+```ruby
+
+    require 'bel'
+    parser = BEL::Script::Parser.new
+
+    rdf_statements = []
+
+    # parse term
+    parser.parse('p(HGNC:AKT1)') do |obj|
+      if obj.is_a? BEL::Language::Term  
+        rdf_statements += obj.to_rdf
+      end  
+    end
+
+    # parse statement
+    parser.parse("p(HGNC:AKT1) => tscript(g(HGNC:TNF))\n") do |obj|
+      if obj.is_a? BEL::Language::Statement
+        rdf_statements += obj.to_rdf
+      end  
+    end
+```