bauhausluftfahrt/paxelerate

Passenger flow simulation framework for advanced aircraft cabin layouts. Written in Java. In development at Bauhaus Luftfahrt e.V. since 2014.

PAXelerate Boarding Simulation

Welcome to the repository of PAXelerate - an open source passenger flow simulation framework for advanced aircraft cabin layouts!

Recent Changes

Due to the reworking of the entire project, there is currently no client version available. Feel free to check out the source code and discover all the changes of the latest release:

• Removal of all openCDT dependencies
• Removal of custom EMF aircraft model library
• Introduction of CPACS as input data structure
• Focus on boarding simulation, hence removal of UI and cabin configuration options for now
• Introduction of COVID-19 exposure tracking
• Transition to CPACS 3.4

Installation

1. Install the latest version of the Eclipse modelling tools and Java JDK 8 or later.
2. Checkout PAXelerate from the main branch
3. Checkout Java CPACS Parser from the main branch
4. Checkout Java Toolbox from the main branch
5. Launch StartPAXelerate.java in com.paxelerate.execution -> main

Usage

1. Be sure to make yourself familiar with CPACS and the "deck" and "toolspecific" node.
2. Take a look at the example.xml file in the example folder. You will find the
   • deck node: In this node, all cabin definition is done. Manipulate this node to change the cabin layout itself.
   • toolspecific node: In this node, all properties which are required for the simulation can be found (details). Also take a look into the .xsd file for possible input restrictions.
3. Run StartPAXelerate.java in the com.paxelerate.execution package under execution -> main.
4. Select the CPACS cabin file you want to simulate and run it.
5. Wait for the simulation to complete.
6. Take a look at the data output under your personal documents folder at <user-path>/documents/paxelerate/.

Contributors

Marc Engelmann, Tim Kleinheinz, Michael Schmidt, Raoul Rothfeld, Michael Shamiyeh, Martin Glas, Tobias Brügge-Zobel, Stefan Weber, Pedro Martinez and Philipp Osterrieder. (listed in order of activity)

About

Copyright (c) since 2014 Bauhaus Luftfahrt e.V. All rights reserved. PAXelerate and the accompanying materials are made available under the terms of the GNU General Public License v3.0 which accompanies this distribution, and is available at https://www.gnu.org/licenses/gpl-3.0.html.en.

paxelerate's Issues

Define Eclipse target platform

see vogella tutorial

Terminate threads after simulation to reduce CPU load

Perspectives: further customise layout

• close Model Repository
• move Property View to lower left

Switch all x and y assignments for the vector class

Check diagonal walking of agents

Check distance calculation in A-Star for diagonal walking

Status:
The paths in the picture are now as desired, the best mix between cheapest way, shortest way and an appropriate distance to obstacles. Further improvements / changes should be made by manipulating the potential around obstacles and the obstacle map itself

Update license of used icons (model explorer) and graphics (aircraft)

Test with Eclipse Neon RC4

13/Jun/16

Reorder parameter for re-positioning

Should be completed after the x/y coordinates are changed #8

Test with Eclipse Neon M7

Release schedule

M7: 2016-04-29 / 4.6M7 (Feature Freeze)

Seat layout algorithm for specific seating class

Should use the following parameters to creat seating layout:

• cabin width
  

• aisle width
  

• seat abreast
  

• seat pitch
  

• number of rows/passenger (integer)
  

• x coordinate of first row
  

Model Explorer: Define meaning of exclamation points

Tracebility of errors or warning in model explorer

Check pathfinding with more than one aisle

Blinking EMF Forms

Check compatibility with Linux

Migrate to Java 1.8

Differentiation between stowing tasks

• luggage stowing in overhead bin
  

• luggage stowing under the seat
  

• stowing of coat/jacket
  

Create release schedule

• Git branching
  

• Milestones
  

• Release candidates
  

• Included material in zip file: wiki, changelog
  

• Required updates on website and repository
  

• Blogpost
  

• Issue tracker
  

• Legal and copyright info
  

Oomph installation profile for developer version

http://eclipsesource.com/blogs/2015/08/17/introducing-the-eclipsesource-oomph-profile/
http://wiki.eclipse.org/Eclipse_Oomph_Installer

