abjad是一个用于形式化分数控制的python api。
Abjad的Python项目详细描述
#####
abjad
使用abjad创建任意分数中所有
音符、休止符、标杆、元组、梁和slur的符号表示。因为abjad
扩展了"python"编程语言,所以您可以在工作时使用abjad对音乐进行系统的更改。由于abjad包装了功能强大的lilypond音乐符号包,您可以使用abjad来控制页面上符号的排版细节。_ lilypond:http://lilypond.org/
。_巨蟒:http://www.python.org/
`github ` ` ` ` ` `pypi ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ci<;https://travis ci.org/abjad/abjad>;`
…_ github:https://github.com/abjad/abjad
。_ pypi:https://pypi.python.org/pypi/abjad
…图片::https://img.shields.io/travis/abjad/abjad/master.svg?style=flat square
:目标:https://travis ci.org/abjad/abjad
…图片::https://img.shields.io/covertalls/abjad/abjad/master.svg?style=flat square
:目标:https://coveralls.io/r/abjad/abjad
…图片::https://img.shields.io/pypi/v/abjad.svg?style=flat square
:目标:https://pypi.python.org/pypi/abjad
…图片::https://img.shields.io/pypi/dm/abjad.svg?style=flat square
:目标:https://pypi.python.org/pypi/abjad
安装
==
代码块::bash
~$sudo pip install abjad
**注意**:
如果您已经在虚拟环境中工作,只需省略
sudo`。
**注意**:
abjad支持python 3.6及更高版本。
`以及"pip":
…代码块::bash
~$git clone https://github.com/abjad/abjad.git
~$cd abjad
abjad$pip安装。
代码块::bash
~$python
python 3.6.5(v3.6.5:f59c0932b4,2018年3月28日,03:03:55)
[GCC 4.2.1(Apple Inc.Build 5666)(dot 3)]on darwin
键入"帮助"、"版权"、"信用"或"许可证"了解更多信息。
>;import abjad
>;>;abjad.\uuu版本
'3.0.0'
恭喜!
install lilypond
``````````````````
abjad使用"lilypond"这一开源自动雕刻引擎生成
符号输出。
abjad以最新版本的"lilypond"为目标。在撰写本文时,这意味着2.18-稳定或2.19-发展。我们建议直接从"lilypond"网站安装,而不是使用包管理器提供的"lilypond"版本,因为这些包通常已经过时。
通过运行以下命令测试lilypond是否可以从
命令行调用:
…代码块::bash
~$lilypond--version
版权所有(c)1996--2015 by
han wen nienhuys<;hanwen@xs4all.nl>;
jan nieuwenhuizen<;janneke@gnu.org>;
此程序是免费软件。它属于GNU通用
许可证的范围,在某些情况下,欢迎您更改和/或分发
许可证的副本。调用"lilypond--warranty"获取更多信息。
如果无法从命令行调用lilypond,则应将lilypond可执行文件的位置添加到"path"环境变量中。如果您使用osx,只需在终端中运行以下行:
…代码块::bash
export path="$path:/applications/lilypond.app/contents/resources/bin/"
可在osx下的命令行中找到,网址为http://www.lilypond.org/macos-x.html。
如果您是新使用命令行的用户,则应使用google
获得有关在shell中导航、编辑配置文件和设置环境变量的基本介绍。有更多的教程,我们无法计数!
安装graphviz(可选)
````````````````````````````````
abjad使用开源图形可视化库graphviz`,创建节奏树和其他树结构的图形,并为其文档创建类层次结构的可视化。用abjad创建符号不需要graphviz。
代码块::bash
~$sudo apt get install graphviz
代码块::bash
~$brew install graphviz
安装完"graphviz"后,通过运行以下命令从
命令行测试"graphviz"是否可调用:
。代码块:bash
~$dot-v
dot-graphviz版本2.38.0(20140413.2041)
abjad的api文档中的所有图形图像都是通过
`graphviz`创建的。请参见:py:func:`~abjad.top.graph`了解更多
详细信息。
安装扩展包
----
。代码块::bash
~$pip install abjad[book];文档工具
~$pip install abjad[cli];score package命令行工具
~$pip install abjad[ipython];ipython集成
~$pip install abjad[nauert];量化工具
~$pip安装abjad[rmakers]节奏生成器工具
~$pip安装abjad[tonality]音调分析工具
github存储库,并将其安装在
**编辑模式**及其**开发附件**:
…代码块::bash
~$git clone https://github.com/abjad/abjad.git
~$cd abjad
abjad$sudo pip install-e.[book,注意:在"install"之后字符串中没有空格
文档
-`pypdf2`,用于使用abjad的
``ajv book``工具对'latex``源代码执行预处理
sphinx``的一些依赖项提供可选的优化的'python`
扩展,这些扩展必须在使用之前编译。如果您的机器
没有可用的c编译器,则在运行``pip
install-e'.[development]``命令时可能会看到错误消息。这些警告是无害的,不会阻止依赖项的安装。
要在debian和ubuntu上安装c编译工具:
……代码块::bash
~$sudo apt get install build essential
要在OSX上安装C编译工具,我们建议只从Apple应用商店安装xcode
。或者,您可以通过"自制"安装,尽管这可能需要很长时间。
此外,还需要安装一些非"python"工具,以便开发abjad或构建abjad文档:"texlive"、"imagemagick",以及
`graphviz`(上面已经解释过了)。
install texlive
```````````````````
building the`latex``文档,running the test suite,并且使用abjad的
``ajv book``文档预处理工具需要'texlive`.
abjad使用'pdftex``来生成pdf,使用'pdfcrop``工具
来在debian和ubuntu上安装'texlive`:
代码块::bash
~$sudo apt get install texlive full
一组光栅图像处理工具。
代码块::bash
~$sudo apt get install imagemagick
代码块::bash
~$brew install imagemagick
安装"imagemagick"后,通过运行以下命令测试"imagemagick"是否可以从命令行中调用:
代码块::bash
~$convert--version
版本:imagemagick 6.9.1-6 q16 x86_64 2015-06-22 http://www.imagemagick.org
版权所有:copyright(c)1999-2015 imagemagick studio llc
许可证:http://www.imagemagick.org/script/license.php
功能:密码dpc模块
委托(内置):bzlib freetype jng jpeg ltdl lzma png tiff xml zlib
abjad和ipython
----
abjad可与"ipython"一起使用,将符号、图形和音频嵌入到
"ipython笔记本"中。要在"ipython"中使用abjad,请在安装abjad时同时使用其**开发**和**ipython**附加依赖项:
。代码块::bash
~$sudo pip install abjad[ipython]注意:在"install"之后字符串中没有空格
代码块::bash
~$apt get install timitity
代码块::bash
~$brew install timitity
安装完所有依赖项后,创建一个新的"ipython notebook"并在单元格中运行以下"magic"命令以加载abjad的"ipython"扩展名::
%load-ext abjadext.ipython
只要对有效的abjad对象使用"show(…)"和"play(…)",符号和midi文件就可以嵌入到笔记本中。
_虚拟环境:
虚拟环境允许
将"python"包与
包的系统全局集合隔离开来。它们还允许您安装不带"sudo"的python包。
"virtualenv"包提供了创建python虚拟环境的工具,
和"virtualenvwrapper"包提供了其他工具,这些工具使
使用虚拟环境变得异常简单。
让我们安装"virtualenvwrapper"
。代码块::bash
~$sudo pip安装virtualenvwrapper
…
**注意**:
在OSX 10.11(el capitan)上可能需要安装virtualenvwrapper``通过替代指令:
…代码块::bash
~$pip install virtualenvwrapper--忽略已安装的六个
请参见
`here<;http://stackoverflow.com/questions/32086631/cant-install-virtualenvwrapper-on-osx-10-11-el-capitan>;`\br/>了解详细信息。
在shell中设置一个环境变量,命名要存储的虚拟环境文件的目录,然后在该目录不存在时创建该目录:
。代码块::bash
~$export workn_home=~/.virtualenvs
~$mkdir-p$workn_home
**注意**:
因为您不太可能需要直接访问它们,所以我们建议在创建虚拟环境目录时使用"source"`virtualenvwrapper`.
脚本。这个脚本教您的shell如何创建、激活和删除
虚拟环境:
…代码块::bash
~$source`哪个virtualenvwrapper.sh`
最后,您可以通过``mkvirtualenv``命令创建一个虚拟环境。
这将创建一个新的环境并"激活"它。一旦激活,
您就可以在该环境中安装python包,这是安全的,因为您知道这些包不会干扰在您的
系统:
代码块::bash
~$mkvirtualenv abjad
…
~(abjad)$pip install abjad(abjad)"指示virtualenv的名称
…
或者通过"工作"命令切换到其他环境:
代码块::bash
~(abjad)$deactivate
~$work我的新分数
~(我的新分数)$
若要使虚拟环境配置从终端会话粘到终端会话,请将以下行添加到您的` ~/.profile`、
` `/.bash配置文件``或类似文件外壳配置文件:
…代码块::bash
export workun\u home=$home/.virtualenvs
source`哪个virtualenvwrapper.sh`
在虚拟环境中完成abjad的开发安装需要以下步骤:
-创建并激活新的虚拟环境
-将abjad克隆到某个位置,并将"cd"克隆到克隆存储库的根目录中
-安装abjad及其开发/ipython依赖关系
…代码块::bash
~$mkvirtualenv abjad
…
~(abjad)$git clone https://github.com/abjad/abjad.git
~(abjad)$cd abjad
abjad(abjad)$pip install-e.[development,ipython]注意:"."和"[开发",ipython]"
…
配置abjad
----
`~/.abjad``目录中,您将找到一个``abjad.cfg``文件。这是abjad
配置文件。您可以使用abjad配置文件告诉abjad关于您首选的pdf文件查看器midi player,lilypond语言等。
第一次打开abjad于2014年1月31日00:08:17创建的abjad配置文件时,您的配置文件将如下所示:
#设置为保存所有abjad生成的文件(如pdf和lilypond文件)的目录。
"英克卢de"在所有生成的*.ly文件中,
lilypond_includes=,
设置为覆盖动态查找。
lilypond路径=lilypond
midi播放器打开midi文件。
pdf文件。
pdf查看器=
http://en.wikipedia.org/wiki/ini_file.
在MacOS下,您可能需要将"MIDI播放器"设置为iTunes。在linux下,您可能希望将"pdf查看器"设置为"evince",将"midi播放器"设置为"timidity",依此类推。_ cpython:http://www.python.org
。_ github:https://github.com/abjad/abjad
。_ graphviz:http://graphviz.org/
。_自制:http://brew.sh/
…_ ipython笔记本:http://ipython.org/notebook.html
…_ ipython:http://ipython.org/
。_ imagemagick:http://www.imagemagick.org/script/index.php
。_乳胶:https://tug.org/
…_ lilypond:http://lilypond.org/
。_ mactex:https://tug.org/mactex/
。_ pypdf2:http://pythonhosted.org/pypdf2/
。_ pypi:https://pypi.python.org/pypi/abjad
。_ python:https://www.python.org/
。_斯芬克斯:http://sphinx doc.org/
。_ texlive:https://www.tug.org/texlive/
。_胆怯:http://timidity.sourceforge.net/
…_ PIP:https://pip.pypa.io/en/stable/
。_ pytest:http://pytest.org/latest/
。_ virtualenv:https://readthedocs.org/projects/virtualenv/
。_ virtualenvwrapper:https://virtualenvwrapper.readthedocs.org/en/latest/
abjad
使用abjad创建任意分数中所有
音符、休止符、标杆、元组、梁和slur的符号表示。因为abjad
扩展了"python"编程语言,所以您可以在工作时使用abjad对音乐进行系统的更改。由于abjad包装了功能强大的lilypond音乐符号包,您可以使用abjad来控制页面上符号的排版细节。_ lilypond:http://lilypond.org/
。_巨蟒:http://www.python.org/
`github ` ` ` ` ` `pypi ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ci<;https://travis ci.org/abjad/abjad>;`
…_ github:https://github.com/abjad/abjad
。_ pypi:https://pypi.python.org/pypi/abjad
…图片::https://img.shields.io/travis/abjad/abjad/master.svg?style=flat square
:目标:https://travis ci.org/abjad/abjad
…图片::https://img.shields.io/covertalls/abjad/abjad/master.svg?style=flat square
:目标:https://coveralls.io/r/abjad/abjad
…图片::https://img.shields.io/pypi/v/abjad.svg?style=flat square
:目标:https://pypi.python.org/pypi/abjad
…图片::https://img.shields.io/pypi/dm/abjad.svg?style=flat square
:目标:https://pypi.python.org/pypi/abjad
安装
==
代码块::bash
~$sudo pip install abjad
**注意**:
如果您已经在虚拟环境中工作,只需省略
sudo`。
**注意**:
abjad支持python 3.6及更高版本。
`以及"pip":
…代码块::bash
~$git clone https://github.com/abjad/abjad.git
~$cd abjad
abjad$pip安装。
代码块::bash
~$python
python 3.6.5(v3.6.5:f59c0932b4,2018年3月28日,03:03:55)
[GCC 4.2.1(Apple Inc.Build 5666)(dot 3)]on darwin
键入"帮助"、"版权"、"信用"或"许可证"了解更多信息。
>;import abjad
>;>;abjad.\uuu版本
'3.0.0'
恭喜!
install lilypond
``````````````````
abjad使用"lilypond"这一开源自动雕刻引擎生成
符号输出。
abjad以最新版本的"lilypond"为目标。在撰写本文时,这意味着2.18-稳定或2.19-发展。我们建议直接从"lilypond"网站安装,而不是使用包管理器提供的"lilypond"版本,因为这些包通常已经过时。
通过运行以下命令测试lilypond是否可以从
命令行调用:
…代码块::bash
~$lilypond--version
版权所有(c)1996--2015 by
han wen nienhuys<;hanwen@xs4all.nl>;
jan nieuwenhuizen<;janneke@gnu.org>;
此程序是免费软件。它属于GNU通用
许可证的范围,在某些情况下,欢迎您更改和/或分发
许可证的副本。调用"lilypond--warranty"获取更多信息。
如果无法从命令行调用lilypond,则应将lilypond可执行文件的位置添加到"path"环境变量中。如果您使用osx,只需在终端中运行以下行:
…代码块::bash
export path="$path:/applications/lilypond.app/contents/resources/bin/"
可在osx下的命令行中找到,网址为http://www.lilypond.org/macos-x.html。
如果您是新使用命令行的用户,则应使用google
获得有关在shell中导航、编辑配置文件和设置环境变量的基本介绍。有更多的教程,我们无法计数!
安装graphviz(可选)
````````````````````````````````
abjad使用开源图形可视化库graphviz`,创建节奏树和其他树结构的图形,并为其文档创建类层次结构的可视化。用abjad创建符号不需要graphviz。
代码块::bash
~$sudo apt get install graphviz
代码块::bash
~$brew install graphviz
安装完"graphviz"后,通过运行以下命令从
命令行测试"graphviz"是否可调用:
。代码块:bash
~$dot-v
dot-graphviz版本2.38.0(20140413.2041)
abjad的api文档中的所有图形图像都是通过
`graphviz`创建的。请参见:py:func:`~abjad.top.graph`了解更多
详细信息。
安装扩展包
----
。代码块::bash
~$pip install abjad[book];文档工具
~$pip install abjad[cli];score package命令行工具
~$pip install abjad[ipython];ipython集成
~$pip install abjad[nauert];量化工具
~$pip安装abjad[rmakers]节奏生成器工具
~$pip安装abjad[tonality]音调分析工具
github存储库,并将其安装在
**编辑模式**及其**开发附件**:
…代码块::bash
~$git clone https://github.com/abjad/abjad.git
~$cd abjad
abjad$sudo pip install-e.[book,注意:在"install"之后字符串中没有空格
文档
-`pypdf2`,用于使用abjad的
``ajv book``工具对'latex``源代码执行预处理
sphinx``的一些依赖项提供可选的优化的'python`
扩展,这些扩展必须在使用之前编译。如果您的机器
没有可用的c编译器,则在运行``pip
install-e'.[development]``命令时可能会看到错误消息。这些警告是无害的,不会阻止依赖项的安装。
要在debian和ubuntu上安装c编译工具:
……代码块::bash
~$sudo apt get install build essential
要在OSX上安装C编译工具,我们建议只从Apple应用商店安装xcode
。或者,您可以通过"自制"安装,尽管这可能需要很长时间。
此外,还需要安装一些非"python"工具,以便开发abjad或构建abjad文档:"texlive"、"imagemagick",以及
`graphviz`(上面已经解释过了)。
install texlive
```````````````````
building the`latex``文档,running the test suite,并且使用abjad的
``ajv book``文档预处理工具需要'texlive`.
abjad使用'pdftex``来生成pdf,使用'pdfcrop``工具
来在debian和ubuntu上安装'texlive`:
代码块::bash
~$sudo apt get install texlive full
一组光栅图像处理工具。
代码块::bash
~$sudo apt get install imagemagick
代码块::bash
~$brew install imagemagick
安装"imagemagick"后,通过运行以下命令测试"imagemagick"是否可以从命令行中调用:
代码块::bash
~$convert--version
版本:imagemagick 6.9.1-6 q16 x86_64 2015-06-22 http://www.imagemagick.org
版权所有:copyright(c)1999-2015 imagemagick studio llc
许可证:http://www.imagemagick.org/script/license.php
功能:密码dpc模块
委托(内置):bzlib freetype jng jpeg ltdl lzma png tiff xml zlib
abjad和ipython
----
abjad可与"ipython"一起使用,将符号、图形和音频嵌入到
"ipython笔记本"中。要在"ipython"中使用abjad,请在安装abjad时同时使用其**开发**和**ipython**附加依赖项:
。代码块::bash
~$sudo pip install abjad[ipython]注意:在"install"之后字符串中没有空格
代码块::bash
~$apt get install timitity
代码块::bash
~$brew install timitity
安装完所有依赖项后,创建一个新的"ipython notebook"并在单元格中运行以下"magic"命令以加载abjad的"ipython"扩展名::
%load-ext abjadext.ipython
只要对有效的abjad对象使用"show(…)"和"play(…)",符号和midi文件就可以嵌入到笔记本中。
_虚拟环境:
虚拟环境允许
将"python"包与
包的系统全局集合隔离开来。它们还允许您安装不带"sudo"的python包。
"virtualenv"包提供了创建python虚拟环境的工具,
和"virtualenvwrapper"包提供了其他工具,这些工具使
使用虚拟环境变得异常简单。
让我们安装"virtualenvwrapper"
。代码块::bash
~$sudo pip安装virtualenvwrapper
…
**注意**:
在OSX 10.11(el capitan)上可能需要安装virtualenvwrapper``通过替代指令:
…代码块::bash
~$pip install virtualenvwrapper--忽略已安装的六个
请参见
`here<;http://stackoverflow.com/questions/32086631/cant-install-virtualenvwrapper-on-osx-10-11-el-capitan>;`\br/>了解详细信息。
在shell中设置一个环境变量,命名要存储的虚拟环境文件的目录,然后在该目录不存在时创建该目录:
。代码块::bash
~$export workn_home=~/.virtualenvs
~$mkdir-p$workn_home
**注意**:
因为您不太可能需要直接访问它们,所以我们建议在创建虚拟环境目录时使用"source"`virtualenvwrapper`.
脚本。这个脚本教您的shell如何创建、激活和删除
虚拟环境:
…代码块::bash
~$source`哪个virtualenvwrapper.sh`
最后,您可以通过``mkvirtualenv``命令创建一个虚拟环境。
这将创建一个新的环境并"激活"它。一旦激活,
您就可以在该环境中安装python包,这是安全的,因为您知道这些包不会干扰在您的
系统:
代码块::bash
~$mkvirtualenv abjad
…
~(abjad)$pip install abjad(abjad)"指示virtualenv的名称
…
或者通过"工作"命令切换到其他环境:
代码块::bash
~(abjad)$deactivate
~$work我的新分数
~(我的新分数)$
若要使虚拟环境配置从终端会话粘到终端会话,请将以下行添加到您的` ~/.profile`、
` `/.bash配置文件``或类似文件外壳配置文件:
…代码块::bash
export workun\u home=$home/.virtualenvs
source`哪个virtualenvwrapper.sh`
在虚拟环境中完成abjad的开发安装需要以下步骤:
-创建并激活新的虚拟环境
-将abjad克隆到某个位置,并将"cd"克隆到克隆存储库的根目录中
-安装abjad及其开发/ipython依赖关系
…代码块::bash
~$mkvirtualenv abjad
…
~(abjad)$git clone https://github.com/abjad/abjad.git
~(abjad)$cd abjad
abjad(abjad)$pip install-e.[development,ipython]注意:"."和"[开发",ipython]"
…
配置abjad
----
配置文件。您可以使用abjad配置文件告诉abjad关于您首选的pdf文件查看器midi player,lilypond语言等。
第一次打开abjad于2014年1月31日00:08:17创建的abjad配置文件时,您的配置文件将如下所示:
#设置为保存所有abjad生成的文件(如pdf和lilypond文件)的目录。
"英克卢de"在所有生成的*.ly文件中,
lilypond_includes=,
设置为覆盖动态查找。
lilypond路径=lilypond
midi播放器打开midi文件。
pdf文件。
pdf查看器=
http://en.wikipedia.org/wiki/ini_file.
在MacOS下,您可能需要将"MIDI播放器"设置为iTunes。在linux下,您可能希望将"pdf查看器"设置为"evince",将"midi播放器"设置为"timidity",依此类推。_ cpython:http://www.python.org
。_ github:https://github.com/abjad/abjad
。_ graphviz:http://graphviz.org/
。_自制:http://brew.sh/
…_ ipython笔记本:http://ipython.org/notebook.html
…_ ipython:http://ipython.org/
。_ imagemagick:http://www.imagemagick.org/script/index.php
。_乳胶:https://tug.org/
…_ lilypond:http://lilypond.org/
。_ mactex:https://tug.org/mactex/
。_ pypdf2:http://pythonhosted.org/pypdf2/
。_ pypi:https://pypi.python.org/pypi/abjad
。_ python:https://www.python.org/
。_斯芬克斯:http://sphinx doc.org/
。_ texlive:https://www.tug.org/texlive/
。_胆怯:http://timidity.sourceforge.net/
…_ PIP:https://pip.pypa.io/en/stable/
。_ pytest:http://pytest.org/latest/
。_ virtualenv:https://readthedocs.org/projects/virtualenv/
。_ virtualenvwrapper:https://virtualenvwrapper.readthedocs.org/en/latest/