Making ship data flow from a single entry into every calculation sheet and report takes more than the phrase "central database." You first have to decide what counts as a single object, which system's value is recognized as official, and what each cell in the workbook actually means. The heart of the technology is not storing data — it is writing the contracts between the work processes.

What "enter it once" actually means

Saying that data should be entered only once is easy. But on a ship project, the same piece of equipment carries different values at different stages. Concept design uses an estimated weight from a reference vessel; basic design brings in preliminary vendor data; detail design reflects the confirmed value on the approved drawing. After installation, an actual weighed value or a field change may be added on top.

So entering data once does not mean the value is fixed forever. It means keeping the official value for each stage — and the evidence behind it — in one place, so that every calculation sheet references the right version. The weight calculation sheet may use the design weight, the procurement document the contract weight, and the production plan the actual transport weight. Different values are allowed, but the difference and the ownership must be explicit.

Equipment P-2101Central Cooling Water Pump · example of an official object
Object IDEQ-P-2101 · identifier held across the whole project
Design weight12.6 t · Basic Design Rev. B
Contract weight13.1 t · Vendor Datasheet Rev. 03
Installed locationEngine Room · Deck 02 · Frame 88–92
Center of gravityLCG 74.82 m · TCG -1.20 m · VCG 8.45 m
Source of recordVendor Data: Procurement · Location: 3D model · Status: PMT
Linked documentsEquipment List · Weight Report · Foundation Drawing · Lifting Plan
Review statusVendor Confirmed · Weight Review Pending
Figure 1. A central object does not flatten everything into a single value. It holds the stage-by-stage values, the source of record, the linked documents and the status together, so it is clear which calculation should use which value.

A ship data model starts with relationships, not geometry

Say "central ship model" and most people picture 3D geometry first. Geometry matters, of course. But if the goal is to connect Excel to the way work actually runs, relationships matter more. Which compartment does the equipment sit in, which system does it belong to, which support structure and power supply does it use, which procurement package is it tied to? Which Deck and Frames is the tank between, what fluid does it hold, under which loading conditions is it used?

Express those relationships as an object graph and the same data gets reused across many tasks. Compartment area and volume can flow into painting, insulation, HVAC, fire protection and cost estimating calculations. Equipment weight and position connect to weight control, support structures, transport and lifting plans. Pipe line diameter and material carry through to quantities, procurement, fabrication and test records.

Vessel·ProjectShip type, principal particulars, contract terms, design stage and standard revisions
Spatial StructureZone · Deck · Compartment · Tank · Coordinate System
Physical ObjectsEquipment · Pipe · Cable · Structure · Outfit Item
Engineering PropertiesWeight, material, capacity, pressure, temperature, class, status
Documents & ModelsDrawings, 3D models, datasheets, calculation sheets, reports
Process & GovernancePreparation, review and approval; procurement, fabrication and installation status; change history
Ship Engineering Knowledge GraphThe relationship layer that connects objects, documents, calculations, ownership and status
Figure 2. A ship data model is not a list of objects. It is a web of relationships linking space, systems, documents and work status.

Between Excel and the central model you need a "Workbook Contract"

The most dangerous way to connect Excel to a data model is to knock together a script that pushes values into specific cells. Add one column, copy one sheet, and the link breaks — and nobody can explain who used that cell or why.

Define a Workbook Contract for each calculation sheet instead. It is a contract that states what inputs the sheet requires, what results it produces, and which units and conditions it assumes. Use Named Ranges where you can; where you cannot, store the cell address together with the surrounding labels and the formula dependencies. The contract should cover mandatory inputs, allowable ranges, the meaning of a blank value, the official source, the conversion rules and the calculation version.

An example of cell mapping

Weight_Control.xlsx · Equipment_Input!D18 is not stored as a bare address. It is managed as a single input contract: `Equipment.Weight.Design`, unit `t`, Object ID `EQ-P-2101`, Source `Vendor Datasheet Rev.03`, conversion `kg→t`, status `Review pending`.

01Workbook analysisIdentify inputs, outputs, formulas, Named Ranges, external links, VBA and protected areas.
02Semantic mappingBind cells to domain properties such as equipment weight, compartment volume or tank capacity.
03Data injectionFeed the designated inputs from the official source, applying the unit conversion rules.
04Deterministic executionRun the formulas identically in the original Excel or a compatible calculation engine.
05Result registrationStore the outputs, the input snapshot, the calculation version and any errors or warnings in the central history.
06Difference approvalA reviewer confirms the delta against the previous revision before the result becomes official.
Figure 3. A Workbook Contract is the interface that connects existing calculation sheets to central data safely — without destroying the sheets.

Do not try to own every value at the center

The central data layer should direct traffic, not monopolize the data. The vendor-confirmed weight of a piece of equipment can be owned by the procurement or vendor document system, the installed position by the 3D model, the production status by MES or a shop-floor system. The central layer remembers the source of record and the last revision for each property, and delivers it where it is needed.

