这不仅仅是一个编码风格的问题.如果您了解python(我认为Ruby也有类似的东西),您可以在函数中使用docstring,这样您就可以通过发出"help"命令轻松获取该字符串.例如:
def something(t=None):
'''Do something, perhaps to t
t : a thing
You may not want to do this
'''
if t is not None:
return t ** 2
else:
return 'Or maybe not'
Run Code Online (Sandbox Code Playgroud)
然后help(something)返回以下内容:
Help on function something in module __main__:
something(t=None)
Do something, perhaps to t
t : a thing
You may not want to do this
Run Code Online (Sandbox Code Playgroud)
R中的工作方式,你可以获得定义的代码片段的全文,这样你就可以看到注释(包括函数开头的注释),但这可能是很多滚动和可视化过滤.有没有更好的方法?
我有一个简单的并行化任务,可以为跨多个文件的多个表独立计算结果。我可以构建延迟或 dask.dataframe 列表(并且也尝试过,例如 dict),但我无法计算所有结果(我可以使用 dask 图形样式字典获取单个结果.get(),但同样不能轻松计算所有结果)。这是一个最小的例子:
>>> df = dd.from_pandas(pd.DataFrame({'a': [1,2]}), npartitions=1)
>>> numbers = [df['a'].mean() for _ in range(2)]
>>> dd.compute(numbers)
([<dask.dataframe.core.Scalar at 0x7f91d1523978>,
<dask.dataframe.core.Scalar at 0x7f91d1523a58>],)
Run Code Online (Sandbox Code Playgroud)
相似地:
>>> from dask import delayed
>>> @delayed
... def mean(data):
... sum(data) / len(data)
>>> delayed_numbers = [mean([1,2]) for _ in range(2)]
>>> dask.compute(delayed_numbers)
([Delayed('mean-0e0a0dea-fa92-470d-b06e-b639fbaacae3'),
Delayed('mean-89f2e361-03b6-4279-bef7-572ceac76324')],)
Run Code Online (Sandbox Code Playgroud)
我想得到 [3, 3],这是我基于延迟集合文档所期望的。
对于我真正的问题,我实际上想在 HDF5 文件中的表上进行计算,但鉴于我可以使用它,dask.get()我很确定我已经指定了我的延迟/dask 数据帧步骤。
我会对直接生成字典的解决方案感兴趣,但我也可以只将 (key, value) 元组列表返回给dict(),这可能不会对性能造成巨大影响。
目前,我可以找到获取 readthedocs.org 使用的当前设计资产的唯一方法是安装完整的主题,并构建它,这需要 SASS 等。
我只想获得一组静态文件,让我可以在本地查看我的构建在 readthedocs 上的样子。有没有办法在不通过上述链接自己构建资产的情况下做到这一点?目标是让新手可以轻松地为文档做出贡献。
如何在Markdown和Jekyll中制作带标签的帖子列表?我想要找到的是如何更改以下代码:
<ul class="posts">
{% for post in site.posts limit: 20 %}
<div class="post_info">
<li>
<a href="{{ post.url }}">{{ post.title }}</a>
<span>({{ post.date | date:"%Y-%m-%d" }})</span>
</li>
</div>
{% endfor %}
</ul>
Run Code Online (Sandbox Code Playgroud)
仅显示带有" 问题 " 标签的帖子?可以这样做吗?