Skip to main content

Archibald 2.1.0 ⛵✏️

by Jules Richeux

Tests Python 3.11+ PyPI License: MIT

Archibald is a Python 3 library for performance prediction and preliminary design of sailboats, motor boats and ships. From a hull mesh, sail and foil outlines and a list of masses, it computes how the boat floats, heels, trims and sails.

  • 🎓 Built for naval architects and engineers use cases in mind. Still under development, though its modules can already be used on their own.
  • ✏️ Imports Rhino and AutoCAD drawings directly, so you can quickly test design choices and see how they affect performance.
3D view of a 49er skiff on the water plane, sails coloured by pressure coefficient, with streamlines around the sails and the appendages

A skiff in 20 kt of wind. Boat speed and leeway of a 49er, held upright, with placeholder masses.

3D view of the Molenez cargo sailboat with two wing sails coloured by pressure coefficient, streamlines, and arrows for weight, buoyancy, sail, hull, appendage and propeller forces

A cargo ship under wings and propeller. Draft, heel, trim, leeway and rpm of the Molenez, with the forces in balance. Yaw is not balanced and the propeller is a placeholder.

Hull, rig, appendages, foils and propellers all live in one model of the boat, and any number in it can become an unknown: a draft, a sail trim, a crew position, a pitch ratio. You choose what is free, which forces count and what must balance, and a gradient-based optimizer does the rest. The same model answers "how fast does she go?" and "what should I change to go faster?".

pip install archibald-design

What it does · Projects · Methods · A first equilibrium · Getting started · Validation

✍️ Projects built with Archibald

Archibald 1.0.0 was widely used in the following student projects:

MOLENEZ II - Sailing general cargo ship for Ponant Islands feeding

Molenez II Render Molenez II Sail plan Molenez II Stability

