Permalink
Browse files

Add lgpl-3.0.txt. Removed the sys.path from demo scripts.

  • Loading branch information...
1 parent 5f70f4f commit c5190f5b34e733257e3ffc3be671de1f540d0ddb @jacobjoaquin committed Jul 23, 2009
Showing with 174 additions and 4,240 deletions.
  1. +1 −0 MANIFEST
  2. +7 −6 _doc_source/Makefile
  3. BIN _doc_source/build/doctrees/bugs.doctree
  4. BIN _doc_source/build/doctrees/commandline.doctree
  5. BIN _doc_source/build/doctrees/csd_sco_event.doctree
  6. BIN _doc_source/build/doctrees/demo/index.doctree
  7. BIN _doc_source/build/doctrees/environment.pickle
  8. BIN _doc_source/build/doctrees/glossary.doctree
  9. BIN _doc_source/build/doctrees/index.doctree
  10. +0 −4 _doc_source/build/html/.buildinfo
  11. +0 −44 _doc_source/build/html/_sources/bugs.txt
  12. +0 −46 _doc_source/build/html/_sources/commandline.txt
  13. +0 −38 _doc_source/build/html/_sources/csd_sco_event.txt
  14. +0 −56 _doc_source/build/html/_sources/demo/index.txt
  15. +0 −150 _doc_source/build/html/_sources/glossary.txt
  16. +0 −79 _doc_source/build/html/_sources/index.txt
  17. +0 −405 _doc_source/build/html/_static/basic.css
  18. +0 −210 _doc_source/build/html/_static/default.css
  19. +0 −232 _doc_source/build/html/_static/doctools.js
  20. BIN _doc_source/build/html/_static/file.png
  21. +0 −32 _doc_source/build/html/_static/jquery.js
  22. BIN _doc_source/build/html/_static/minus.png
  23. BIN _doc_source/build/html/_static/plus.png
  24. +0 −61 _doc_source/build/html/_static/pygments.css
  25. +0 −467 _doc_source/build/html/_static/searchtools.js
  26. +0 −165 _doc_source/build/html/bugs.html
  27. +0 −156 _doc_source/build/html/commandline.html
  28. +0 −576 _doc_source/build/html/csd_sco_event.html
  29. +0 −464 _doc_source/build/html/demo/index.html
  30. +0 −308 _doc_source/build/html/genindex.html
  31. +0 −230 _doc_source/build/html/glossary.html
  32. +0 −196 _doc_source/build/html/index.html
  33. +0 −154 _doc_source/build/html/modindex.html
  34. +0 −46 _doc_source/build/html/objects.inv
  35. +0 −97 _doc_source/build/html/search.html
  36. +0 −1 _doc_source/build/html/searchindex.js
  37. +1 −1 demo/carry.py
  38. +0 −1 demo/pfunc.py
  39. +0 −1 demo/s_spacer.py
  40. +0 −1 demo/sco_align.py
  41. +0 −1 demo/score_from_csd.py
  42. +0 −1 demo/swap_columns.py
  43. +0 −9 demo/swap_pan_position.sco
  44. BIN dist/csd-0.0.3.1.tar.gz
  45. +165 −0 lgpl-3.0.txt
  46. +0 −2 setup.py
