Archibald 2.1.0 ⛵✏️
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.
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 |
NEREUS - Fast humanitarian aid vessel (tested in Centrale Nantes' towing tank) |
PAKI'AKA - Radical and high-performance bamboo 18ft skiff |
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
|
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 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. |
|
Holtrop & Mennen against the worked example of the 1982 paper. The differences come from the later formulas used by the module. |
Added resistance in waves. Mittendorf et al. on the KVLCC2 against another code (PRECAL), and the DSYHS table. |
⛵ Multihulls
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
🔎 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.