Ensure compatibility with MacOS

Include Birt charting package

After implementation in OpenCDT is completed
http://www.eclipse.org/birt/

Refine potential generation around obstacle

• shift initial values to simulation properties
• different potentials (values and width) for monuments: seats, GAL, LAVS
• gradient functions: linear, quadratic, logarithmic --> based on paper/studies
• rethink obstacle hole for aisle

Check time of seat interference task

In Agent --> followPath() there are hard coded values for the way making procedure, we should add the to the SimulationProperties and use a Gaussian distribution:

else if (waitingForClearingOfRow() && !waitingCompleted) {
                    setCurrentState(State.WAITING_FOR_ROW_CLEARING);
                    // TODO: only one passenger is detected, even if there are 2
                    // already in the row!
                    while (waymakingAllowed() == false) {
                        Thread.sleep(10);
                    }
                    if (anyoneNearMe()) {
                        System.out
                                .println("waymaking skipped. Delay simulated!");
                        Thread.sleep(AStarHelper.time(7));
                        waitingCompleted = true;
                        continue;
                    }
                    if (!waitingCompleted) {
                        for (Passenger pax : otherPassengersInRowBlockingMe) {
                            SimulationHandler.launchWaymakingAgent(pax,
                                    this.passenger);
                        }
                        while (!otherPassengerStoodUp()) {
                            Thread.sleep(10);
                        }
                        // TODO: calculate the waiting time!
                        Thread.sleep(AStarHelper.time(3));
                        waitingCompleted = true;
                    }

Reorder and rethink simulation properties

Create children for simulation properties for different aspects or shift info to preference page (storage of settings possible for multiple cabins?)

Scale aircraft image according to view width

Create MVC class seperation (introduce Controller)

Check monument dimensions != 0

If a dimension of a cabin monument (galley, lavatory) is zero, the following error ocurs:

!ENTRY net.bhl.cdt.paxelerate.ui 1 0 2016-02-17 16:10:48.650
!MESSAGE ERROR in setCabin()
java.lang.IllegalArgumentException: Argument not valid

!ENTRY net.bhl.cdt.paxelerate.ui 1 0 2016-02-17 16:10:48.656
!MESSAGE Cabin view checked and updated
    at org.eclipse.swt.SWT.error(SWT.java:4472)
    at org.eclipse.swt.SWT.error(SWT.java:4406)
    at org.eclipse.swt.SWT.error(SWT.java:4377)
    at org.eclipse.swt.graphics.Image.init(Image.java:1746)
    at org.eclipse.swt.graphics.Image.<init>(Image.java:200)
    at net.bhl.cdt.paxelerate.ui.views.CabinViewPart.resize(CabinViewPart.java:358)
    at net.bhl.cdt.paxelerate.ui.views.CabinViewPart.setCabin(CabinViewPart.java:472)
    at net.bhl.cdt.paxelerate.ui.commands.DrawCabinCommand.doRun(DrawCabinCommand.java:99)
    at net.bhl.cdt.commands.CDTCommand.execute(CDTCommand.java:34)
    at net.bhl.cdt.paxelerate.ui.handlers.DrawCabinHandler.execute(DrawCabinHandler.java:36)
    at org.eclipse.ui.internal.handlers.HandlerProxy.execute(HandlerProxy.java:295)
    at org.eclipse.ui.internal.handlers.E4HandlerProxy.execute(E4HandlerProxy.java:90)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.lang.reflect.Method.invoke(Method.java:497)
    at org.eclipse.e4.core.internal.di.MethodRequestor.execute(MethodRequestor.java:56)
    at org.eclipse.e4.core.internal.di.InjectorImpl.invokeUsingClass(InjectorImpl.java:252)
    at org.eclipse.e4.core.internal.di.InjectorImpl.invoke(InjectorImpl.java:234)
    at org.eclipse.e4.core.contexts.ContextInjectionFactory.invoke(ContextInjectionFactory.java:132)
    at org.eclipse.e4.core.commands.internal.HandlerServiceHandler.execute(HandlerServiceHandler.java:152)
    at org.eclipse.core.commands.Command.executeWithChecks(Command.java:493)
    at org.eclipse.core.commands.ParameterizedCommand.executeWithChecks(ParameterizedCommand.java:486)
    at org.eclipse.e4.core.commands.internal.HandlerServiceImpl.executeHandler(HandlerServiceImpl.java:210)
    at org.eclipse.e4.ui.workbench.renderers.swt.HandledContributionItem.executeItem(HandledContributionItem.java:799)
    at org.eclipse.e4.ui.workbench.renderers.swt.HandledContributionItem.handleWidgetSelection(HandledContributionItem.java:675)
    at org.eclipse.e4.ui.workbench.renderers.swt.HandledContributionItem.access$7(HandledContributionItem.java:659)
    at org.eclipse.e4.ui.workbench.renderers.swt.HandledContributionItem$4.handleEvent(HandledContributionItem.java:592)
    at org.eclipse.swt.widgets.EventTable.sendEvent(EventTable.java:84)
    at org.eclipse.swt.widgets.Display.sendEvent(Display.java:4362)
    at org.eclipse.swt.widgets.Widget.sendEvent(Widget.java:1113)
    at org.eclipse.swt.widgets.Display.runDeferredEvents(Display.java:4180)
    at org.eclipse.swt.widgets.Display.readAndDispatch(Display.java:3769)
    at org.eclipse.e4.ui.internal.workbench.swt.PartRenderingEngine$4.run(PartRenderingEngine.java:1127)
    at org.eclipse.core.databinding.observable.Realm.runWithDefault(Realm.java:337)
    at org.eclipse.e4.ui.internal.workbench.swt.PartRenderingEngine.run(PartRenderingEngine.java:1018)
    at org.eclipse.e4.ui.internal.workbench.E4Workbench.createAndRunUI(E4Workbench.java:156)
    at org.eclipse.ui.internal.Workbench$5.run(Workbench.java:654)
    at org.eclipse.core.databinding.observable.Realm.runWithDefault(Realm.java:337)
    at org.eclipse.ui.internal.Workbench.createAndRunWorkbench(Workbench.java:598)
    at org.eclipse.ui.PlatformUI.createAndRunWorkbench(PlatformUI.java:150)
    at net.bhl.cdt.client.Application.start(Application.java:26)
    at org.eclipse.equinox.internal.app.EclipseAppHandle.run(EclipseAppHandle.java:196)
    at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(EclipseAppLauncher.java:134)
    at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:104)
    at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:380)
    at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:235)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.lang.reflect.Method.invoke(Method.java:497)
    at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:669)
    at org.eclipse.equinox.launcher.Main.basicRun(Main.java:608)
    at org.eclipse.equinox.launcher.Main.run(Main.java:1515)
    at org.eclipse.equinox.launcher.Main.main(Main.java:1488)