NEREUS - Fast humanitarian aid vessel (tested in Centrale Nantes' towing tank)

Nereus render Nereus towing tank Nereus Stability

PAKI'AKA - Radical and high-performance bamboo 18ft skiff

Paki'aka render 1 Paki'aka render 1

Used Archibald on a boat of yours? Tell us about it.

⚡ What can you do with it?

Click an image to open the script that produced it.

🚢 Hull resistance

Residuary resistance of the Delft series against Froude number and predicted against measured for 44 hulls

Delft Systematic Yacht Hull Series against the tank data of 44 hulls. The published polynomial follows the data; the function as shipped reads low at high Froude numbers (details).

Michell wave resistance of the Wigley hull against an independent integral and measurements, and mesh volume error against hull length

Michell thin ship theory on the Wigley hull, against an independent integration and measurements. The right magnitude, with the exaggerated humps and hollows the theory is known for.

Bar chart of resistance components at 25 knots, Holtrop and Mennen 1982 against Archibald

Holtrop & Mennen against the worked example of the 1982 paper. The differences come from the later formulas used by the module.

Added resistance of the KVLCC2 in head seas against wavelength, with a prediction interval, and the DSYHS added resistance table

Added resistance in waves. Mittendorf et al. on the KVLCC2 against another code (PRECAL), and the DSYHS table.

⛵ Multihulls

Wave interference factor against Froude number at three hull separations, and viscous interference against separation

Interference between hulls from thin ship theory and from regressions, at three separations. These models disagree with one another above Fn 0.37, and tank data is still needed to judge them.

🌀 Propellers and windage

KT, KQ and open water efficiency of a B5-75 propeller against advance coefficient for four pitch ratios

Wageningen B-series. Open water curves against published design points. Rpm and pitch ratio can be unknowns of the equilibrium.

Wind coefficients of a loaded container ship and drag area of one crew member against apparent wind angle

Windage of superstructures and crew. The two crew models are inverted between head and beam wind, an open point against the ORC document.

🔎 What's inside

On the boat Methods
Hydrostatics Immersed volume, centre of buoyancy and hydrostatic coefficients from the hull mesh, at any heel and trim
Calm water resistance DSYHS, Holtrop & Mennen, Michell, Savitsky (planing)
Hull side force Jones, Inoue, Kijima
Added resistance in waves Savitsky & Brown, Mittendorf et al., DSYHS
Multihull interaction Michell, Jamaluddin, Miyazawa, and your own Insel & Molland tables
Sails, keels, rudders and foils Vortex lattice with NeuralFoil section polars and a wind gradient, with water or air density at each panel depending on its side of the free surface
Propellers Wageningen B-series, with wake fraction and thrust deduction as inputs
Windage Day, Blendermann, ORC
Weights A list of masses with their centres of gravity, any of which can be unknown
Drawing Interactive 3D views with pressure, animated streamlines and force arrows (PyVista, Plotly)

Geometry comes in from your CAD tool: hulls as STL meshes, sails and foils as DXF outlines.

🐍 A first equilibrium

What draft, trim and rpm does a ship need at 8 kt? Three steps: what is free, what acts on the boat, what must balance. Run it from examples/03 - Geometry, where the hull mesh is. The mass is only illustrative.

from archibald.dynamics.hydro import dsyhs
from archibald.geometry import Hull, Sailboat
from archibald.geometry.propeller import BSeriesPropeller
from archibald.optimization import Opti
from archibald.performance import OperatingPoint
from archibald.weights import MassProperties

# The boat: a hull mesh, a propeller, and the masses it carries
propeller = BSeriesPropeller(
    blades_number=4,
    blade_area_ratio=0.65,
    pitch_ratio=1.0,
    diameter=2.5,
    xyz_center=[1.0, 0.0, 0.5],
)
boat = Sailboat(
    hulls=[Hull(name="hull", mesh="data/molenez2_data/hull.stl")],
    propellers=[propeller],
    masses=[MassProperties(mass=124e3, x_cg=12.4, y_cg=0., z_cg=2.3)],
)

# What is free: any number can become a variable of the problem
opti = Opti()
draft = opti.variable(init_guess=1.3, lower_bound=0.2, upper_bound=4.)   # [m]
trim = opti.variable(init_guess=0., lower_bound=-10., upper_bound=10.)   # [deg], positive bow down
propeller.rpm = opti.variable(init_guess=150., lower_bound=30.)          # [rpm]
op_point = OperatingPoint(stw=8., dz=-draft, trim=trim)                  # 8 kt through the water

# What acts on the boat
boat.compute_weight(op_point)
boat.compute_buoyancy(op_point)
boat.compute_resistance(
    op_point,
    method={
        "Rf": dsyhs.compute_Rf_dsyhs,
        "Rw": dsyhs.compute_Rw_dsyhs,
        "Rtr": dsyhs.compute_Rtr_dsyhs,
    },
    Csternchoice=1,
    Bulbchoice=0,
)
boat.compute_propellers(op_point, wake_fraction=0.2, thrust_deduction=0.15)
Ftot, Mtot = boat.compute_torsor(op_point)

# What must balance: surge, heave and pitch
sol = boat.find_equilibrium(
    opti,
    Ftot,
    Mtot,
    dofs=["Fx", "Fz", "My"],
    force_scale=1e4,
    moment_scale=1e5,
    verbose=False,
)

print(f"Draft {sol(draft):.2f} m, trim {sol(trim):+.2f} deg, {sol(propeller.rpm):.0f} rpm")
print(f"Brake power {sol(propeller.performance)['BHP'] / 1e3:.0f} kW")
Draft 1.27 m, trim +0.34 deg, 86 rpm
Brake power 29 kW

Add opti.minimize(...) and the same script becomes a design optimization: molenez_propulsion.py also moves cargo to stay upright and picks the pitch ratio for the least power.

🏁 Getting started

pip install archibald-design

This needs Python 3.11 or later.

Then pick the folder that fits:

Folder What you get
00 - Templates Start here for your own boat. Fill-in templates for a motor ship, a cruising monohull, a multihull, a planing boat, a foiling motorboat and a foiling racing monohull
01 - Validation Each model against published data, with its figures
02 - Modeling Fitting and interpolation tools for your own data
03 - Geometry Examples on real geometry: the Molenez cargo sailboat, the 49er skiff, the Nacra 15 catamaran

An operating point takes speeds in knots and angles in degrees. Axes are x forward, y to port, z up, with the water at z = 0.

✅ How far can you trust it?

Archibald is an engineering-level tool for preliminary design, and its methods hold only within their range of validity. The validation page states for each model what it was compared with, what agrees, what does not, and which data is still missing. Few of these comparisons are against measurements so far, and some methods are not validated at all.

Tank results, published tables and a number that looks wrong are all welcome, and you do not need to write code to help: see how to contribute.

🙏 Credits

Archibald is forked from the amazing AeroSandbox by Peter Sharpe, the source of its optimization framework and vortex lattice core. Section polars come from NeuralFoil, also by Peter Sharpe, and the equations are solved with CasADi and IPOPT. Archibald 2.0 was developed during the author's time at NEOLINE.

The papers behind each method are cited in the docstring of its module.

🤝 Contributing

See how you can help Archibald evolve.

⚖️ License

MIT.

Metadata

Release files for archibald-design 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for archibald-design 2.1.0
File Size Uploaded Provenance Actions
archibald_design-2.1.0.tar.gz 5.4 MB With provenance Details for archibald_design-2.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for archibald-design 2.1.0
File Interpreter ABI Platform Actions
archibald_design-2.1.0-py3-none-any.whl Python 3 none any Details for archibald_design-2.1.0-py3-none-any.whl

Total release size: 12.0 MB

Release files / archibald_design-2.1.0.tar.gz

Download URL archibald_design-2.1.0.tar.gz
Size 5.4 MB
Tags Source
SHA-256 checksum
How to use checksums
9a71169193ebb88c76ac744841b54eea623c864459dfddfca89805b707dea6f6
BLAKE2b-256 checksum
How to use checksums
f195081e6e5702a296da1b693b936bcdf0e78936f78b526e0737eb84edc0c491
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / archibald_design-2.1.0-py3-none-any.whl

Download URL archibald_design-2.1.0-py3-none-any.whl
Size 6.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ef579b10cd838c640095e5360b8fab1b13956b4436c6d79d39a1b6adfa58332c
BLAKE2b-256 checksum
How to use checksums
fd22ba1143044572dc02240d84b9488f82dfb945c42be2b1c6b447dcb6ba8446
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Security for archibald-design 2.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for archibald_design-2.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page