risk-assessment 0.1.0

A comprehensive enterprise risk assessment system

风险评估模型库

这是一个用于企业风险评估的Python库，提供了完整的风险评估功能，包括数据加载、风险计算、结果导出和可视化。

安装

pip install risk-assessment

功能特点

• 支持从Excel文件加载数据
• 计算多种风险类型（战略风险、财务风险、市场风险等）
• 生成详细的风险评估报告
• 可视化风险评分结果
• 支持自定义配置参数

使用示例

基本用法

from risk_assessment import RiskModel

# 创建模型实例
model = RiskModel()

# 加载数据
# 方法1：加载默认工作表（第一个工作表）
model.load_data('your_data.xlsx')

# 方法2：指定工作表名称
model.load_data('your_data.xlsx', sheet_name='Sheet1')

# 方法3：指定工作表索引
model.load_data('your_data.xlsx', sheet_name=0)  # 第一个工作表

# 计算风险评分
results = model.calculate_total_risk()

# 绘制风险评分图表
model.plot_risk_scores(results, save_path='risk_chart.png')

# 导出详细计算结果
model.export_calculation_details(results, 'risk_details.xlsx')

使用自定义配置

from risk_assessment import RiskModel

# 使用自定义配置文件
model = RiskModel(config_path='custom_config.yaml')

# 后续操作与基本用法相同

数据格式要求

输入Excel文件需要满足以下要求：

1. 数据格式：

   • 第一列必须是指标名称
   • 后续列是各月份的数据
   • 第一行是列名（月份或其他时间标识）

2. 工作表选择：

   • 默认读取第一个工作表
   • 可以通过 sheet_name 参数指定工作表
   • 支持工作表名称或索引号

3. 必需的数据列：

   • 主营业务收入
   • 总营业务收入
   • 主营业务成本
   • 总业务成本
   • 主营业务费用
   • 研发费用
   • 负债总额
   • 资产总额
   • 带息负债总额
   • 经营现金流入
   • 经营现金流出
   • 经营净现金流
   • 投资分红等收益
   • 利息支出
   • 预付账款
   • 预收账款
   • 应收账款
   • 应付账款
   • 净资产
   • 应收账款总额
   • 坏账准备金额
   • 存货
   • 企业当年涉及司法诉讼案件的数量
   • 执行金额
   • 被执行金额
   • 已销号事件数
   • 年初事件数
   • 新增事件数
   • 已销号事件影响金额
   • 年初事件影响金额
   • 新增事件影响金额
   • 未销号事件兜底保障金额
   • 未销号事件追损挽损金额
   • 未销号事件累计计提减值金额
   • 未销号事件影响金额
   • 已处置金额
   • R1-R11（风险阈值参数）
   • n0（风险阈值参数）
   • m1-m3（信用风险参数）
   • x1-x5（社会责任风险参数）
   • y1-y4（社会责任风险参数）
   • z1-z3（社会责任风险参数）
   • 行业较差值
   • 货币资金
   • 财务费用中的利息费用

配置说明

可以通过YAML配置文件自定义以下参数：

• 各类风险的权重
• 风险阈值参数
• 计算参数

配置文件示例：

weights:
  strategic: 0.25
  financial: 0.30
  market: 0.20
  legal_credit: 0.15
  event: 0.10

输出结果

风险评估结果包含：

1. 总体风险评分
2. 各项风险评分
3. 风险等级
4. 风险判断依据
5. 详细的计算过程

许可证

MIT License

贡献

欢迎提交问题和改进建议！