"""Render the reviewed R2 functional architecture, without numerical modeling."""
from pathlib import Path
import os, re, json, hashlib, html
from PIL import Image, ImageDraw, ImageFont
ROOT=Path(__file__).resolve().parents[2]
SRC=ROOT/'reports/06_reports/02_power_system/POWER-R2-001/architecture.md'
OUT=ROOT/'reports/06_reports/02_power_system/POWER-R2-001/figures'
OUT.mkdir(exist_ok=True)
FONT=Path(os.environ['WINDIR'])/'Fonts/msyh.ttc'
class Diagram:
def __init__(self,name,w,h,title):
self.name=name; self.w=w;self.h=h;self.nodes={};self.edges=[];self.labels={}
self.svg=[]; self.im=Image.new('RGB',(w*2,h*2),'white'); self.d=ImageDraw.Draw(self.im)
self.title=title
def text(self,x,y,text,size=32,fill='#111111',anchor='mm'):
font=ImageFont.truetype(str(FONT),size*2)
self.d.text((x*2,y*2),text,font=font,fill=fill,anchor=anchor)
ta='middle' if anchor.startswith('m') else 'start'
self.svg.append(f'{html.escape(text)}')
def node(self,key,x,y,w,h,lines,kind='normal'):
assert key not in self.nodes,key
self.nodes[key]=(x,y,w,h)
self.labels[key]=(lines,kind)
color={'normal':'#FAFAFA','native':'#EAF1F2','safe':'#F3EEEE','ground':'#FFFFFF'}.get(kind,'#FAFAFA')
self.d.rounded_rectangle((x*2,y*2,(x+w)*2,(y+h)*2),radius=8,fill=color,outline='#4C565B',width=3)
self.svg.append(f'')
for i,line in enumerate(lines):self.text(x+w/2,y+h/2+(i-(len(lines)-1)/2)*39,line,32)
def port(self,key,side):
x,y,w,h=self.nodes[key]
return {'t':(x+w/2,y),'b':(x+w/2,y+h),'l':(x,y+h/2),'r':(x+w,y+h/2)}[side]
def link(self,a,b,sa='b',sb='t',via=None,dashed=False,label=None,lp=None,both=False,arrow=True):
p=[self.port(a,sa),*(via or []),self.port(b,sb)]
color='#626B70' if dashed else '#173A46'
pts=' '.join(f'{x},{y}' for x,y in p)
self.svg.insert(0,f'')
# PIL dashed polylines with a stable visual rhythm.
for p1,p2 in zip(p,p[1:]):
x1,y1=p1;x2,y2=p2;dist=((x2-x1)**2+(y2-y1)**2)**.5
if dashed:
for s in range(0,int(dist),14):
t1=s/max(dist,1);t2=min((s+8)/max(dist,1),1)
self.d.line(((x1+(x2-x1)*t1)*2,(y1+(y2-y1)*t1)*2,(x1+(x2-x1)*t2)*2,(y1+(y2-y1)*t2)*2),fill=color,width=4)
else:self.d.line((x1*2,y1*2,x2*2,y2*2),fill=color,width=4)
def head(at,prev):
import math
ang=math.atan2(at[1]-prev[1],at[0]-prev[0]);x,y=at
ps=[(x*2,y*2),((x-12*math.cos(ang-.45))*2,(y-12*math.sin(ang-.45))*2),((x-12*math.cos(ang+.45))*2,(y-12*math.sin(ang+.45))*2)]
self.d.polygon(ps,fill=color)
if arrow:head(p[-1],p[-2])
if both:head(p[0],p[1])
if label:
assert lp
self.text(*lp,label,25,color)
self.edges.append({'from':a,'to':b,'dashed':dashed,'bidirectional':both})
def save(self):
# Draw nodes a second time over routing so edges never cover labels.
for key,(x,y,w,h) in self.nodes.items():
lines,kind=self.labels[key]
color={'normal':'#FAFAFA','native':'#EAF1F2','safe':'#F3EEEE','ground':'#FFFFFF'}.get(kind,'#FAFAFA')
self.d.rounded_rectangle((x*2,y*2,(x+w)*2,(y+h)*2),radius=8,fill=color,outline='#4C565B',width=3)
font=ImageFont.truetype(str(FONT),64)
for i,line in enumerate(lines):self.d.text(((x+w/2)*2,(y+h/2+(i-(len(lines)-1)/2)*39)*2),line,font=font,fill='#111111',anchor='mm')
self.text(self.w/2,25,self.title,35)
png=OUT/(self.name+'.png');svg=OUT/(self.name+'.svg')
self.im.save(png,dpi=(300,300))
defs=''
svg.write_text(f'',encoding='utf-8')
return {'name':self.name,'title':self.title,'png':png.relative_to(ROOT).as_posix(),'svg':svg.relative_to(ROOT).as_posix(),'png_sha256':hashlib.sha256(png.read_bytes()).hexdigest(),'nodes':list(self.nodes),'edges':self.edges,'size_px':[self.w*2,self.h*2]}
def gas():
g=Diagram('R2-ARCH-01',1400,1680,'储供氢 空气与热量路径')
chain=[('GROUND',['地面充装与检测','不计机载质量']),('FILL',['可锁定加注口']),('TANK',['气瓶与初装氢','B17 / B18']),('HPVALVE',['瓶侧手动隔离','有据时归B19 / B20']),('REG',['匹配调压器 B19']),('NCVALVE',['低压失电关闭阀 B21']),('FILTER',['氢用过滤器 B22']),('H2LINE',['6 mm管与接头','B23 / B24']),('SPLIT',['分流至两个SPM','6 mm接口 B24']),('STACK',['FC阳极 B13','FCPM父项']),('PURGE',['原生吹扫与排氢','交货含件待确认']),('VENT',['独立排放路线 B26','远离进气口'])]
for i,(k,lab) in enumerate(chain):g.node(k,20,65+i*132,420,93,lab,'ground' if i<2 else 'native' if k in ('STACK','PURGE') else 'normal')
for (a,_),(b,_) in zip(chain,chain[1:]):g.link(a,b)
right=[('AIR',['环境空气']),('INTAKE',['防异物与进气布置']),('AIRFAN',['开阴极风扇与阴极','含于FCPM时 B14']),('EXHAUST',['分离的热湿排气']),('AIRDUCT',['外加风道 B16']),('H2DET',['氢检测 B27']),('SAFECTRL',['独立安全控制 B28'])]
for i,(k,lab) in enumerate(right):g.node(k,960,65+i*157,420,104,lab,'safe' if k in ('H2DET','SAFECTRL') else 'native' if k=='AIRFAN' else 'normal')
for a,b in [('AIR','INTAKE'),('INTAKE','AIRFAN'),('AIRFAN','EXHAUST')]:g.link(a,b)
g.link('AIRDUCT','AIRFAN','l','l',[(925,745),(925,431)],True)
g.node('HP',505,329,385,104,['高压测压与余氢','B20'])
g.node('PRD',505,485,385,104,['瓶侧独立泄压','B20'])
g.node('LPPT',505,990,385,104,['低压测量 B25'])
g.link('TANK','HP','r','l',dashed=True)
g.link('TANK','PRD','r','t',[(470,375),(470,464),(697,464)])
g.link('PRD','VENT','b','r',[(697,622),(470,622),(470,1563)])
g.link('H2LINE','LPPT','r','l',[(470,1036),(470,1042)],True)
g.link('HP','SAFECTRL','r','t',[(915,381),(915,975),(1170,975)],True)
g.link('LPPT','SAFECTRL','r','l',dashed=True)
g.link('H2DET','SAFECTRL',dashed=True)
g.link('SAFECTRL','NCVALVE','r','r',[(1390,1059),(1390,1150),(455,1150),(455,771)],True)
g.link('SAFECTRL','STACK','b','r',[(1170,1305),(460,1305),(460,1300)],True)
g.link('STACK','AIRFAN','r','r',[(945,1299),(945,1165),(1380,1165),(1380,431)],True)
g.text(1065,1390,'实线 气体路径',30)
g.text(1065,1440,'虚线 控制 状态或热关系',30)
g.text(1065,1520,'含件按交货边界计重一次',28)
g.text(1065,1570,'图中位置不表示实际布置',28)
return g
def power():
g=Diagram('R2-ARCH-02a',1400,1470,'原生混动接口与四路推进')
g.node('FCPM',25,75,420,110,['FC电堆与BOP','B13 / B14'],'native')
g.node('DCDC',495,75,410,110,['原生DC/DC与混动电子','B15'],'native')
g.node('BATTERY',965,75,410,110,['两块6S串联电池','12S缓冲包 B29'])
g.node('BMS',965,240,410,105,['12S监测与保护 B30'])
g.node('BFUSE',965,405,410,110,['电池保险与隔离接插件','B31 / B52'])
g.node('NATIVE',495,405,410,110,['厂家指定电池端 BATT+','原生削峰与应急路径'],'native')
g.node('FFUSE',495,240,410,105,['混合输出支路保护 B31'])
g.node('PRECHARGE_ORING',495,575,410,110,['未由OEM覆盖的','预充与隔离 B32'])
g.node('PDB',495,750,410,105,['总线分配与分支保护','B33'])
g.link('FCPM','DCDC','r','l')
g.link('BATTERY','BMS',both=True);g.link('BMS','BFUSE',both=True)
g.link('BFUSE','NATIVE','l','r',both=True)
g.link('NATIVE','DCDC','l','l',[(460,460),(460,130)],both=True)
g.link('DCDC','FFUSE')
g.link('FFUSE','PRECHARGE_ORING','l','l',[(475,292),(475,630)])
g.link('PRECHARGE_ORING','PDB')
for i,x in enumerate([20,370,720,1070],1):
g.node(f'ESC{i}',x,965,310,95,[f'ESC {i} B11'])
g.node(f'M{i}',x,1125,310,95,[f'电机 {i} B10'])
g.node(f'R{i}',x,1285,310,105,[f'旋翼 {i} B12','CW' if i%2 else 'CCW'])
g.link('PDB',f'ESC{i}',via=[(700,907),(x+155,907)])
g.link(f'ESC{i}',f'M{i}');g.link(f'M{i}',f'R{i}')
g.text(700,1430,'负载接PWR+ 电池接BATT+ 共同GND',30)
return g
def auxiliaries():
g=Diagram('R2-ARCH-02b',1400,1025,'总线辅助供电与分支负载')
g.node('PDB',495,75,410,100,['受保护总线分配 B33'])
for k,x,lab in [('PM08',20,['5.2 V航电稳压与计量','PM08 B36']),('REG5',495,['独立5 V安全分支','B38']),('REG12',970,['12 V分支','B37'])]:
g.node(k,x,270,410,115,lab);g.link('PDB',k,via=[(700,220),(x+205,220)])
for k,x,y,lab in [('FCU',20,480,['飞控与底板','B40 / B41']),('GNSS',20,660,['导航与罗盘 B42']),('RADIO',20,840,['空中数传 B43']),('SAFE',495,480,['氢检测与安全控制','B27 / B28']),('EMS',495,660,['外部EMS B45']),('VALVE',970,480,['低压截止阀 B21']),('PAYLOADSW',970,660,['任务负载开关 B48']),('PAYLOAD',970,840,['巡检与测绘载荷 B47'])]:g.node(k,x,y,410,105,lab)
for k in ['FCU','GNSS','RADIO']:
if k=='FCU':g.link('PM08',k)
else:g.link('PM08',k,'l','l',[(8,327),(8,g.port(k,'l')[1])])
g.link('REG5','SAFE');g.link('REG5','EMS','l','l',[(475,327),(475,712)])
g.link('REG12','VALVE');g.link('REG12','PAYLOADSW','r','r',[(1393,327),(1393,712)])
g.link('PAYLOADSW','PAYLOAD')
g.text(700,995,'B34动力线与B35信号线按未含部分记账',28)
return g
def charge():
g=Diagram('R2-ARCH-03',1400,1000,'可选低功率CC/CV充电支路')
ns=[('BUS',20,75,['受保护50 V总线']),('CHGIN',20,290,['独立输入保护','充电使能']),('CCCV',495,290,['BQ25750类CC/CV B50','提案1 A 49.2 V']),('BMCHG',970,290,['BMS受保护充电端']),('PACK',970,535,['12S电池']),('NATIVE',495,755,['原生POM高电流电池端','削峰与应急放电']),('EMS',495,75,['EMS 余功率 SOC','温度与故障'])]
for k,x,y,lab in ns:g.node(k,x,y,410,130,lab,'native' if k=='NATIVE' else 'normal')
g.link('BUS','CHGIN');g.link('CHGIN','CCCV','r','l');g.link('CCCV','BMCHG','r','l');g.link('BMCHG','PACK');g.link('PACK','NATIVE','b','r',[(1175,820)])
g.link('EMS','CCCV',dashed=True)
g.text(700,950,'原生充电保持关闭 共同地 未宣称电气隔离',30)
return g
def control():
g=Diagram('R2-ARCH-04',1400,1360,'控制职责 状态接口与安全联锁')
for k,x,y,lab in [('FCU',970,75,['飞控 姿态轨迹与推力']),('ESCS',970,290,['四路ESC']),('FCDATA',20,75,['FCPM 输出温度故障','供氢与原生保护']),('EMS',495,495,['外部EMS 功率请求','任务储备与充电余量']),('BMS',20,290,['BMS 单体温度电流','SOC与保护']),('PDBDATA',20,495,['母线与分支计量']),('LOAD',970,710,['可切除任务载荷开关']),('H2S',20,950,['氢检测 压力 看门狗']),('SAFECTRL',495,950,['独立安全控制器']),('VALVE',970,1150,['失电关闭氢阀'])]:g.node(k,x,y,410,130,lab,'safe' if k in ('H2S','SAFECTRL','VALVE') else 'normal')
g.link('FCU','ESCS',dashed=True)
for k in ['FCDATA','BMS','PDBDATA']:g.link(k,'EMS','r','l',[(465,g.port(k,'r')[1]),(465,560)],True)
g.link('EMS','FCU','r','l',[(940,560),(940,140)],True)
g.link('EMS','FCDATA','t','b',[(700,240),(225,240)],True)
g.link('EMS','LOAD','r','l',[(940,560),(940,775)],True)
g.link('H2S','SAFECTRL','r','l',dashed=True)
g.link('SAFECTRL','VALVE','b','l',[(700,1215)],True)
g.link('SAFECTRL','FCDATA','t','l',[(700,900),(7,900),(7,140)],True)
g.link('SAFECTRL','FCU','r','r',[(1390,1015),(1390,140)],True)
g.text(700,1320,'虚线表示状态或命令 未证明所有协议与故障路由已验证',28)
return g
def cryo():
g=Diagram('R2-ARCH-05',1400,1390,'低温高压储氢研究替换支路')
for k,x,y,lab in [('CRYO_INNER',20,75,['承压内壳 C01']),('MLI',495,75,['绝热与真空层 C03']),('CRYO_OUTER',970,75,['外壳 C02']),('CRYO_SUPPORT',20,290,['低导热支撑与安装','C04']),('CRYO_VALVES',495,290,['低温隔离泄压加注','C07']),('VAPORIZER',495,535,['气体升温或汽化','C05']),('REG',495,780,['匹配调压与进堆条件']),('FCPM',495,1025,['接同版四旋翼FCPM']),('CRYO_PT',970,535,['压力温度真空状态','C08']),('HEATER',20,535,['按需保压加热 C06','热量与实际耗电分计']),('VENT',970,290,['独立安全放散'])]:g.node(k,x,y,410,130,lab)
g.link('CRYO_INNER','MLI','r','l',arrow=False);g.link('MLI','CRYO_OUTER','r','l',arrow=False);g.link('CRYO_SUPPORT','CRYO_INNER','t','b',arrow=False)
g.link('CRYO_INNER','CRYO_VALVES','b','l',[(225,245),(460,245),(460,355)])
g.link('CRYO_VALVES','VAPORIZER');g.link('VAPORIZER','REG');g.link('REG','FCPM');g.link('CRYO_VALVES','VENT','r','l')
g.link('HEATER','CRYO_INNER','l','l',[(8,600),(8,140)],True)
g.link('CRYO_PT','HEATER','b','b',[(1175,735),(225,735)],True)
g.text(700,1230,'C01至C08替换对应常温项目后计算',31)
g.text(700,1290,'地面液化 压缩与充装设备不计机载质量',30)
g.text(700,1345,'尚无已核定的低温高压UAV商品罐',30)
return g
if __name__=='__main__':
ds=[gas(),power(),auxiliaries(),charge(),control(),cryo()]
# The gas path, native power graph, charge, controls and cryo blocks
# must each retain every function node of the editable Mermaid source.
blocks=re.findall(r'```mermaid\s*(.*?)```',SRC.read_text('utf-8'),re.S)
groups=[ds[0],None,ds[3],ds[4],ds[5]]
audits=[]
for i,block in enumerate(blocks):
original=set(re.findall(r'\b(\w+)\[',block))
drawn=set(ds[1].nodes)|set(ds[2].nodes) if i==1 else set(groups[i].nodes)
assert original==drawn,{'diagram':i,'missing':list(original-drawn),'extra':list(drawn-original)}
audits.append({'mermaid_index':i,'source_nodes':len(original),'all_nodes_retained':True})
result=[g.save() for g in ds]
(OUT/'render-receipt.json').write_text(json.dumps({'source':'reports/06_reports/02_power_system/POWER-R2-001/architecture.md','source_sha256':hashlib.sha256(SRC.read_bytes()).hexdigest(),'science_calculations':False,'renderer':'Pillow and matching editable SVG; manual functional layout','node_coverage':audits,'figures':result,'visual_review':'pending'},ensure_ascii=False,indent=2),encoding='utf-8')
print(json.dumps({'figures':len(ds),'node_coverage':audits},ensure_ascii=False))