Modulo 1: serializacion Hull / Project en formato .arsd (Task 11)
- hull.py: Hull.to_dict() serializa a dict JSON con formato hull_v1 (arrays numpy -> listas Python); Hull.from_dict() deserializa con validacion de claves y forma de array. - project.py: Project.hull (property lazy) deserializa el Hull desde ship_data; Project.set_hull() persiste el Hull y marca is_modified. - main_window.py: _on_new_project guarda el Hull en el proyecto; _on_project_loaded restaura el Hull en todos los visores al abrir un archivo .arsd; _on_hull_changed_from_editor mantiene el proyecto sincronizado con ediciones en el editor de offsets. - test_serialization.py: 26 tests (round-trip dict, round-trip ZIP, 5 familias parametricas, escritura atomica, proyecto sin Hull). Suite total: 112 tests -- 112 passed. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -389,6 +389,76 @@ class Hull:
|
||||
mesh = pv.PolyData(all_pts, faces_arr)
|
||||
return mesh.triangulate()
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
# Serialización JSON (.arsd)
|
||||
# ------------------------------------------------------------------
|
||||
|
||||
def to_dict(self) -> dict:
|
||||
"""Serializa el Hull a un diccionario JSON-serializable.
|
||||
|
||||
Formato interno: ``hull_v1``.
|
||||
Los arrays numpy se convierten a listas de Python para compatibilidad
|
||||
con json.dumps sin dependencias adicionales.
|
||||
|
||||
IACS Rec.34 §6 — trazabilidad de datos de entrada (offsets guardados
|
||||
fielmente con la precisión de la tabla original).
|
||||
"""
|
||||
ot = self.offsets
|
||||
return {
|
||||
"format": "hull_v1",
|
||||
"name": self.name,
|
||||
"lpp": self.lpp,
|
||||
"beam": self.beam,
|
||||
"depth": self.depth,
|
||||
"draft": self.draft,
|
||||
"offsets": {
|
||||
"lpp": ot.lpp,
|
||||
"beam": ot.beam,
|
||||
"draft": ot.draft,
|
||||
"x_stations": ot.x_stations.tolist(),
|
||||
"z_waterlines": ot.z_waterlines.tolist(),
|
||||
"station_labels": list(ot.station_labels),
|
||||
"data": ot.data.tolist(), # (n_sta, n_wl)
|
||||
},
|
||||
}
|
||||
|
||||
@classmethod
|
||||
def from_dict(cls, data: dict) -> "Hull":
|
||||
"""Deserializa un Hull desde un diccionario (leído de un archivo .arsd).
|
||||
|
||||
Compatible con los formatos ``hull_v1`` y datos heredados sin versión.
|
||||
|
||||
Parameters
|
||||
----------
|
||||
data : dict
|
||||
Diccionario generado por ``Hull.to_dict()``.
|
||||
|
||||
Raises
|
||||
------
|
||||
KeyError
|
||||
Si faltan campos obligatorios.
|
||||
ValueError
|
||||
Si las dimensiones de la tabla son inconsistentes.
|
||||
"""
|
||||
od = data["offsets"]
|
||||
offsets = OffsetsTable(
|
||||
x_stations = np.array(od["x_stations"], dtype=float),
|
||||
z_waterlines = np.array(od["z_waterlines"], dtype=float),
|
||||
data = np.array(od["data"], dtype=float),
|
||||
station_labels = od.get("station_labels", []),
|
||||
lpp = float(od["lpp"]),
|
||||
beam = float(od["beam"]),
|
||||
draft = float(od["draft"]),
|
||||
)
|
||||
return cls(
|
||||
name = str(data["name"]),
|
||||
lpp = float(data["lpp"]),
|
||||
beam = float(data["beam"]),
|
||||
depth = float(data["depth"]),
|
||||
draft = float(data["draft"]),
|
||||
offsets = offsets,
|
||||
)
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
# Dunder
|
||||
# ------------------------------------------------------------------
|
||||
|
||||
Reference in New Issue
Block a user