0. 承前

如果想更加全面清晰地了解金融资产组合模型进化论的体系架构，可参考：
0. 金融资产组合模型进化全图鉴

1. 简述

• 描述ROIC含义：ROIC（Return on Invested Capital，投入资本回报率）是看企业经营所需资金的赚钱能力
• 应用：帮助我们了解企业用于日常经营的钱赚钱的效率
• 大白话：就像看看养鸡用的钱（买鸡、买饲料的钱）赚了多少，不算固定的鸡舍

2. 比喻：养鸡赚钱

2.1 第一步：分清投入

小明的养鸡投入：
经营用的钱：
- 100元买母鸡
- 50元买饲料
- 总共150元（这是投入资本）

固定设施：
- 100元盖鸡舍（这个不算）

2.2 第二步：开始经营

养鸡场运转起来：
- 用150元经营养鸡
- 母鸡吃饲料下蛋
- 每天产生收入

2.3 第三步：计算收益

一年后算算：
- 卖蛋收入：365元
- 减去饲料成本：65元
- 纯赚到了：300元

2.4 第四步：计算ROIC

看看经营投入的赚钱能力：
ROIC = 赚到的钱 ÷ 经营投入
300元 ÷ 150元 = 2

这就是说：
- 每投入1元经营资金
- 一年能赚2元
- ROIC是200%

3. 生活中的例子

3.1 高效率经营

小红养鸡：
- 经营投入150元
- 一年赚450元
- ROIC = 300%
经营很有效率！

3.2 普通经营

小华养鸡：
- 经营投入150元
- 一年赚300元
- ROIC = 200%
经营效率一般！

3.3 低效率经营

小强养鸡：
- 经营投入150元
- 一年赚75元
- ROIC = 50%
经营效率很差！

4. 小朋友要注意

4.1 ROIC看什么

只看经营用的钱：
- 买鸡的钱
- 买饲料的钱
- 日常开销的钱

不看固定设施：
- 不算鸡舍
- 不算工具

4.2 提高ROIC的方法

可以这样做：
- 选好下蛋的鸡
- 控制饲料成本
- 提高卖蛋效率

5. 总结

记住：
- ROIC看经营资金效率
- 只算日常经营的钱
- 不算固定的设施
- 要看经营投入回报

简单公式：
ROIC = 赚到的钱 ÷ 经营投入的钱

6. 实现代码

def get_roic_data(ts_code: str, start_date: str = None, end_date: str = None) -> pd.DataFrame:
    """
    获取公司ROIC(投入资本回报率)数据
    
    参数:
        ts_code (str): 股票代码 (例如: '600000.SH')
        start_date (str): 开始日期 (例如: '20180101')
        end_date (str): 结束日期 (例如: '20181231')
    
    返回:
        DataFrame: 包含以下字段:
        - ts_code: 股票代码
        - ann_date: 公告日期
        - end_date: 报告期
        - roic: 投入资本回报率
        - roic_yearly: 年化投入资本回报率
    """
    try:
        pro = ts.pro_api()
        df = pro.fina_indicator(ts_code=ts_code,
                              start_date=start_date,
                              end_date=end_date,
                              fields='ts_code,ann_date,end_date,roic,roic_yearly')
        return df
    except Exception as e:
        print(f"获取ROIC数据时出错: {str(e)}")
        return pd.DataFrame()