Perform various data analysis on SEC 13-F and obtain some insights of fund activities such as number of holdings, AUM, and change of holdings between two quarters.
日本語の概要は準備中です。原文の説明を表示しています。
Subtour-elimination methods for TSP, VRP, pickup/dropoff routing, and routing MIPs with binary arc variables. Use when route-continuity constraints may permit disconnected cycles and the model needs MTZ constraints, flow-based connectivity constraints, DFJ subset cuts, or lazy/iterative subtour cuts.
インストールする前に、エージェントに与えられる指示の中身を確認できます。
In routing MIPs, degree and continuity constraints are not enough. A vehicle can have one depot-to-depot path and a separate closed cycle among stations. Add subtour-elimination constraints whenever binary arc variables decide routes.
Use this base notation:
START = "depot_start"
END = "depot_end"
vehicles = range(K)
stations = range(n)
from_nodes = [START, *stations]
to_nodes = [*stations, END]
arcs = [(i, j) for i in from_nodes for j in to_nodes if i != j and not (i == START and j == END)]
x = {(v, i, j): model.addVar(vtype="B", name=f"x_{v}_{i}_{j}") for v in vehicles for i, j in arcs}
Subtour elimination assumes each selected station has matching inbound and outbound route arcs.
for v in vehicles:
model.addCons(quicksum(x[v, START, j] for j in stations) == 1)
model.addCons(quicksum(x[v, i, END] for i in stations) == 1)
for i in stations:
incoming = quicksum(x[v, j, i] for j in from_nodes if j != i)
outgoing = quicksum(x[v, i, j] for j in to_nodes if j != i)
model.addCons(incoming == outgoing)
model.addCons(outgoing <= 1)
The subtour methods below prevent station-only cycles that are disconnected from START.
MTZ adds an order variable for each vehicle-station pair. If vehicle v travels from station i to station j, then order[v, j] must be greater than order[v, i].
order = {
(v, i): model.addVar(vtype="C", lb=1, ub=max(1, n), name=f"order_{v}_{i}")
for v in vehicles
for i in stations
}
for v in vehicles:
for i in stations:
for j in stations:
if i != j:
model.addCons(order[v, i] - order[v, j] + n * x[v, i, j] <= n - 1)
Pros:
O(K n^2) constraints and O(K n) extra variables.Cons:
Use MTZ first when correctness and implementation speed matter more than best possible MIP strength.
Add an artificial connectivity flow that starts at the depot and sends one unit to every visited station. This flow is not physical vehicle load.
visit = {
(v, i): quicksum(x[v, i, j] for j in to_nodes if j != i)
for v in vehicles
for i in stations
}
flow_arcs = [(i, j) for i in [START, *stations] for j in stations if i != j]
f = {
(v, i, j): model.addVar(vtype="C", lb=0, ub=n, name=f"conn_flow_{v}_{i}_{j}")
for v in vehicles
for i, j in flow_arcs
}
for v in vehicles:
total_visits = quicksum(visit[v, i] for i in stations)
model.addCons(quicksum(f[v, START, j] for j in stations) == total_visits)
for i, j in flow_arcs:
model.addCons(f[v, i, j] <= n * x[v, i, j])
for i in stations:
incoming_flow = quicksum(f[v, h, i] for h in [START, *stations] if h != i)
outgoing_flow = quicksum(f[v, i, j] for j in stations if j != i)
model.addCons(incoming_flow - outgoing_flow == visit[v, i])
Pros:
Cons:
O(K n^2) continuous variables.Use this when MTZ gives weak incumbents or slow progress and the instance is still modest in size.
For every nonempty proper subset S of stations, selected station-to-station arcs inside S cannot form a closed cycle:
sum_{i in S, j in S, i != j} x[v,i,j] <= |S| - 1
For very small n, static enumeration is possible:
from itertools import combinations
for v in vehicles:
for r in range(2, n):
for S_tuple in combinations(stations, r):
S = set(S_tuple)
model.addCons(
quicksum(x[v, i, j] for i in S for j in S if i != j) <= len(S) - 1
)
Pros:
Cons:
Use static DFJ only for tiny instances or as a debugging baseline.
The strongest practical pattern is to solve with base route constraints, detect subtours in incumbents, add only the violated DFJ cuts, and continue.
In solvers with convenient lazy callbacks, add cuts during branch-and-bound. Some Python solver APIs require callback or constraint-handler plumbing for true lazy enforcement, so iterative cut separation is often simpler for portable benchmark code:
def selected_arcs(model, x, v, arcs):
return [(i, j) for i, j in arcs if model.getVal(x[v, i, j]) > 0.5]
def station_cycles_without_start(selected, stations):
succ = {i: j for i, j in selected}
cycles = []
seen = set()
for start in stations:
if start in seen or start not in succ:
continue
path = []
cur = start
pos = {}
while cur in succ and cur not in pos and cur not in seen:
pos[cur] = len(path)
path.append(cur)
cur = succ[cur]
seen.update(path)
if cur in pos:
cycle = path[pos[cur]:]
if START not in cycle and END not in cycle:
cycles.append(cycle)
return cycles
while True:
model.optimize()
if model.getNSols() == 0:
raise RuntimeError(f"no feasible solution; status={model.getStatus()}")
cuts_added = 0
for v in vehicles:
selected = selected_arcs(model, x, v, arcs)
for cycle in station_cycles_without_start(selected, stations):
if len(cycle) >= 2:
S = set(cycle)
model.freeTransform()
model.addCons(
quicksum(x[v, i, j] for i in S for j in S if i != j) <= len(S) - 1
)
cuts_added += 1
if cuts_added == 0:
break
Pros:
Cons:
Use this when static MTZ is too weak and the solver environment does not make lazy callbacks convenient.
| Method | Best For | Avoid When |
|---|---|---|
| MTZ | Quick, compact, small/medium MIPs | Large hard VRPs where relaxation strength matters |
| Single-commodity flow | Stronger static connectivity, optional visits | Memory is tight, or n is large |
| Multi-commodity flow | Very strong small routing models | Most practical benchmark tasks; too many variables |
| Static DFJ | Tiny instances, debugging | More than roughly 15-18 stations without careful filtering |
| Lazy/iterative DFJ cuts | Strong routing models with many possible SECs | Solver API/callback complexity is too risky |
For pickup/dropoff rebalancing, start with MTZ or artificial connectivity flow. Do not use physical truck load as the only subtour-elimination mechanism because pickup/dropoff load can increase and decrease and may not prove route connectivity.
After solving, reconstruct each route by following selected arcs:
def extract_route(selected):
outgoing = dict(selected)
route = [START]
cur = START
seen = {START}
while cur != END:
if cur not in outgoing:
raise RuntimeError(f"route disconnected at {cur!r}")
cur = outgoing[cur]
if cur in seen and cur != END:
raise RuntimeError(f"cycle detected at {cur!r}")
route.append(cur)
seen.add(cur)
return route
Fail fast if a selected solution has a disconnected cycle, repeated station, missing depot start, or missing depot end.
まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
Perform various data analysis on SEC 13-F and obtain some insights of fund activities such as number of holdings, AUM, and change of holdings between two quarters.
日本語の概要は準備中です。原文の説明を表示しています。
AC branch pi-model power flow equations (P/Q and |S|) with transformer tap ratio and phase shift, matching `acopf-math-model.md` and MATPOWER branch fields. Use when computing branch flows in either direction, aggregating bus injections for nodal balance, checking MVA (rateA) limits, computing branch loading %, or debugging sign/units issues in AC power flow.
日本語の概要は準備中です。原文の説明を表示しています。
Redact text from PDF documents for blind review anonymization
日本語の概要は準備中です。原文の説明を表示しています。
Use when checking simplified ADA-derived plan-view bathroom accessibility constraints such as turning space, door clear width, toilet centerline, grab bars, and lavatory knee/toe clearance.
日本語の概要は準備中です。原文の説明を表示しています。
Analyze failed GitHub Action jobs for a pull request.
日本語の概要は準備中です。原文の説明を表示しています。
Use when extracting plan-view architectural geometry from DXF files with semantic CAD layers, especially when outputs must normalize rooms, doors, fixtures, clearances, and grab bars into machine-checkable JSON.
日本語の概要は準備中です。原文の説明を表示しています。