2018-07-25
COMPAS要求
依赖库
为了充分利用COMPAS,我们建议安装科学的Python发行版,如Anaconda或EPD。这将处理下面列出的大多数(可选)依赖项。但是,如果您愿意,也可以使用pip将大多数这些软件包单独添加到基本的Python安装中。
如果您正在使用Windows, 可以在Christof Gholke的非扩展软件包扩展包的非正式Windows二进制文件页面上找到许多非pip可 安装软件包的安装程序。在Mac上,您可以使用像macports 或homebrew这样的包管理器。
Numpy:适用于所有数值计算和算法。
Scipy:适用于所有数值计算和算法。
Matplotlib:用于二维可视化。
PyOpenGL:用于三维可视化。
PySide:对于一些独立工具。
NetworkX:用于网络的弹簧布局。
平面性:用于平面度测试。
Numba:准时编译。
PyCuda:通过Nvidia的CUDA进行并行计算。
PyOpenCL:用于OpenCL的并行计算。
Imageio:用于读取和写入图像数据。
包 依赖 例外
compas.com - matlab(MatlabEngine,MatlabSession),paramiko(ssh.py)
compas.datastructures -
compas.files -
compas.geometry - NumPy,SciPy(带_numpy后缀的功能)
compas.hpc Numba,PyCuda,PyOpenCL
compas.interop -
compas.numerical NumPy,SciPy
compas.plotters Matplotlib
compas.topology - NumPy,SciPy(带_numpy后缀的函数),
planarity(network_is_planar),
NetworkX(network_embed_in_plane)
compas.utilities - imageio(gif_from_images)
compas.viewers PyOpenGL,PySide
安装
该COMPAS框架由一个主库和添加的其他软件包组成。主库和其他软件包目前仍然需要一些手动安装,因为它们还没有可安装的pip并且没有附带安装脚本。以下说明将指导您完成主库的安装过程。
注意
说明只是指导原则。如果您知道自己在做什么,请随意采取不同的做法。
一般说明
1、创建一个基本文件夹
在系统上创建一个文件夹,您可以在其中对所有COMPAS相关的内容进行分组 例如,您可以在主驱动器上创建一个名为compas-dev的文件夹,该文件夹是承载COMPAS框架的GitHub 公司的名称。
$ cd ~
$ mkdir compas-dev
$ cd compas-dev
2、下载主库
将主库下载到系统有两种选择。
一个。下载一个版本
从https://github.com/compas-dev/compas/releases下载存档 并将其解压缩到安装文件夹中。
湾 克隆GitHub存储库
从终端
git clone https://github.com/compas-dev/compas.git复制代码
使用GitHub桌面
GitHub Desktop > File > Clone Repository复制代码
使用Url选项。
存储库URL:https://github.com/compas-dev/compas.git
本地路径:path / to / compas-dev / compas
验证克隆或下载
克隆或下载后,文件夹结构应包含:
compas-dev-compas-libs...-samples...-src-compas-compas_blender-compas_maya-compas_rhino-temp...复制代码
配置您的系统
验证Python是否在系统上PATH。
将compas框架添加到PYTHONPATH。
此步骤的操作系统特定说明可在以下位置找到:
验证您的安装
设置系统变量后测试您的安装。启动交互式Python会话(在终端或命令提示符中):
$ python复制代码
然后尝试以下代码。
>>> importcompas>>> compas.verify()复制代码
这会产生这样的东西:
================================================================================Checking required packages...All required packages are installed.Checking optional packages...The following optional packages arenotinstalled:- xxx- yyy- zzz================================================================================复制代码
如果安装了所有必需的软件包,请尝试
>>> importcompas>>> fromcompas.datastructuresimportMesh>>> mesh=Mesh.from_obj(compas.get('faces.obj'))>>> print(mesh)复制代码
在Unix上(Linux,OSX)
打开终端以编辑您的系统变量.bash_profile:
$ cd ~$ nano .bash_profile复制代码
注意
系统可能会提示您输入管理员密码。键入时不会显示字符。
添加以下内容:
exportPATH="/path/to/anaconda/bin:$PATH"exportPYTHONPATH="/path/to/compas-dev/compas/src:$PYTHONPATH"复制代码
添加路径之后,退出与编辑ctrl + o,enter,ctrl + x。然后重新启动终端或键入:
$ source .bash_profile复制代码
在Windows上
在Windows上,您必须更改环境变量:
ControlPanel>System>Advancedsystemsettings>EnvironmentVariables复制代码
在用户变量部分中,编辑PATH。
注意
PATH如果不存在,则创建一个新变量。
添加Anaconda安装的路径。
然后添加compas到PYTHONPATH。
注意
PTYTHONPATH如果不存在,则创建一个新变量。