Variation of luggage stowing row

Redefine seat pitch as distance between seat backrests

Test with Eclipse Neon Final Release

27/06/2016

Zoom in/out function for cabin property view

Update to EMF Client Platform 1.8.x /1.9.x

After OpenCDT migration @michael-sh

Harmonize icons design

Use google material design icons (CC-BY 4.0)

Update to Eclipse e4

after OpenCDT is migrated

Create Model Repository with EMF Store

Rename MoveRow to MoveObject

Usage of EMF Edapt to track and apply ECore model changes

Create keyboard shortcuts for context menus

Rewrite of DrawCabinHandler necessary

Code cleaning

Store data in home/.cdt/paxelerate

Copy and paste of elements in tree structure

Enforce threading for UI & pathfinding calculations

Show Units for each variable in the Model Explorer

Possible solution: rewrite Label Provider in Edit Plugin that with getText value and unit are submitted

Create Unit tests with JUnit

Simulation view and cabin view are mirror-inverted

Add license and source for startup image

Create User Tutorial

• Model explorer: cabin and agents

• Different views
  

• Simulation
  

• Results
  

• Work-arounds
  

• Creation of corresponding files
  

Compatibilty with Eclipse Mars.2 (4.5.2)

Service release is on the 02/26

Create JavaDoc

See tutorial and javadoc coding guidelines
Auto generate all missing javadoc

Store graphic files for startup and aircraft renders

paxelerate / documentation / images /

WelcomePage: Additional Info to Get Started

perhaps include HTML