通信工事会社が、光ファイバーの工事のあとに測る OTDR の測定結果のファイルを Python で読み、接続点ごとの損失を2方向の平均で基準と照らして、やり直しの候補と施工の報告書の表を作る
工事のあとに OTDR で測った SOR 形式のファイルを Python で読み、接続点ごとの損失を両方向の平均で出して発注者の基準と照らします。基準を超える点をやり直しの候補に、施工の報告書の表も同時に作ります。
- 連携・自動化
- Python
- 対象業界
- その他/建設
- 対象部門
- 品質管理
- 対象業務
- 内容確認・チェック/書類作成
- 主な課題
- 属人化している/書類作成に時間がかかる/確認ミスが多い
- AIで行う処理
- 判定
- 主な効果
- 入力漏れ削減/品質標準化/工数削減
- 導入難易度
- ★★★★☆
- 実装レベル
- 本格構成
- 費用感
- 個別開発(大)
- 人間の確認
- 条件付き
01導入前 / 導入後の業務フロー
- 現場の班から測定のファイルを受け取り、案件のフォルダに入れる
- 付属の解析ソフトで1心・1方向・1波長ずつファイルを開く
- イベントの表から、接続点ごとの距離と損失を読み、区間の表に写す
- 反対の向きのファイルを開き、同じ接続点を距離から探して値を写す
- 発注者の基準の表と見比べ、超えている点に印を付ける
- 印の付いた点の波形を開き、やり直しか再測定かを工事の責任者と決める
- 報告書の様式に、接続点の一覧と合否と代表の波形を貼る
- 人現場の班が、測定のファイルを案件のフォルダの「受領」に入れる
- 人品質管理の担当が、案件の台帳に区間の情報(区間の長さ、心線の数、接続点の設計の位置、発注者)を入れる
- 自動毎日の夕方、Python が受領のフォルダの SOR のファイルを読み、ケーブル・心線・向き・波長ごとに並べる
- 自動両方向のイベントを、設計の位置の一覧の接続点に結び付ける
- 自動接続点ごとに2方向の平均の損失を出し、発注者の基準と照らして、合格・やり直しの候補・曲げの疑い・再測定に分ける
- 自動区間ごとの判定の表と、報告書の様式に合わせた接続点の一覧を作る
- 人担当が、合格以外の点の波形を付属のソフトで開いて確かめ、工事の責任者とやり直しか再測定かを決める
- 人担当が報告書の表を見直し、代表の波形の図を付けて発注者に出す
各工程の詳しい説明を読む
- 現場の班から測定のファイルを受け取り、案件のフォルダに入れる
- 付属の解析ソフトで1心・1方向・1波長ずつファイルを開く
- イベントの表から、接続点ごとの距離と損失を読み、区間の表に写す
- 反対の向きのファイルを開き、同じ接続点を距離から探して値を写す
- 発注者の基準の表と見比べ、超えている点に印を付ける
- 印の付いた点の波形を開き、やり直しか再測定かを工事の責任者と決める
- 報告書の様式に、接続点の一覧と合否と代表の波形を貼る
(a)片方向の値で印を付けてしまう。 4番の反対の向きを探すのに時間がかかるので、忙しい月は片方向の値で5番の見比べをすることがあります。 太さの性質の違う心線どうしの接続で、片方向だけが大きく出た点をやり直しに回してしまいます。
(b)反対の向きの点を探すのに迷う。 反対の向きの距離は、区間の長さから引いた値になります。接続点が近くに2つある区間では、どちらがどちらかを取り違えます。
(c)測定器が拾わなかった点に気づかない。 損失が小さい接続点は、測定器の解析のしきい値を下回ると、イベントの表に出てきません。表に出てきた点だけを写すと、接続点の数が足りないことに気づきません。
(d)見る人によって拾う点が違う。 2つの波長の差、反射の大きさ、全体の損失。どこまで見るかが担当の経験で決まっていて、記録に残りません。
(e)写し間違いが報告書まで残る。 1区間で数百の数字を手で写すので、桁や心線の番号の取り違えが、そのまま発注者に出ていきます。
- 【人】 現場の班が、測定のファイルを案件のフォルダの「受領」に入れる
- 【人】 品質管理の担当が、案件の台帳に区間の情報(区間の長さ、心線の数、接続点の設計の位置、発注者)を入れる
- 【自動】 毎日の夕方、Python が受領のフォルダの SOR のファイルを読み、ケーブル・心線・向き・波長ごとに並べる
- 【自動】 両方向のイベントを、設計の位置の一覧の接続点に結び付ける
- 【自動】 接続点ごとに2方向の平均の損失を出し、発注者の基準と照らして、合格・やり直しの候補・曲げの疑い・再測定に分ける
- 【自動】 区間ごとの判定の表と、報告書の様式に合わせた接続点の一覧を作る
- 【人】 担当が、合格以外の点の波形を付属のソフトで開いて確かめ、工事の責任者とやり直しか再測定かを決める
- 【人】 担当が報告書の表を見直し、代表の波形の図を付けて発注者に出す
4番目が、この構成の土台です。 イベントの表に出てきた点を並べるのではなく、設計の位置の一覧を先に置き、そこに測定の点を結び付けます。 結び付かない接続点が残れば、測定器が拾わなかった点として印を付けます。
5番目で、損失を2方向の平均で見るのが、判定の考え方そのものです。 片方向の値は判定に使わず、報告書の表に参考として並べるだけにします。
7番目を人に残すのは、やり直しの決定が工事の段取りに関わるからです。 融着のやり直しには、接続箱を開けて作業する日程と人が要ります。判定はその候補を出すところまでです。
02今回想定するシステム構成
OTDR(現場の班)── SOR のファイル(心線×向き×波長)
│ USB メモリで持ち帰り
▼【トリガー】毎日の夕方
Python
├──▶ pyotdr の sorparse で読む(ケーブル ID、心線 ID、波長、屈折率、イベントの表)
├──▶ 案件の台帳を読む(区間の長さ、接続点の設計の位置、発注者)
├──▶ 反対の向きの距離を、区間の長さから引いて片側の起点にそろえる
├──▶ イベントを設計の位置に結び付ける
▼
Python ── 2方向の平均の損失、2つの波長の差、反射、全体の損失を基準と照らす
│ 合格 / やり直しの候補 / 曲げの疑い / 再測定
▼
区間ごとの判定の表、報告書の接続点の一覧
▼
【担当が波形を確かめる → 工事の責任者とやり直しを決める → 報告書を出す】| 役割 | 想定する製品 | 代替候補 |
|---|---|---|
| 実行環境 | Python(pyotdr・pandas) | 測定器のメーカーの解析ソフトの書き出し機能 |
| 処理 | Python(2方向の平均、接続点への結び付け、判定の規則) | R |
| 集計 | Python(区間ごとの判定の表、報告書の接続点の一覧) | 表計算の計算式 |
| 保管 | 社内のファイルサーバー(SOR の原本、読み出した JSON、判定の記録) | - |
新しく足すのは Python の処理だけです。 測定器と付属の解析ソフトはこれまでどおり使い、波形を見て確かめる作業は付属のソフトで行います。 案件の台帳と基準の表も、今ある表に列を足して使います。
SOR の読み出しには、オープンソースの pyOTDR(PyPI の名前は pyotdr)を使います。 Telcordia SR-4731 の第2版に基づく SOR の読み出しの道具で、pip install pyotdr で入り、Python 3.6 以上が要ります。ライセンスは GPL-3.0 です。 社内で使う処理に組み込む分には問題になりにくいですが、この処理を発注者や他社に配る場合は、GPL の条件を確かめてください。
作者は、規格が公開されておらず、手元の限られた見本のファイルから読み方を推し量ったものだと明記しています。 誤りが無いとは保証されていません。自社の測定器のファイルで、付属のソフトの表示と値が一致するかを、使い始める前に必ず確かめます(第8章)。合わなければ、メーカーの解析ソフトの書き出しの機能でイベントの表を出し、それを読む形に替えます。
03どうやって実装するのか
処理の起点を決める
毎日の夕方、Windows のタスク スケジューラーから Python のスクリプトを起動します。 現場の班は昼すぎから夕方に事務所に戻り、測定のファイルを受領のフォルダに入れます。その日の測定をその日のうちに判定し、翌朝の班の割り振りの前に、再測定の要る区間が分かるようにします。
区間の単位で、そろったものから判定します。 案件の台帳の心線の数と、受領のフォルダのファイルの数(心線×2方向×2波長)を比べ、そろっていない区間は判定せずに「ファイル待ち」として一覧に残します。 片方向だけで先に判定すると、第1章で書いた片方向の誤りがそのまま出ます。
判定を終えた区間のファイルは、処理済みのフォルダへ区間ごとに移します。移すのは判定の表まで書き終えたときだけで、受領のフォルダに残っているものが、まだ判定していないものです。
入力データを集める
| データ | 中身 | 取得元 |
|---|---|---|
| SOR のファイル | 一般の欄(ケーブル ID、心線 ID、波長、施工の状態)、固定の欄(測定の日時、波長、屈折率、損失のしきい値)、イベントの表(距離、損失、反射、種類)、区間の全体の損失と反射減衰量 | 案件のフォルダの受領 |
| 案件の台帳 | 案件、区間、A端とB端の名前、区間の長さ、心線の数、ケーブルの屈折率、発注者 | 案件の台帳(表計算) |
| 接続点の一覧 | 区間、接続点の番号、A端からの設計の距離、種類(融着・コネクタ) | 案件の台帳に足す表 |
| 判定の基準の表 | 発注者、融着の損失の上限、コネクタの損失の上限、反射の上限、2つの波長の差の線、全体の損失の上限 | 品質管理の担当が仕様書から写す |
質を決めるのは、接続点の一覧です。 これがあれば、測定器が拾わなかった接続点に気づけます。設計の距離は、ケーブルの余長の取り方で実際とずれるので、結び付けの幅を区間ごとに持たせます。
判定の基準の表には、仕様書のどの版のどの項目から写したかの列を持たせます。 発注者が仕様書を改めたときに、どの基準で判定した報告書かを後で言えるようにします。
データの取得方法を決める
読み出しは pyOTDR の sorparse で行います。 ファイルの名前を渡すと、読み出しの状態、結果の辞書、波形の点の並びの3つが返ります。状態が "ok" でなければ、そのファイルは判定に使いません。
| 取るもの | 結果の辞書の場所 | 何に使うか |
|---|---|---|
| ケーブル ID、心線 ID | GenParams | ファイルをケーブル・心線に結び付ける |
| 波長、屈折率、測定の日時 | FxdParams | 波長ごとの並べ分け、距離の確かめ |
損失のしきい値(loss thr) | FxdParams | 拾われなかった接続点の理由の確かめ |
| イベントごとの距離・損失・反射・種類 | KeyEvents の event 1、event 2… | 接続点ごとの判定 |
| 全体の損失、反射減衰量 | KeyEvents の Summary | 区間の全体の判定 |
イベントの距離は、ファイルの中の屈折率を使って時間から換算されています。 現場で屈折率をケーブルと違う値にしたまま測ると、すべてのイベントの距離が少しずつずれ、設計の位置に結び付かなくなります。 読み出した屈折率を案件の台帳のケーブルの値と比べ、違えば「屈折率の違い」の印を付けます。
イベントの種類は8文字の符号で入っていて、pyOTDR はそこから「反射のある点」「損失・利得の点」「複数」と、自動の解析か手で置いた点かを読み分けます。 手で置いた点が混ざっていれば、その心線は測定の担当が解析をいじった可能性があるので、印を付けて人が見ます。
心線 ID がファイルに入っていない班のファイルは、ファイルの名前から読みます。 班ごとの名前の付け方を表にし、そこから心線・向き・波長を取り出します。名前からも読めないファイルは「どの心線か不明」として判定から外します。
AIへ渡す前に整形する
- ファイルをそろえる … ケーブル ID・心線 ID・波長・向きで並べ、1心につき4つ(2方向×2波長)そろっているかを見ます
- 向きを決める … 測定の起点がA端かB端かを、ファイルの名前か班の記録から決めます
- 反対の向きの距離をそろえる … B端から測ったイベントの距離を、区間の長さから引いてA端からの距離にします
- イベントを接続点に結び付ける … 設計の距離の前後の幅の中で、いちばん近いイベントを選びます
- 端のイベントを分ける … 起点と終点の反射のイベントは、接続点の判定から外します
- 符号を保ったまま並べる … 片方向の損失が負(利得に見える点)でも、そのままの値で持ちます
3番目と4番目は、次のように作ります(要点だけ)。
from pyotdr.read import sorparse
def events(path):
status, res, _ = sorparse(path)
if status != "ok":
raise ValueError(f"読めない: {path}")
ke = res["KeyEvents"]
return [{"km": float(ke[f"event {i}"]["distance"]),
"loss": float(ke[f"event {i}"]["splice loss"]),
"refl": float(ke[f"event {i}"]["refl loss"]),
"type": ke[f"event {i}"]["type"]}
for i in range(1, ke["num events"] + 1)], res
def to_a_origin(evs, span_km): # B端から測った距離をA端からにそろえる
return [dict(e, km=round(span_km - e["km"], 4)) for e in evs]
def match(points, evs, win_km): # 設計の位置にいちばん近いイベントを結び付ける
out = {}
for p in points:
near = [e for e in evs if abs(e["km"] - p.km) <= win_km]
out[p.no] = min(near, key=lambda e: abs(e["km"] - p.km)) if near else None
return out
6番目で符号を保つのが、2方向の平均の前提です。 片方向の負の損失を0に切り上げてから平均すると、もう片方の向きの大きく見えた損失がそのまま残り、問題の無い接続がやり直しの候補になります。 平均は、負の値も負のまま足して2で割ります。
AIに処理させる
させるのは、接続点ごと・区間ごとに、決まった規則で合否と再測定の要否を判定することです。 判定は Python の規則で、生成AIは使いません。
| 判定 | 使う値 | 規則 |
|---|---|---|
| 融着の接続点の損失 | 2方向の平均の損失(波長ごと) | どちらかの波長で上限を超えたら「やり直しの候補」 |
| コネクタの損失 | 2方向の平均の損失 | 上限を超えたら「やり直しの候補」 |
| コネクタの反射 | 各方向の反射の値 | 上限を超えたら「やり直しの候補」(端面の清掃・研磨を含む) |
| 曲げの疑い | 1550nm と 1310nm の平均の損失の差 | 差が線を超えたら「曲げの疑い」 |
| 区間の全体の損失 | Summary の全体の損失(波長ごと) | 上限を超えたら「区間の要確認」 |
| 再測定 | ファイルの欠け、結び付かない接続点、屈折率の違い、手で置いた点 | 1つでもあれば「再測定」 |
曲げの疑いを、やり直しの候補と分けているのは、手当てが違うからです。 接続点で損失が出ていても、1550nm だけが大きいなら、融着ではなく接続箱の中の心線の収め方や、ケーブルの曲げが原因と考えられます。融着をやり直す前に、収納の具合を見ます。
判定の順番は、再測定を最初に見ます。 ファイルが欠けている、接続点に結び付かない、という心線は、損失の数字そのものが当てになりません。そこに合否を付けると、測り直せば済む心線をやり直しに回します。
| させないこと | 理由 |
|---|---|
| やり直すかどうかの決定 | 接続箱を開ける日程と人、発注者との調整がある。工事の責任者が決める |
| 基準の解釈 | 仕様書の書き方の解釈は発注者と決める。表に写した数字だけで判定する |
| 波形からの原因の特定 | 付属のソフトで波形を見て、担当が判断する |
| 片方向の値での合否 | 太さの性質の違いで、過大にも負にも見える |
| 測定器の解析のやり直し | 読むのは測定器が出したイベントの値だけ。波形から自前で点を探さない |
最後の行は、この構成の範囲を決めるものです。 波形の点の並びも読めますが、自前でイベントを探し直すと、付属のソフトの表示と報告書の数字が食い違います。 発注者が付属のソフトで見ても同じ値になるよう、測定器の解析の結果だけを使います。
指示内容を固定する
この構成の中心は生成AIではなく規則なので、プロンプトの代わりに、判定の規則を示します。
def judge(pt, ab, ba, spec):
"""pt: 接続点、ab/ba: 波長ごとの {1310: event, 1550: event}、spec: 発注者の基準"""
if any(ab.get(w) is None or ba.get(w) is None for w in (1310, 1550)):
return "再測定", "結び付かない向き・波長がある"
avg = {w: (ab[w]["loss"] + ba[w]["loss"]) / 2 for w in (1310, 1550)} # 符号ごと平均
lim = spec.splice_max if pt.kind == "融着" else spec.conn_max
if pt.kind == "コネクタ":
if max(ab[w]["refl"] for w in (1310, 1550)) > spec.refl_max or \
max(ba[w]["refl"] for w in (1310, 1550)) > spec.refl_max:
return "やり直しの候補", "反射が上限を超える"
if avg[1550] - avg[1310] > spec.bend_delta:
return "曲げの疑い", f"波長の差 {avg[1550] - avg[1310]:.3f} dB"
if max(avg.values()) > lim:
return "やり直しの候補", f"平均の損失 {max(avg.values()):.3f} dB"
return "合格", ""
基準の数字は、すべて spec から取り、処理の中に書き込みません。 発注者ごとの基準の表の1行が spec になります。反射の値の符号の向き(負の dB で持つか、正で持つか)は、測定器と基準の表の書き方で違うので、最初に自社のファイルで確かめて、比べる向きをそろえます。
曲げの疑いを損失の上限より先に見ているのは、両方に当たる点を曲げとして扱うためです。 1550nm だけが大きく上限を超えている点を「やり直しの候補」にすると、融着をやり直しても直りません。
2つの波長の差の線は、発注者の基準に無ければ自社で決めます。 測定器のメーカーの資料には、2つの波長の損失の差が0.2dB を超えれば曲げによるものとする例があります。この線は仕様書の基準ではないので、基準の表には「自社の線」として分けて持ち、報告書の合否には使わず社内の印にとどめます。
出力形式を固定する
区間ごとの判定の表と、報告書の様式に合わせた接続点の一覧の2つで出します。
| 心線 | 接続点 | 距離(km) | 種類 | 1310 A→B/B→A/平均 | 1550 A→B/B→A/平均 | 判定 | 理由 |
|---|---|---|---|---|---|---|---|
| 07 | 2 | 0.842 | 融着 | 0.21/-0.09/0.060 | 0.24/-0.06/0.090 | 合格 | - |
| 12 | 3 | 1.315 | 融着 | 0.05/0.07/0.060 | 0.48/0.52/0.500 | 曲げの疑い | 波長の差 0.440 dB |
| 19 | 2 | 0.839 | 融着 | - | - | 再測定 | 結び付かない向き・波長がある |
1つ目の理由は、片方向の値と平均を並べて、判定の理由が読めることです。 1行目は A→B だけを見ると大きめですが、B→A では負に見え、平均すると小さな損失です。 片方向の値で印を付けていた点が、表の上で説明できます。
2つ目は、判定の理由を言葉で残せることです。 2行目は1310nm では問題が無く、1550nm だけが大きい点です。担当は、接続箱の中の収め方を見る段取りを、波形を開く前に考えられます。
報告書の接続点の一覧は、発注者の様式の列の並びに合わせて書き出します。 片方向の値を載せるか、平均だけを載せるかは発注者の様式に従い、判定の表の「曲げの疑い」のような社内の印は報告書には出しません。
システムへ連携する
| つなぎ先 | 方式 | 内容 |
|---|---|---|
| 案件のフォルダ(受領) | ファイルを読む | SOR のファイル |
| 案件の台帳・接続点の一覧 | ファイルを読む | 区間の長さ、心線の数、屈折率、設計の距離、発注者 |
| 判定の基準の表 | ファイルを読む | 発注者ごとの上限と、自社の線 |
| 判定の表・報告書の一覧 | ファイルを書く | 区間ごとの結果 |
| 社内のファイルサーバー | ファイルの保存 | SOR の原本、読み出した JSON、判定の記録 |
SOR のファイルは書き換えません。 原本は処理済みのフォルダへそのまま移し、読み出した結果は別の JSON として保存します。 発注者から問い合わせがあれば、原本を付属のソフトで開いて同じ値を示せます。
案件の台帳にも書き込みません。 判定の結果は判定の表にだけ出し、やり直しの段取りは工事の責任者が台帳に入れます。
人が確認する
- 「再測定」を先に見る … どの心線のどの向き・波長が欠けているかを、翌朝の班の割り振りに入れます
- 「やり直しの候補」の波形を開く … 付属のソフトで両方向の波形を見て、イベントの位置と損失が正しく解析されているかを確かめます
- 「曲げの疑い」の場所を確かめる … 接続箱の中か、ケーブルの途中かを距離から見ます
- やり直しを決める … 工事の責任者と、やり直す点と日程を決めます
- 報告書の表を見直す … 心線の番号と区間の取り違えが無いかを、台帳と見比べます
2番目で波形を開くのを省かないでください。 判定は測定器の解析の結果に頼っているので、測定器が近くの2つの点を1つにまとめていたり、雑音を点として拾っていたりすると、判定も誤ります。 合格の点は開かず、合格以外の点だけを開くことで時間を減らします。
判定を覆したら、理由を一言残します。 「解析の点の位置が違う」「端面の汚れで清掃後に再測定」のように残すと、同じ班・同じ測定器で同じ理由が続くとき、測定の手順を見直す材料になります。
例外に対処する
| 起きること | 対応 |
|---|---|
sorparse の状態が "ok" でない | そのファイルを判定から外し「読めない」。付属のソフトで開けるか確かめる |
| 1心の4つのファイルがそろわない | 区間を判定せず「ファイル待ち」 |
| 心線 ID が中にも名前にも無い | 「どの心線か不明」として外し、班に確かめる |
| 屈折率が台帳のケーブルの値と違う | 「屈折率の違い」。距離の結び付けがずれるので再測定の候補 |
| 接続点にイベントが結び付かない | 損失のしきい値を下回った可能性。両方向とも無ければ「点なし(しきい値未満の可能性)」、片方向だけなら「再測定」 |
| 幅の中にイベントが2つある | 近いほうを選び、「近接の点」の印を付けて人が見る |
| 手で置いたイベントが混ざる | 「手での解析」の印。担当が波形で確かめる |
| 同じ心線・向き・波長のファイルが2つある | 新しい測定の日時のほうを使い、古いほうを記録に残す |
| 基準の表に発注者の行が無い | 判定せずに止める。基準を表に入れてから回す |
5行目の扱いが、この構成でいちばん迷うところです。 損失の小さい良い接続ほど、測定器のしきい値を下回って表に出てきません。両方向とも出てこない点は、良い接続である可能性が高い一方、測定器の設定で隠れているだけかもしれません。 しきい値の値を判定の表に並べ、担当が波形で確かめます。
記録を残す
- SOR のファイルの原本と、受け取った日と現場の班
sorparseで読み出した結果の JSON(ファイルごと)- 判定に使った案件の台帳・接続点の一覧・基準の表の版
- 接続点ごとの両方向・2波長の値、平均、判定、理由
- 人が判定を覆した記録と理由、やり直しと再測定の結果
- 班ごと・測定器ごとの「再測定」と「手での解析」の件数
3つ目で基準の表の版を残すのは、発注者が仕様書を改めることがあるからです。 改める前の区間を改めた後の基準で見直すと、合格だった点が不合格に変わり、どちらで報告したかが分からなくなります。
最後の行は、測定の手順の見直しの材料です。 特定の班や測定器で再測定が多ければ、ファイルの名前の付け方か、屈折率の設定に理由があります。
04実装レベルの3段階
本記事の想定は本格構成です。 1件30分が9分になるのは、ファイルを開いて写す作業と、基準との見比べが自動になり、担当が見るのが合格以外の点の波形と、報告書の見直しだけになるからです。 半自動化で1か月回してから、本格構成に進みます。 表だけを出して担当の判断と並べると、結び付けの幅が足りない区間や、心線 ID の入れ方がばらばらな班が先に見えます。 判定の規則は、その後で基準の表と合わせて作ります。 本格構成のさらに先として、測定の現場で使うことも考えられます。 班がノートパソコンで判定を回せば、その場で再測定の要る心線が分かり、事務所に戻ってからの出直しが減ります。 ただし基準の表と台帳の最新の版を現場で持つ仕組みが要ります。
05工数削減シミュレーション
導入後 80件 × 9分 ÷ 60 = 12 時間/月
自社条件で導入効果を整理したい方へ
このユースケースを自社に当てはめた場合の前提値と削減見込みを、業務ヒアリングをもとに整理します。
06向いている企業・向いていない企業
- 構内・ビル・地域の光ファイバーの敷設と融着接続を請け、工事のあとに OTDR で全心線を両方向から測り、発注者に施工の報告書を出している通信工事会社。測定の結果を担当が測定器の付属のソフトで1本ずつ開き、接続点ごとの損失を表に写している場合。OTDR が Telcordia SR-4731 の SOR 形式でファイルを保存できる場合。
- 月の工事が数区間で、心線の数も少なく、付属のソフトの報告書で足りる場合。片方向しか測らない工事が大半で、2方向の平均を取れない場合。測定器が SOR 形式で書き出せず、独自の形式しか無い場合。なお、やり直すかどうかの決定、発注者の基準の解釈、波形を見ての原因の特定は、この構成では代替できません。
07最小構成で試す方法
- 去年の区間から3つを選び、SOR のファイルを全部集める(やり直しになった点のある区間を1つ入れる)
- Python で pyOTDR を入れ、1つのファイルを読んで、イベントの距離・損失・反射を書き出す
- 同じファイルを付属のソフトで開き、イベントの表の値と並べる
- 3つの区間について、両方向の値を表計算で並べ、平均を出して、当時の報告書の値と比べる
この段階では判定の規則を作りません。 pyOTDR で読んだ値が付属のソフトと一致するか、2方向の平均で、当時のやり直しの点が説明できるかを確かめます。
3番目を必ずやってください。 pyOTDR は作者が見本から読み方を推し量ったもので、自社の測定器のファイルで値がずれれば、その時点でこの読み方は使えません。 一致しなければ、付属のソフトの書き出しの機能でイベントの表を出す形に替えます。
| 出てきた内容 | 判断 |
|---|---|
| 値が付属のソフトと一致し、平均で当時の判断が説明できる | Python の構成に進む |
| 値が一致しない、または読めないファイルがある | 付属のソフトの書き出しを読む形に替える。構成の考え方は有効 |
| ファイルに心線 ID が入っておらず、名前もばらばら | 測定のときの入力とファイルの名前の決まりを先に作る |
08実装時につまずきやすいポイント
| 問題 | 対策 |
|---|---|
| 片方向の値でやり直しの候補が出る | 判定は2方向の平均だけで行う |
| 負の損失を0に切り上げて平均する | 符号を保ったまま足して2で割る |
| 反対の向きの点を取り違える | 区間の長さから引いてA端からの距離にそろえる |
| 測定器が拾わなかった接続点に気づかない | 設計の位置の一覧を先に置き、結び付かない点に印を付ける |
| 屈折率の設定違いで距離がずれる | 読み出した屈折率を台帳の値と比べる |
| 曲げの不良を融着のやり直しに回す | 2つの波長の差を、損失の上限より先に見る |
| 発注者の基準を取り違える | 基準の表を発注者の列で引き、行が無ければ止める |
| 基準の数字を処理の中に書き込む | すべて基準の表から取る |
| pyOTDR の値が付属のソフトと合わない | 使う前に見本で比べ、合わなければ書き出しを読む |
| 反射の値の符号の向きが基準と逆 | 自社のファイルで確かめ、比べる向きをそろえる |
| ファイルが欠けたまま判定する | 1心の4つがそろうまで区間を判定しない |
| 社内の印が報告書に出る | 報告書の一覧は発注者の様式の列だけを書き出す |
上の4行は、2方向の測定の扱いの失敗です。 どれも、片方向ずつ見ていたときの癖がそのまま処理に入ると起きます。符号、向き、拾われなかった点。 この3つを処理の最初に決めておけば、判定はほとんど迷いません。
真ん中の行の多くは、エラーにならずに通る失敗です。 屈折率の違い、基準の取り違え、pyOTDR のずれ、反射の符号。どれも何かしらの合否が出るので、見本の区間で当時の報告書と並べるまで気づけません。
09セキュリティ・AIガバナンス上の注意点
この構成で扱うデータ: SOR のファイル(ケーブル・心線の ID、測定の日時、イベントの値、波形)、案件の台帳(区間の場所、A端とB端の名前、発注者)、発注者の仕様書の基準。区間の場所と端の名前は、発注者の設備の配置そのものです。
- データを外部のサービスに渡さない … 判定は社内のパソコンの Python で行い、生成AIのサービスにも渡しません。通信の設備の配置は、発注者にとって外に出したくない情報です
- 報告書の数字を測定器の解析の結果にそろえる … 自前でイベントを探し直さず、付属のソフトで開いても同じ値になるようにします
- やり直しを自動で決めない … 判定は候補までで、やり直す点と日程は工事の責任者が決めます
- 社内の線と発注者の基準を分ける … 2つの波長の差の線のような自社の線は、報告書の合否に使いません
- オープンソースの条件を確かめる … pyOTDR は GPL-3.0 です。処理を発注者や他社に配るときは、配布の条件を確かめます
- SOR の原本を残す … 原本は書き換えずに保存し、判定の記録と結び付けておきます
誤りが起きた場合のリスクは、問題の無い接続をやり直すことと、問題のある接続を合格として報告することの2つです。 前者は片方向の値で見ると起き、後者は拾われなかった点や読み出しのずれを見落とすと起きます。判定の根拠を2方向の平均と測定器の値に置き、合格以外は人が波形で確かめる形で、この2つを防ぎます。
10まず何から始めるか
1週目:見本で読み方を確かめる
去年の3区間の SOR のファイルを集め、pyOTDR で読んだ値と付属のソフトの表示を並べます。1つでも合わない値があれば、メーカーの解析ソフトの書き出しを読む形に切り替えます。
2週目:現場の決まりをそろえる
測定のときに心線 ID を入れること、ファイルの名前の形、屈折率の設定を、班ごとに確かめて決めます。この決まりが、自動の判定の前提になります。
3週目:基準の表と接続点の一覧を作る
発注者ごとの仕様書から、融着・コネクタ・反射・全体の損失の上限を写し、どの版のどの項目から写したかの列を付けます。 案件の台帳に、接続点の設計の距離の表を足します。
4週目:Python で値を並べる
全ファイルを読み、接続点に結び付けて両方向・2波長の表を出します。判定はまだ出さず、担当の判断と並べます。
2か月目: 判定の規則と報告書の一覧の書き出しを足します。3か月目以降: 判定の記録を取り、班ごとの再測定の件数を見ます。担当が開く波形が合格以外の点だけになり、報告書の写し間違いが出なくなった時点で、この構成は完成です。
11関連ユースケース
12この仕組みを理解するための記事
13技術仕様の確認日・参考情報
| 確認した内容 | 情報源 | 確認日 |
|---|---|---|
pyOTDR が Telcordia SR-4731 第2版に基づく SOR の読み出しの道具であること、規格が公開されておらず限られた見本から読み方を推し量ったと作者が書いていること、誤りが無いことを保証しないこと、pip install pyotdr、Python 3.6 以上、GPL-3.0、JSON・XML での書き出し | GitHub: sid5432/pyOTDR | 2026-11-18 |
sorparse が状態・結果の辞書・波形の点を返すこと、KeyEvents のイベントごとの distance・splice loss・refl loss・type(反射・損失/利得・複数、自動か手か)、距離が屈折率で換算されること、Summary の全体の損失と反射減衰量、GenParams のケーブル ID・心線 ID、FxdParams の波長・屈折率・損失のしきい値(同じリポジトリの read.py・genparams.py・fxdparams.py も確認) | GitHub: pyOTDR keyevents.py | 2026-11-18 |
| PyPI の pyotdr の現行の版が 2.1.1 であること | PyPI: pyotdr | 2026-11-18 |
| モードフィールド径の違いで、片方向の OTDR の測定では接続の損失が過大にも利得にも見えること、正確な測定には2方向の平均が要ること、ANSI/TIA/EIA-455-8-2000 が両方向から測って符号ごと足して平均することを求めていること | CommScope: Gainer or High Splice Loss – The Effects of Mode Field Diameter | 2026-11-18 |
| 1550nm が 1310nm より曲げに弱いこと、同じ接続点・コネクタで曲げが無ければ損失は波長によらずほぼ同じで、2つの波長の差が0.2dB を超えれば曲げによるものとする例 | VIAVI Solutions: Macrobend Detection Using an OTDR | 2026-11-18 |
接続点の損失の上限と合否の決め方は、発注者の仕様書に従ってください。 本記事は上の公開されている資料で確認できた範囲だけを扱っており、特定の発注者の基準の値は確かめていません。
実装ステータス:構成例。 公開仕様に基づいて設計した構成であり、当社で実際に構築・検証したものではありません。工数の数値はモデル条件による試算です。
自社の業務に使えるAI活用候補を整理します
このユースケース(UC-3880)についてのご相談はこちらから。
