安装 iobjectspy

iobjectspy 支持 python 3.6 及以上版本，由于其基于 SuperMap iObjects Java 组件构建，所以在安装 iobjectspy 之前，需要下载 SuperMap iObjects Java 组件，并将Java组件的 Bin 目录设置到环境变量中。依赖的 Java 组件版本最低为 11.2.0.22206

可以通过以下方式进行安装:

• 下载 iobjectspy 产品包，执行产品包内的 setup.py 脚本进行安装:

  python setup.py install
  

• 无需下载 iobjectspy 产品包，通过 pip 进行在线安装:

  python -m pip install iobjectspy
  

• 如需使用AI相关功能，还需要通过 conda在线安装相关依赖:

  注：需使用 清华大学开源软件镜像站 作为安装源

  • 如需使用CPU进行深度学习（默认）:

    conda env create -f requirements-conda-cpu.yml
    

  • 如需使用GPU进行深度学习（性能更优），并建议安装（更新）最新显卡驱动，而后:

    conda env create -f requirements-conda-gpu.yml
    

配置 SuperMap iObjects Java

• Windows 用户，可以通过以下方式配置 SuperMap iObjects Python 使用的 SuperMap iObjects Java 组件:

  1. 将 SuperMap iObjects Java 组件的 Bin 目录设置到 PATH 变量。

  2. 在安装完 SuperMap iObjects Python 后，在 cmd 命令行中执行 "iobjectspy set-iobjects-java E:/SuperMap/iObjects/Bin_x64"，通过这种方式，必须确保 Python 的 Scripts 目录在 PATH 环境中，或者直接在 Scripts 目录下执行。

  3. 启动 python 窗口，执行以下代码:

     >>> import iobjectspy
     >>> iobjectspy.set_iobjects_java_path('E:/SuperMap/iObjects/Bin_x64')
     

  需要注意的是，通过方式 2 和 3 配置 SuperMap iObjects Java 组件，会将指定的 SuperMap iObjects Java 组件目录配置到 iobjectspy 库目录下的 evn.json 文件中，这样，用户无需多次设置，但在升级 SuperMap iObjects Java 组件版本时，需要再次通过 2 或 3 执行。

• Linux 用户，可以通过以下方式配置 SuperMap iObjects Python 使用的 SuperMap iObjects Java 组件:

  1. 将 SuperMap iObjects Java 组件的 Bin 直接设置到 /opt/SuperMap/iobjects/1010/Bin 。
  2. 将 SuperMap iObjects Java 组件的 Bin 设置在环境变量中。

  • export LD_LIBRARY_PATH=/home/user/iobjects-java/bin:$LD_LIBRARY_PATH

  3. 在安装完 SuperMap iObjects Python 后，在 cmd 命令行中执行 iobjectspy set-iobjects-java /home/user/iobjects-java/bin。

  4. 启动 python 窗口，执行以下代码:

     >>> import iobjectspy
     >>> iobjectspy.set_iobjects_java_path('/home/user/iobjects-java/bin')
     

  需要注意的是，通过方式 3 和 4 配置 SuperMap iObjects Java 组件，会将指定的 SuperMap iObjects Java 组件目录配置到 iobjectspy 库目录下的 evn.json 文件中，这样，用户无需多次设置，但在升级 SuperMap iObjects Java 组件版本时，需要再次通过 3 或 4 执行。所以需要确保当前操作对 iobjectspy 安装目录有写入权限（可以通过使用 root 用户权限执行命令）。