强烈要求!!!
希望聚宽平台上面,所有示例代码加上详细注释说明!
强烈要求!!!聚宽自己发布的示例加上详细的代码说明。这样小白学习效率会直线上升。要不然看代码看好长时间不知道什么意思,不断的去问答发帖询问,这得浪费多少时间。
incode = jy.run_query(query(
jy.SecuMain.SecuCode,
jy.SecuMain.InnerCode,
).filter(
jy.SecuMain.SecuCode.in_(trade_list),
))
上面代码的例子,没有注释,小白根本就看不懂SecuMain.Secu,能否注释上具体的定义:‘将聚源数据取到的股票代码转化为聚宽所使用的代码形式’,注释这行代码的作用,以及实现的功能,是否每次引用聚源数据都需要先定义这样的代码
-------------------------------------------------------------------------------------
q = query(
jy.LC_Dividend.InnerCode, # 证券内部编码
jy.LC_Dividend.ExDiviDate, # 除权除息日
).filter(
jy.LC_Dividend.InnerCode.in_(incode['InnerCode']),
).order_by(jy.LC_Dividend.ExDiviDate.desc())
上面的代码注释看起来也不是很好理解,知道查询流程的人能看懂,小白肯定看不懂,如何能让小白看懂呢?就是加上详细的讲解。告知jy.run_query是什么,从哪里可以找到数据库,下面的图片数据是我从API上获取的,是否还能从平台的其它地方找到更全的说明。(jy.LC_Dividend.InnerCode, # 证券内部编码)这样的注释小白根本看不懂,#来自数据字典-聚宽数据(jy)-公司分红(LC_Dividend)-证券内部编码(InnerCode)把代码的逻辑思维给注释上,上面示例只注释最后一条,小白谁能看得懂,示例的作用就是能看小白一看看明白数据是如何来的,如何定义的,最后带来的结果是什么。
-----------------------------------------------------------------------------------------
df = jy.run_query(q).fillna(value=0, method=None, axis=0)
df2 = pd.merge(incode, df, on='InnerCode')
上面这两行代码我也不知道什么意思了,应该是输出结果,都定义的什么,为什么要定义,不定义会有什么影响,还有引入panda是来得到什么?是否可以直接引用一条代码“from jqdata import *”来实现。

-------------------------------------------------------------------------------

2019-10-27