Angelstow Frequently Asked Questions

Table of Contents

1. Container editing

1.1. Q: How can I generate new containers?

A: Click File→Generate Container List and add the wanted number of containers. Setting the UN codes / IMDG classes is done afterwards e.g. using the Modify containers dialog.

1.2. Q: How can I edit one or more containers?

A: Select the containers you want to edit and choose the Edit→Modify Containers action. Then modify the needed features in the dialog. Individual containers can be edited in the different tables (currently only the DG codes).

2.1. Q: How can I select containers for placement?

A: The simplest way to select containers for placement is to open a recap (View→Add Recap, Ctrl+R), clear the filter (right-click in the upper left corner and select filter→clear) and select the Unplanned Filter (select filter→Unplanned)

2.2. Q: How can I configure the recap to only show me the Remaining On Boards?

A: There is currently no Remaining On Boards filter. The short term way to work around this is to open two recaps with the Traversing filter, and then further filter these reacaps with respectively "Stowage Status→Loaded" and "Stowage Status→On-board"

2.3. Q: How can I arrange the recap such as to aggregate by say DG status and then POD?

A: Explanation requires a screen shot.

2.4. Q: How can I select on-board containers?

A: Normal select will only select containers loaded in this port. Selecting containers that were on-board on arrival is done by pressing the Ctrl modifier key while selecting.

2.5. Q: How can I find containers from their equipment ID?

A: Open the Edit→Find containers dialog and paste in the list of the equipment IDs you want to find. The containers will subsequently be included in selection that can be used for further processing. Note that equipment ID text should not contain a whitespace.

3. Container stowing and placing

3.1. Q: How can I force the placement of containers?

A: Place the containers (left click) while pressing down the Ctrl button.

3.2. Q: How can I unstow containers?

A: Select the containers you want to unstow, then press Backspace (or right-click→choose "Unstow")

3.3. Q: How do I place a single 20' container?

A: Angelstow by default places twin 20' container in one click. If you want to place a single container at the time, for instance if working with special containers, choose "Settings"→"General Settings"→Uncheck "Pair 20' containers"

4. Dangerous Goods

4.1. Q: What is the syntax for defining the UN codes of a container?

A: When defining the DG profile of a container, you only need to indicate the UN number of the containers - the IMDG classes will be automatically determined from the UN codes. The syntax is a whitespace separated list of 4-digit UN codes, with an optional "L" appended to indicated limited quantities.

Example: "1250L 3484 3486" (without the quotes)

5. EDIFACT import/export

5.1. Q: How can I import a Baplie?

A: Choose File→Import Edifact and select the Baplie file you want to import. If the call’s port code and voyage number match, the file will be imported without any further prompts. If the codes do not match, you will need to map the ports. Ports prior to the current port can safely be mapped to "Befor".

5.2. Q: How can I import a Coprar?

A: Choose File→Import Edifact and select the Coprar file you want to import.

6. Excel import/export

6.1. Q: How can I import a container list in Excel format?

A: In order to import a container list from Excel, you need to convert the spreadsheet to either a COPRAR or, if the containers have positions on the vessel, a BAPLIE. Converters are available at and respectively.

6.2. Q: How can I export a container list to Excel?

A: Select the containers you want to export, for instance using the recap. Then, using the View→Panels→Selected containers table, select all the containers with Ctrl+A, copy them to the clipboard using Ctrl+C and finally paste them into an Excel sheet using Ctrl+V.

6.3. Q: How can I export a discharge list?

A: In the departure condition of the previous port, clear the recap and choose the Traversing filter. Then choose the containers with the POD you want the list for. Using the Selected Containers table, copy paste the selection to an Excel sheet.

7. General editing and viewing

7.1. Q: How can I undo an earlier action?

A: Press Ctrl+Z or select the undo arrow in the tool bar. Redo is done with Ctrl+Shift+Z

7.2. Q: How can I zoom in and out?

A: Press Ctrl+Mouse Wheel in the scan plan. Also, pressing "b" is a short cut for zoom to bay and "v" is a short cut for zoom to vessel.

7.3. Q: How do I switch between multi-call view and single call view?