Splitting ownership by property also lets you handle conflicts more precisely. When the equipment weight in the 3D model differs from the weight on the vendor datasheet, the system must not silently pick one. It should show that "the model says 12.6 t, the vendor says 13.1 t, and procurement owns the record," then propose either a model update or an exception approval.

One database owns every value

Arguments restart over whether the source system or the central database is current
Sync intervals and sync failures create fresh inconsistencies
The person accountable for the work waits for edit rights in the central system
Project-specific exceptions quickly bloat the common schema

Each property is linked to its source of record

Every value has a designated official Source of Record
The central layer manages identifiers, meaning, versions and relationships
Conflicts are not hidden; the difference and the owner are shown
Project-specific extensions are absorbed by Domain Packs and mappings
Figure 4. A federated structure is not a retreat from integration. It is a stricter definition of which system is accountable for which fact.

How a pump weight change actually travels

Take the earlier pump case again, now inside a connected structure. When vendor datasheet Rev.03 is approved, a document parser reads the equipment tag, the weight and the candidate center of gravity. The system computes the difference against the current official value and asks the procurement owner to confirm it. Once approved, the contract weight of `Equipment P-2101` and its supporting document are updated.

Then the impact graph goes to work. The input cell in the weight control sheet, the equipment foundation check, the lifting plan and the lightship weight report are all flagged as candidates for impact. Each calculation is re-run automatically in a sandbox, but the official result is never overwritten on the spot. The delta against the previous revision, the allowable margin, and any errors or warnings are shown to the reviewer — and only approved results enter the project baseline.

Vendor document receivedTag, weight and CG candidates are extracted from the Rev.03 datasheet.
Difference detectedThe existing 12.6 t, the new 13.1 t and the VCG shift are shown side by side.
Owner confirmationThe procurement owner approves the official value and its effective date.
Impact traversalLinks to weight tables, foundations, lifting and reports are followed to find what must be rechecked.
Sandbox recalculationResults and warnings are produced from the new inputs without overwriting the original.
Review and baseline updateOnce the engineer approves the difference, the revision and audit trail are locked in.
Figure 5. The point of automation is not "overwrite with the new value." It is to bind detection, impact, calculation and approval into a single transaction.

Before you need an API, you need standard units and states

Integration projects usually fail technically not because there was no API, but because the meanings did not line up. Estimated, Design, Vendor and Installed Weight are all different weights; coordinate references and sign conventions differ; even the definition of a status value differs between departments. Connect an API without resolving that, and all you have done is let the errors travel faster.

The first schema should be small. Object ID, name, classification, unit, value type, source of record, revision, effective date and confidence status is enough to begin. Do not try to standardize every property up front — define only the values the chosen workflow genuinely needs. Accumulating a glossary and a set of mapping rules as more projects come through is the realistic path.

What a web-based calculation workbench must put on screen

The user interface should mirror the data structure directly. Ship objects and drawings on the left, the same calculation flow as the existing Excel in the middle, and source, changes and review status on the right is a good arrangement. Users can modify the formulas, but every change is kept as a version and compared automatically against the reference case.

The feature that matters is not an AI chat box. It is being able to answer "where did this cell's value come from," "why does this result differ from the previous revision," and "which documents are affected if I approve it" in one or two clicks. AI should take those questions in natural language, traverse the connected data, and let the user open the underlying evidence region and the calculation path for themselves.

Why did the lightship weight increase by 0.5 t?

The Vendor Confirmed Weight of P-2101 changed from 12.6 t to 13.1 t. The weight control sheet already reflects the +0.5 t, but the equipment foundation check still uses the Rev.B input and needs to be re-run. Confirmation by the structural owner is required before it is applied automatically.
Vendor Datasheet Rev.03Page 4 · Operating Weight
Weight Control WorkbookEquipment_Input!D18
Foundation Check Rev.BInput Sheet · P-2101
Figure 6. A good AI interface does not just state the answer. It shows where the value came from, which cell in which sheet, which documents are not yet updated, and who approves next.

A central model is not a data store — it is a path for trust

Connecting ship data to Excel is not a simple auto-fill project. You have to design the meaning of the objects, the stages of each value, the source of record, the calculation contract and the approval procedure together. Once that structure is in place, the Excel a shipyard has accumulated over decades stops being a set of isolated files and becomes a reusable calculation service.

The next article looks at what to hand to AI on top of this — and what not to. Instead of pretending AI will design the ship for you, it deals with the realistic role: connecting the evidence behind a calculation and making sure the impact of a change is never missed.

doAZ Point of View

The ship calculation platform doAZ is building rests on the combination of Ship Model, Workbook Contract, Provenance Graph and Change Workflow. Bolting on a chat interface before the data is connected looks convenient, but it makes verification and scale far harder over time.

YT
Youngtae Kim · CEO · doAZ

Working across construction and engineering sites, R&D, and the industrial AI business, thinking about how to connect the knowledge scattered through drawings, documents and calculation sheets. This series is an open record of the product philosophy and field direction doAZ is pursuing.