ipython-IDV 2.4.7

[](https://travis-ci.org/piqueen314/ipython_IDV)
[](https://open-source.org.cn/licenses/MIT)
# ipython_IDV
### [EarthCube DRILSDOWN项目](https://brianmapes.github.io/EarthCube-DRILSDOWN/)的一部分

为IPython笔记本扩展，提供行和单元格魔法，以调用Unidata的[集成数据查看器](https://github.com/Unidata/IDV)

### 设置方法

1. 安装Jupyter/iPython笔记本软件[如本例](https://jupyter-notebook-beginner-guide.readthedocs.io/en/latest/)后，您还需要安装[ipywidgets包](https://ipywidgets.readthedocs.io/en/latest/user_install.html)

2. 一旦Jupyter/iPython准备就绪，将[drilsdown.py](https://github.com/Unidata/ipython_IDV/blob/master/drilsdown.py)复制到您的本地扩展目录，_~/.ipython/extensions_

3. 要从笔记本运行IDV命令，您需要安装[IDV版本5.4或更高版本](http://www.unidata.ucar.edu/software/idv/nightly/)。您还需要将IDV_HOME环境变量设置为IDV安装目录，以便python可以执行命令${IDV_HOME}/runIDV

4. 您还需要配置IDV以接受来自ipython笔记本的连接。为此，在您的本地 ~/.unidata/idv/DefaultIdv/idv.properties文件中设置以下属性

<pre>
idv.monitorport = 8765
</pre>


--------
### 完成上述4步后。
当您启动_jupyter notebook_并在浏览器中运行iPython笔记本时，请在笔记本中执行以下操作

<pre>
%load_ext drilsdown
</pre>

这将为您提供笔记本以仪表板式查看多种启动和与IDV交互的方式，以及查找现有包、数据目录等资源，包括帮助部分的链接。


如果您打算在这个笔记本中编写Python代码（而不仅仅是捕获案例研究IDV会话的图像和笔记），您应该导入Idv和Ramadda类

<pre>
from drilsdown import Idv
from drilsdown import Ramadda
</pre>

我们欢迎您提供用例！请通过mapes@miami.edu发送电子邮件。请参阅以下示例[以下](https://github.com/Unidata/ipython_IDV/blob/master/README.md#examples)。

---------
#### 使用IDV的功能发布到RAMADDA

如果您想启用IDV发布到RAMADDA服务器，获取[ramaddaplugin.jar](https://github.com/Unidata/ipython_IDV/blob/master/ramaddaplugin.jar)。将此文件复制到您的本地IDV插件目录(~/.unidata/idv/DefaultIdv/plugins)。虽然它不是一个纯文本代码文件，但它包含在这个存储库中，因此所有必需的运行drilsdown的产品都可以在一个地方找到。
一个地方。

---------
#### 设置您自己的RAMADDA以处理DRILSDOWN案例研究对象

如果您运营RAMADDA，并希望它托管DRILSDOWN _案例研究_数字对象，获取[drilsdownplugin.jar](https://github.com/Unidata/ipython_IDV/blob/master/drilsdownplugin.jar)，将其放入RAMADDA安装的_plugins_区域，然后重启。它是从[RAMADDA drilsdown存储库](https://github.com/Unidata/drilsdown)的代码生成的，但包含在这里，以便所有必需的运行drilsdown的产品都可以在一个地方找到。



<h2>Python笔记本调用DRILSDOWN和The IDV的示例</h2>
以下是一个如何使用API加载具有不同边框的IDV包并捕获图像的示例

<pre>
from drilsdown import Idv
Idv.fileUrl="http://geodesystems.com/repository/entry/get?entryid=d83e0924-008d-4025-9517-394e9f13712f"
bboxes = [[50,-130,40,-100],[50,-100,40,-75],[40,-130,20,-100],[40,-100,20,-75]]
for i in range(len(bboxes))
bbox=bboxes[i];
Idv.loadBundle(Idv.fileUrl,bbox)
Idv.makeImage(caption="BBOX:" + repr(bbox[0]) +"/" + repr(bbox[1]) +" " + repr(bbox[2]) +"/" + repr(bbox[3]))
</pre>


<pre>
from drilsdown import Idv
Idv.fileUrl="http://geodesystems.com/repository/entry/get?entryid=d83e0924-008d-4025-9517-394e9f13712f"
bboxes = [[50,-130,40,-100],[50,-100,40,-75],[40,-130,20,-100],[40,-100,20,-75]]
for i in range(len(bboxes))
bbox=bboxes[i];
Idv.loadBundle(Idv.fileUrl,bbox);
label = "BBOX:" + repr(bbox[0]) +"/" + repr(bbox[1]) +" " + repr(bbox[2]) +"/" + repr(bbox[3]);
Idv.makeMovie(caption=label,display=True, publish={'parent':'9adf32b5-aad4-4a8d-997e-216b9757d240',"name":"Image #" + repr(i)})
</pre>




makeImage可以接受publish参数的两种形式之一。第一种是一个布尔值，将导致IDV弹出其RAMADDA发布对话框，其中可以发布图像。
<pre>
Idv.makeImage(caption=label, publish=True);
</pre>

第二种形式中，publish参数是一个映射。这指导Python直接发布到RAMADDA。映射可以包含一个parent成员，它是要发布的条目ID，以及一个name成员，它是条目名称。

<pre>
Idv.makeImage(caption=label, publish={'parent':'9adf32b5-aad4-4a8d-997e-216b9757d240',"name":"Image #" + repr(i)})
</pre>

要启用直接发布到RAMADDA，您需要将您的RAMADDA用户名和密码定义为环境变量

<pre>
export RAMADDA_USER=
export RAMADDA_PASSWORD=
</pre>