The Weapon Dynamics Computer is intended to be a tool allowing for the transparent computation of the properties of hand-held weapons, swords in particular, from a standardised set of measurements. The tool computes numerical properties and also draws a graphical representation of certain aspects of the mass distribution.
Although the tool is hosted on the web, it operates entirely offline. There is no communication with any server whatsoever once the page has been loaded. The user is given the possiblity to easily share the data but there is no obligation to do so.
The computer is developed and tested on Linux with Firefox and Chromium (in the screenshots below) on this platform. I also test it regularly on Windows with Firefox and Chrome, and on Android with Chrome. In as much as possible, I try to use methods that are cross-platform, but I expect older browsers to have problems with some features. Also, Internet Explorer is absolutely unsupported as of now.
The tool is organised in several panels that rearrange themselves to keep usability depending on the display resolution and window size. The functions of each panel are described in this document.
Sword data can be entered in the 'Measurement' panel. Here is how it looks once filled with data that I just made up:
Here is an explanation of the data. There is one mass in grams, and several points whose position should be measured as signed distances in centimeters with respect to a common reference (the exact reference does not matter as long as it is unique for all the points):
Below this is the needed data to compute rotational inertia, a key aspect of dynamic behaviour. Two alternative methods are possible, selected with the list: waggle tests or pendulum tests. You can fill both, but only the selected, visible one will be used for the computation.
For the waggle tests, the user must provide a list of pivot points pairs. There is one line for each pair, and lines can be added at will by pressing the button. On each line there are:
We shall go over the Theoretical part in the next section!
Details of a possible experimental setup for pendulum tests can be read in this article.
For the pendulum tests, the user must provide a list of times measured at pivot points. The times measured must represent a given number of periods of oscillation, entered in the Number of periods timed field. As before, lines can be added at will by pressing the button. On each line there are:
Aside from these inputs, each lines includes a stopwatch. Just press the button and the stopwatch starts (the button becomes red). Press it again, and the stopwatch stops, and a dialog pops up for confirmation. If you accept the measurement it is automatically reported in the text field.
We shall go over the Error part in the next section!Back to contents
The computed properties are:
In addition to these, for each pivot point a theoretical value is computed and displayed in the measurements panel. If there is too big a discrepancy between the practical and theoretical values, it might be a good idea to double check the centre of gravity and the pivot points. For pendulum tests, an error value is displayed for each measured time. If it becomes too big, more than 0.2s, or if it is biased depending on the location of the axis of rotation, there might be a problem with the pendulum device or the measurement of the center of gravity.
The properties are computed on the fly, and some properties need less data than others.
A table of computed values, for all the swords in the database, is built and accessible via the link in this panel.Back to contents
As data is being entered a diagram is build. That diagram represents both the measurements and the properties that can be computed based on them. The diagram for the measurements illustrated previously looks like this:
The light blue cross shape represents the sword, with the longitudinal axis horizontal and the tip to the right, the vertical bar being at the grip reference. The vertical black line marks the Center of Gravity. The blue area is the curve of the effective mass along the axis. The shapes in light gray represent the agility of the sword in rotation (hourglass) and translation (oval). The length of the curve at the tip is inversely proportional to the Tip Rotational Inertia.
Through the axis of the weapon you see several vertical red ticks. These are the locations of the action points and the associated theoretical pivot points. There are also red ellipses. These mark the location of the practical pivot points that have been measured. Their horizontal size is inversely proportional to the relative confidence of that pivot pair. Their opacity also reflects the confidence, so that a point with a very small confidence will result in an ellipse that is very transparent and very spread along the axis. That data appears on the graph as soon as you have entered something in waggle tests, even if the computation is done with pendulum tests. This gives a way to display pivot points even when you have not measured them.
On the blade there is a dark blue dashed line. This marks the location of the blade node. On the hilt above the sword's axis there is another similar line, that marks the measured hilt node. Under the axis, continuing in the effective mass curve, is a third dashed line that marks the pivot point associated to the blade node. Observing the offset between the last two lines shows how close the nodes are to being associated pivot points depending on the sword. On many examples, the hilt node and the blade node pivot are very close.
Clicking on the link above the diagram will start the 'download' of an SVG file. I'm putting quotes here because no data whatsover will transit over the network: the browser is simply letting you save the generated content. The SVG file should open in any decent vector graphic program: it can be edited in Inkscape for sure and Adobe Illustrator probably.
The scales of the diagram are written above it. There are two modes depending on what is checked in the Diagram Options panel. When the option 'Scale to constant length' is checked, the sword are scaled so that they all occupy the same length. When it is not checked, the scale of the diagram is the same for all the swords.
Back to contents
The tool has the capability to build a database of swords. This section outlines the management of that database. The management panel is this one:
To add a sword to the database, simply give it a name and press the 'Add' button! If you make further edits to the measurements of that sword, press 'Add' again and it will update the data. You will be prompted for confirmation to avoid involuntary overwriting of precious data.
If you want to start a new sword from scratch, you can press the 'New' button.
There is a drop-down menu just under the 'Weapon list:' text. When you click it the whole list of the saved swords is displayed. You can then select a sword, which will update all the other elements: measurements, computed data, diagram.
You will be prompted for confirmation before switching to another existing sword, if you have made modifications to the data that have not been added to the base yet.
Once a sword is selected you can modify its measurements, and either update the current version (if you leave the name unchanged) or add it as a new element (when you have changed the name).
If desired, you can remove swords from the list by hitting the 'Remove' button. Again confirmation will be asked.Back to contents
Once you have started a nice database of swords, you will probably want to save it and get back to it later to look at the data or expand it, or share with others. There are two main ways of doing this.
In the Measurements panel there is a clickable link labeled 'Permalink to this weapon'. Clicking it will pop-up a dialog proposing you to copy a link. Anyone you share this link with will be brought to the Dynamics Computer, filled with the data about your current sword. This is intended as a way to quickly and widely share data with the world. There is currently no attempt to ensure confidentiality when the recipient(s) follow the link, which means that you probably should not use this process if you want to share with selected individuals. In this case see the next section!
There are two links that allow you to save data. The first is in the Measurement panel, 'Save this weapon'. The second is in the Database pane, 'Save the database'. In both cases, they allow to save data as a JSON file, containing either just the current weapon or the whole database. It is then possible to share or store these files anyway you see fit. As with the diagram no data transits over the network, the browser is just letting you save local data.
The files can of course be loaded back into the tool. Clicking on the file selector under 'Data to load' will bring up a file dialog allowing you to pick a data file on your computer. Then you have two options:
In both cases confirmation is sought to prevent data loss. You can test this now by loading this file. It contains a selection of my own swords measured with the waggle test and pendulum test.
I will strive to always keep compatiblity with these data files through the future versions of the tool, or at the very least provide conversion tools. As with any computer work, saving early and often is advised! When you load an old database version, an alert will pop up and warn you to save again.Back to contents