A: In the Settings→General dialog, check/uncheck the Hide inactive calls check box. It might also be advisable to switch the arrangement of the bays to/from the 2-row representation ("Display vessel in 2x2 rows")

7.4. Q: How can I bundle/unbundle flat racks, platforms etc.?

A: in order to bundle multiple bundlable units you need to select them, right-click in the recap or scan plan and choose "Bundle selected container". Important note: the units need to be empty and be of a bundlable type, e.g. 29P0.

7.5. Q: How can I see the number of moves in each bay?

A: The crane split view shows the summaries of moves in adjacent bays. This is what is required to identify and handle long cranes, hence berth productivity and total number of applicable cranes. However, the need to know exactly how many moves of which type are carried out in each bay can also arise, for instance when discussing details with the terminal. This functionality is provided by Angelstow’s recap:

  1. right-click in the upper-left corner and choose "Filter"→"clear"

  2. then "Filter"→"Moves only"

  3. then right-click in the row headers and choose "Bay number"

  4. then right-click in the row headers and choose "Stowage Status".

This will give you a recap with the bays laid out horizontally and the move types (load/discharge/restow/) laid out vertically, with summaries per bay in the bottom.

8. Master plan

8.1. Q: How can I create a master plan?

A: To create a master plan, select the master plan mode in the tool bar. Master planning is subsequently done by allocating compartments to the PODs of the user’s choice. Once the compartments have been allocated, press the Stow Master Plan button in the tool bar. Then allocate more compartments and stow again until only a few containers are unplanned.

8.2. Q: How do I move master planned containers?

A: Master planned containers shouldn’t be moved as such. Instead, the allocation done in the master plan should be modified and the master plan recomputed by pressing the Stow MasterPlan button.

9. PDF export

9.1. Q: How can I export a discharge and load scan plan?

A: Select File→Export Scanplan and choose the scan plan to export. The plan can be printed, previewed or exported directly to PDF.

10. Schedules and call definitions

10.1. Q: How can I add a call to the schedule?

A: Right-click in the Schedule panel and choose Insert call or Append call. Then define the call in the Add Call dialog and press Enter (or click the Add button). When done presse Esc (or press the Done button).

10.2. Q: How can I change the ports' colors?

A: When using the default pivot-based port coloring scheme, the port colors are dependent on the last port in the region, called pivot port, which can be set in the schedule view.

Individually customized port colors can be set by changing the Settings → Pivot based port coloring to off.

In order to modify the provided default, fixed port colors, download the portcolors.ini file into a configuration directory of your choice and indicate the path to this directory in the Settings dialog’s Custom configuration directory.

Note: it is important that the file’s name remain exactly "portcolors.ini" (case sensitive).

If the colors do not suit your needs, just open the portcolors.ini file with a text editor and change the concerned port’s color code. Examples of color codes can be found here:

If a port has not been assigned a color, it will appear as black in Angelstow.

10.3. Q: How do I make a Change Of Rotation?

A: In the schedule view, right click on a call and choose Move Up or Move Down.

10.4. Q: How can I change the current port?

A: Several options are available for changing the port: choose the port in the schedule view or press PgUp/PgDn. If in multi-call view, you can also click on the left border of the scan plan.

10.5. Q: How can I change the default port water densities?

A: Angelstow computes port departure draft, trim and stresses according to the water density of the port call. The used water density is displayed in the view Stability figures in column WD (= Water Densitiy).

In order to modify the provided default, fixed port water densities, download the portwaterdensities.ini file into a configuration directory of your choice and indicate the path to this directory in the Settings dialog’s Custom configuration directory.

Note: it is important that the file’s name remain exactly "portwaterdensities.ini" (case sensitive).

If a port has not been assigned a specific water density, the default value of 1025 kg/m3 for average ocean water will be used.

11. Vessel profiles

11.1. Q: How can I modify a vessel profile?

A: Editing a vessel profile is done in the Excel sheet. Converting the Excel sheet to an Angelstow profile is done at

11.2. Q: How do I import a newly converted vessel into Angelstow?

A: Select File→Import vessel and choose the .json file on the disk drive.

Version 0.1.0 2013-06-20