View
@@ -22,6 +22,7 @@ demo/score_from_csd.py
demo/swap_columns.py
demo/swap_columns.sco
demo/swap_pan_position.sco
+docs/.DS_Store
docs/.buildinfo
docs/bugs.html
docs/commandline.html
View
@@ -11,11 +11,12 @@ PAPEROPT_a4 = -D latex_paper_size=a4
PAPEROPT_letter = -D latex_paper_size=letter
ALLSPHINXOPTS = -d build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
-.PHONY: help clean html dirhtml pickle json htmlhelp qthelp latex changes linkcheck doctest
+.PHONY: help clean html htmlbuild dirhtml pickle json htmlhelp qthelp latex changes linkcheck doctest
help:
@echo "Please use \`make <target>' where <target> is one of"
@echo " html to make standalone HTML files"
+ @echo " htmlbuild to make standalone HTML files in build/"
@echo " dirhtml to make HTML files named index.html in directories"
@echo " pickle to make pickle files"
@echo " json to make JSON files"
@@ -30,15 +31,15 @@ clean:
-rm -rf build/*
html:
- $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) build/html
- @echo
- @echo "Build finished. The HTML pages are in build/html."
-
-html_docs:
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) ../docs
@echo
@echo "Build finished. The HTML pages are in docs/."
+htmlbuild:
+ $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) build/html
+ @echo
+ @echo "Build finished. The HTML pages are in build/html."
+
dirhtml:
$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) build/dirhtml
@echo
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -1,4 +0,0 @@
-# Sphinx build info version 1
-# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: ae7f6641b04fca639aeeac756a41c814
-tags: fbb0d17656682115ca4d033fb2f83ba1
@@ -1,44 +0,0 @@
-Bugs
-=====
-
-* In some of the test scores, there are some score string examples using
- single quotes. Single quotes are not supported by the score.
-
-* Test-cases need to be written for demos.
-
-* Jython 2.5 fails some tests.
-
-* The python interpreter didn't like passing a selection generated with
- csd.sco.select_all() to csd.sco.operate_numeric().
-
-Planned Changes
-===============
-
-* Error checking, exceptions, and warnings - *Oh my!!*
-* Need to get an online repository. At least a somewhat official site.
-* Need to make auto-installation happen. Eggs?
-* Tutorials on how to build custom scripts using this package.
-* Spell check docs.
-* Elements become atoms?
-* Need a better name than pf_function.
-* Need to use better names for pfield and pfield_list, as some of the
- terms currently trip over each other. pfield, pfield_index,
- pfield_index_list, etc...
-* When dealing with dicts, make sure they are sorted. Had an issue with
- csd.sco.operate_numeric().
-* selection functions needs a contracterual flow.
-
- When a function receives a selection, a value in a key_index may
- contain multiple lines, and thus, the receiving function must
- operate on it.
-
- The value should be treated as a value_score. A string containing
- one or more events. Thus, it should be split.
-
- After the split, it can be processed.
-
- Before replacing the orignal value_score, the split needs to be
- joined, creating a single string, with newlines as evenet
- delimiters.
-
-
@@ -1,46 +0,0 @@
-Command-line Operations
-=======================
-
-Pasteboard Trick (for OS X)
----------------------------
-
-OS X comes with two commands that can easily aid in the process of
-using these demo scripts in your work flow: ``pbpaste`` and ``pbcopy``.
-These paste and copy the contents of the pasteboard in the OS X
-Terminal.
-
-To use in a workflow, highlight a section of score you want to process,
-copy the selection, type the following into the Terminal::
-
- $ pbpaste | ./align.py | pbcopy
-
-Go back to your text editor, and with the section of score code still
-highlighted, paste. The highlighted test will be replaced with your
-newly processed score.
-
-Pipe Chain Trick
-----------------
-
-It is possible to chain pipes in series to process scores with
-multiple scripts in one swoop. The following command does two things.
-First, it sums the values of pfields 4 in instrument 2 events with
-0.99999 with sum.py. The output is then piped into align.py, making
-the columns tidy and neat::
-
- $ cat arpeggiator.sco | ./arpeggiator.py -si -i1 -p4 -v'0.1 0.444 0.9922' | ./sco_align.py
-
-
-.. highlight:: none
-
-Arpeggiated and aligned::
-
- i 1 0 0.25 0.1 7.00
- i 1 + . 0.444 .
- i 1 + . 0.9922 .
- i 1 + . 0.1 .
- i 1 + . 0.444 .
- i 1 + . 0.9922 .
- i 1 + . 0.1 .
- i 1 + . 0.444 .
-
-
@@ -1,38 +0,0 @@
-###############
-The csd Package
-###############
-
-csd
----
-
-.. automodule:: csd
- :members:
-
-sco
----
-
-.. automodule:: csd.sco
- :members:
-
-event
------
-
-The event module parses single score events. In almost all cases,
-when you are parsing an event, you are dealing with score elements,
-such as pfield data, comments and whitespace.
-
-.. automodule:: csd.sco.event
- :members:
-
-element
--------
-
-.. automodule:: csd.sco.element
- :members:
-
-selection
----------
-
-.. automodule:: csd.sco.selection
- :members:
-
@@ -1,56 +0,0 @@
-#####
-Demos
-#####
-
-These are examples of what can be built with the score module.
-
-Demo scripts are located in ``/demo/``.
-
-.. note:: Demos have only been tested using Apple's
- Python 2.5.1. Further testing will need to be done in other
- versions of Python.
-
-.. warning:: These are to be considered unstable releases until they
- are properly tested and bug checked.
-
-arpeggiator
------------
-
-.. automodule:: arpeggiator
- :members:
-
-carry
------
-
-.. automodule:: carry
- :members:
-
-pfunc
------
-
-.. automodule:: pfunc
- :members:
-
-s_spacer
----------------
-
-.. automodule:: s_spacer
- :members:
-
-sco_align
----------
-
-.. automodule:: sco_align
- :members:
-
-score_from_csd
---------------
-.. automodule:: score_from_csd
- :members:
-
-swap_columns
-------------
-
-.. automodule:: swap_columns
- :members:
-
@@ -1,150 +0,0 @@
-.. _glossary:
-
-Glossary
-========
-
-.. glossary::
-
- csd
- #. A Csound unified file format that combines a Csound orc file
- and a Csound sco file into a single document.
-
- #. This package.
-
- #. In context of a function parameter, csd is a string that
- contains the contents of a Csound unified file.
-
- #. The top level module in the csd package.
-
- element
- Any :term:`event` data. Can be numeric, an expression, macro,
- string, comment, a continuous block of space, carry, etc.
-
- event
- A single :term:`score` event. e.g. ``i 1 0 4 1.0 440 ; A440``.
-
- expression
- A Csound score expression, which is containted within brackets.
- e.g. ``[~ * 440 + 440]``
-
- identifier
- The unique name of index that indicates a specific instrument or
- f-table, and immediately proceeds a :term:`statement`. For example,
- ``33`` is the identifier in ``i 33 0 11``.
-
- literal
- A literal is any valid :term:`pfield data type`, such as:
- :term:`numeric`, :term:`expression`, macro, string, or
- preprocessor symbol.
-
- numeric
- A number. Csound does not distinguish between ints and
- floats. The term numeric refers to both.
-
- pattern
- A pattern is a python dict that has been repurposed to describe
- the conditions for matching against an :term:`event`.
-
- Pattern syntax::
-
- {pfield_index: ((string | numeric) | [(string | numeric), *]), *}
-
- The format is very precise, and must follow strict rules. The
- key is an integer that refers to the index of a pfield. The
- value is either a string, :term:`numeric`, or a list of strings
- and numbers. The values are used to compare against a
- :term:`pfield data type` from within an event.
-
- This system only works with pfield data types. Whitespace and
- comments are not recognized. If matching against a numeric
- type, the pattern matcher does distinguish between an integer
- and a floating point number. i.e. 440 is not 440.0.
-
- Pattern examples::
-
- {0: 'i'} # All i-events
- {0: 'f'} # All f-tables
- {0: ['i', 'f']} # All i-events and f-tables
- {0: 'i', 1: 33} # All i-events for instr 33
- {0: 'i', 1: range(5, 11)) # All i-events for instrs 5 through 10
- {5: 440} # Events that contains 440 in pfield 5
-
- pfunction
- A function for operating on pfield values used in conjuction
- with csd.sco.operate_numeric. or csd.sco.map_().
-
- The first argument ``x`` is required, and is used as the pfield
- value in the function. A pfunction supports any number of
- additional optional arguments.
-
- Example::
-
- def multiply(x, y):
- return x * y
-
- print csd.sco.map_(score, {0: 'i'}, 5, multiply, 3.0)
-
- pfield
- A pfield, or parameter field, refers to a value as part of a
- :term:`event`.
-
- pfield data type
- Includes: :term:`statement`, :term:`numeric`, macro,
- :term:`expression`, string, and preprocessor symbols.
-
- pfield_list
- A pfield_list is either a single pfield value or a list of
- pfield values.
-
- i.e. value, [value], or [value, value, ...].
-
- A pfield_list does not support a recursive list structure, i.e
- as [value, [value]].
-
- selection
- A selection is a :term:`score` reformatted into a repurposed
- python dict that stores collected :term:`event` strings with
- their respective indexes.
-
- Selection syntax::
-
- {event_index: (event | [event, *]), *}
-
- The purpose of a selection is to be able to pull specific events
- from a :term:`score` and for processing.
-
- Selections are created with the select functions in csd.sco.
- Once they are processed, they must be recombined with the
- original score with the merge function.
-
- score
- #. The part of a Csound program that controls and plays a
- Csound orchestra.
-
- #. In context of a function, a score is a string of Csound
- score events.
-
- statement
- A statement is Csound score command that begins an active score
- :term:`event`.
-
- Statements include: (from the `Csound manual <http://www.csounds.com/manual/html/ScoreStatements.html>`_)
-
- * a - Advance score time by a specified amount
- * b - Resets the clock
- * e - Marks the end of the last section of the score
- * f - Causes a GEN subroutine to place values in a stored
- function table
- * i - Makes an instrument active at a specific time and for
- a certain duration
- * m - Sets a named mark in the score
- * n - Repeats a section
- * q - Used to quiet an instrument
- * r - Starts a repeated section
- * s - Marks the end of a section
- * t - Sets the tempo
- * v - Provides for locally variable time warping of score
- events
- * x - Skip the rest of the current section
-
-
Oops, something went wrong.

0 comments on commit c5190f5

Please sign in to comment.