CHANGELOG.md 8.97 KB
Newer Older
Ulrich Kemloh's avatar
Ulrich Kemloh committed
1 2 3
# Change Log
All notable changes to this project will be documented in this file.

Mohcine Chraibi's avatar
v0.8.3  
Mohcine Chraibi committed
4
## v0.8.3 [2018-05-18]
Mohcine Chraibi's avatar
Mohcine Chraibi committed
5
### Added
Mohcine Chraibi's avatar
v0.8.3  
Mohcine Chraibi committed
6 7 8
- Consider direction of escalators in ff-router !22
- Statistics about deleted agents !12
- `cmake  -DAIROUTER=true` to ignore the `AIrouter` 6fd4a1a0
Mohcine Chraibi's avatar
Mohcine Chraibi committed
9 10
- Use npy files for smokesensor. !13 
- New attributes for sources `agent_id` and `time` for scheduling agent's appearance. See #258 for discussion. !14
Mohcine Chraibi's avatar
Mohcine Chraibi committed
11
- Router tests
12
- Option for printing progressbar:  `<progressbar/>` cfc65f22
Arne Graf's avatar
Arne Graf committed
13
- Universal Floorfield: recognition of inside and outside of rooms, gridpoints know corresponding Subroom
Arne Graf's avatar
Arne Graf committed
14 15 16
- Floorfield Router: fixes of "Cannot find route for pedestrian ..." bugs; b1345915
- vtk-files (ff_router) can be written with `<write_VTK_files>true</write_VTK_files>` (see wiki)
- Exit_Strategie / Direction_Strategie: fixed bug 269, where agents get stuck at doors. b1345915
Mohcine Chraibi's avatar
Mohcine Chraibi committed
17

Mohcine Chraibi's avatar
v0.8.3  
Mohcine Chraibi committed
18 19 20 21 22 23 24 25
### Changed
- Renaming of CogMap-router and new router (Erik). !16

### Fixed
-  source thread and main thread are not synchrone. 2d1fb525
- Bug in sources leads to duplicate sgents. #158 5c81985b


Mohcine Chraibi's avatar
0.8.2  
Mohcine Chraibi committed
26 27
## v0.8.2 [2016-10-11]

Mohcine Chraibi's avatar
Mohcine Chraibi committed
28
Repository moved to [new server](https://gitlab.version.fz-juelich.de/jupedsim/jpscore)
Mohcine Chraibi's avatar
Mohcine Chraibi committed
29
### Added
30 31
- Adding rolling flow for validation tests (a74f9ba465efc9706b7e0bbe4e51c1cae66b356f)
- New smoke sensor. Adapt speed of agents walking in smoke. See branch [jpsfire_toxicity_analysis](https://gitlab.version.fz-juelich.de/jupedsim/jpscore/commits/jpsfire_toxicity_analysis)
Arne Graf's avatar
Arne Graf committed
32
- New option for `groups`. It is now possible to load the first positions of pedestrians from a file. 
Mohcine Chraibi's avatar
Mohcine Chraibi committed
33
  Needed for better comparison with experiments. Use attribute: `positions_dir="/path/to/directory/"` `unit="cm"`.
34
  The unit of the trajectories can be specified. Default is meter. (!3)
Arne Graf's avatar
Arne Graf committed
35 36 37
- New router: prototype of the floorfield based, quickest router `ff_quickest`. This router will re-asses all routes
  including agents into its routing-calculations. Jams will be avoided, if a clear route is available.

Mohcine Chraibi's avatar
Mohcine Chraibi committed
38
### Changed
39 40 41 42
- Using only Gitlab CI
- update to RiMEA test 3.0 [changelog_rimea.txt](https://gitlab.version.fz-juelich.de/jupedsim/jpscore/blob/mergePrototype/Utest/rimea_tests/changelog_rimea.txt). Thanks @schumacher3
- automatically make a report with RiMEA tests (!7). Thanks @zhong1
- renamed options `start_x` and `start_y` to `startX` and `startY` resp. (bf28854f)
Mohcine Chraibi's avatar
Mohcine Chraibi committed
43
- New Progressbar (ec7c9b0c)
Arne Graf's avatar
Arne Graf committed
44 45 46 47 48 49
- UnivFFviaFM class replaces the old (Local)FloorfieldViaFM classes
- FFRouter (`ff_global_shortest`, `ff_quickest`) will delay calculations to a point between timesteps to use all available cores.
- removed writing of VTK-files (this feature will be controllable via inifiles in the future)
- DirectionStrategy using floorfields (exit strat `8`,`9`) will respect shoulderwidth for doors.
- Boost::Geometry is used for geometric checks (isWithin)
- Direction Strategy will be matched, if FFRouter is used (auto-set to exit strat `8`)
Mohcine Chraibi's avatar
Mohcine Chraibi committed
50 51

### Fixed 
52 53
- Wrong Z-component in trajectories (!4)
- Several bug fixes
Arne Graf's avatar
Arne Graf committed
54
- isClockwise() fixed
55
- isInSubroom() fixed (#238)
Arne Graf's avatar
Arne Graf committed
56 57 58
- agents getting stuck and oscillating fixed (#247)
- router problems with `ff_global_shortest` fixed (#245)
- parameters for direction strategy `8`,`9` will be used (`wall_avoid_distance`,`delta_h`, `use_wall_avoidance`)
Mohcine Chraibi's avatar
Mohcine Chraibi committed
59

Mohcine Chraibi's avatar
Mohcine Chraibi committed
60
## v0.8.1 [2016-10-11]
Mohcine Chraibi's avatar
update  
Mohcine Chraibi committed
61
### Added
Mohcine Chraibi's avatar
greedy  
Mohcine Chraibi committed
62
- Tag Sources: new attribute to choose between "greedy" approach and random approach: `gready="true"` (default: `false`)
Mohcine Chraibi's avatar
update  
Mohcine Chraibi committed
63
- Floor field router. See [usage](http://jupedsim.github.io/jpscore/models/routing/#floorfield-router). 
Mohcine Chraibi's avatar
Mohcine Chraibi committed
64
- New attribute for *step_size* `<step_size fix "no">0.01</step_size>`. Default is yes. See #193 for description and commit 78b634ff. 
65
- Added new operational model `<model operational_model_id="5" description="Krausz">`. See [Wiki](https://cst.version.fz-juelich.de/jupedsim/jpscore/wikis/docs/models/operativ#generalized-centrifugal-force-model-with-lateral-swaying) 
Mohcine Chraibi's avatar
Mohcine Chraibi committed
66 67
- Added new `cmake` compilation flags: 
  - `-D DUSE_DUAL_ABI=ON` (default OFF): See [note in GCC 5.1 release](https://gcc.gnu.org/onlinedocs/libstdc++/manual/using_dual_abi.html). 
Arne Graf's avatar
Arne Graf committed
68 69
  - `-D Boost_NO_SYSTEM_PATHS=true` (default false): In case a local version of boost has to be used.
     Pass this option together with `-D BOOST_ROOT=PATH_where_to_find_boost`.
Mohcine Chraibi's avatar
Mohcine Chraibi committed
70
  
Mohcine Chraibi's avatar
update  
Mohcine Chraibi committed
71 72 73 74 75 76 77 78
### Modified
- If no seed is given, the simulation will be run with `seed=Time(NULL)` (random).
- Major refactoring of the parsing machinery. :+1:  @laemmel. 

### Fixed
- Fix properly delete pedestrians in `Tordeux915` (#203).
- Fix simulations are not thread-safe (#200). 
- Fix memory lacks (#202).
Mohcine Chraibi's avatar
Mohcine Chraibi committed
79

Mohcine Chraibi's avatar
update  
Mohcine Chraibi committed
80 81 82

### Bugs
Please also check the [Issue tracker](https://cst.version.fz-juelich.de/jupedsim/jpscore/issues?assignee_id=&author_id=&label_name=&milestone_id=&scope=all&sort=created_desc&state=opened), if access is available.
Arne Graf's avatar
Arne Graf committed
83 84 85
- exit strategies using *local* - prefix can result in circular routing
- triangulation creates error-prone help-lines in certain geometries
- errors in unused parts of ini files lead to system-exit
Arne Graf's avatar
update  
Arne Graf committed
86
- exit_strategy: exit strat 9 currently bugged
Arne Graf's avatar
Arne Graf committed
87
- router: ff_global_shortest might not find paths in some geometries. please use exit_strategy 8
Arne Graf's avatar
update  
Arne Graf committed
88 89
- console output: messages of only one line will be overwritten by progress bar
- agents that leave the building might produce an error-msg (although they correctly left the simulation)
Ulrich Kemloh's avatar
Ulrich Kemloh committed
90

Arne Graf's avatar
Arne Graf committed
91
## v0.8.0 [2016-02-18]
Mohcine Chraibi's avatar
Mohcine Chraibi committed
92

Mohcine Chraibi's avatar
Mohcine Chraibi committed
93

Mohcine Chraibi's avatar
Mohcine Chraibi committed
94
### Added
Mohcine Chraibi's avatar
Mohcine Chraibi committed
95
- CI with travis and Gitlab CI
96
- Compilation checked on Visual Studio 12 2013 
97 98
- Added more validation tests
- Added statistics (calculate exit usage) for all exits
Mohcine Chraibi's avatar
Mohcine Chraibi committed
99
- Added voronoi based algorithm for inserting agents coming from the source or from matsim
100
- New option for the quickest path router. Sample options are:
Arne Graf's avatar
Arne Graf committed
101

102
 ```<parameters default_strategy="local_shortest">```
Arne Graf's avatar
Arne Graf committed
103 104 105 106 107
 
 ```<parameters default_strategy="global_shortest">``` 
 
 ``` <parameters cba_gain="0.15" reference_peds_selection="single" congestion_ratio="0.8" queue_vel_escaping_jam="0.2" 
       queue_vel_new_room="0.7" visibility_obstruction="4">```
Mohcine Chraibi's avatar
Mohcine Chraibi committed
108 109
- New model with the generic name `Tordeux2015` and `id=3`. For use check the ini-files in the Utest-validation tests.
- Tests are sorted in `rimea_tests`, `juelich_tests` and `validation_tests`.
Arne Graf's avatar
Arne Graf committed
110
- Periodic boundary conditions with the option `<periodic>1</periodic>`.Works only with model 3.  
Arne Graf's avatar
Arne Graf committed
111 112
- Added floor field to all exits, providing direction to target, direction to closest wall and cost estimates. Parameter to control wall-avoidance included.
- Added new __Exit Strategies__ using floor fields on various subdomains (rooms, subrooms). Please refer to the online documentation on [jupedsim.org](www.jupedsim.org).
Mohcine Chraibi's avatar
Mohcine Chraibi committed
113
   
114

Mohcine Chraibi's avatar
Mohcine Chraibi committed
115

Ulrich Kemloh's avatar
Ulrich Kemloh committed
116
## v0.7.0 [2015-07-15]
Ulrich Kemloh's avatar
Ulrich Kemloh committed
117

Ulrich Kemloh's avatar
Ulrich Kemloh committed
118
### Added
Mohcine Chraibi's avatar
Mohcine Chraibi committed
119
- New module `JuPeditor`: Editor for the geometry
Ulrich Kemloh's avatar
Ulrich Kemloh committed
120
- Risk tolerance factor (value in [0 1]) for pedestrian. Pedestrians with high values are likely to take more risks.
121
- Added pre-movement time of the agents. Only after this time, the concerned agents will start moving.
Ulrich Kemloh's avatar
Ulrich Kemloh committed
122 123 124 125 126
- Sources for generating agents at runtime. Parameter are frequency (agents per seconds) and maximum number
- Option to color the pedestrians by group, spotlight, velocity, group, knowledge, router, final\_goal, intermediate\_goal. Usage: ( 
```<trajectories format="xml-plain" fps="8" color_mode="group"> ```)
- More control over the triangulation specially to avoid skinny triangles. Usage: ```<navigation_mesh method="triangulation" minimum_distance_between_edges="0.5" minimum_angle_in_triangles="20" use_for_local_planning="true" />```
- Improved statistics. The flow curve for the different exits can be computed at runtime.
Ulrich Kemloh's avatar
Ulrich Kemloh committed
127
- Changelog file
128
- Rimea testcases
Ulrich Kemloh's avatar
Ulrich Kemloh committed
129
- Unit tests are now based on the Boost testing engine
130

Ulrich Kemloh's avatar
Ulrich Kemloh committed
131 132
### Changed
-  
Mohcine Chraibi's avatar
Mohcine Chraibi committed
133

Ulrich Kemloh's avatar
Ulrich Kemloh committed
134 135

### Fixed
136
- Visiblity in 3D
137
- Numerous geometrical operations
Ulrich Kemloh's avatar
Ulrich Kemloh committed
138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154


## v0.6.0 - 2015-01-31
### Added
- Steering the simulation with predefined events (closing or opening doors during the simulation)
- Information sharing between the pedestrians. The agents now share their knowledge about closed doors.
- Pre evacuation time for groups of agents.
- Adjustable velocities on stairs and even terrain for group of agents.
- Stability and performance improvement. The simulation is approx 40% faster for larger scenarios and you will notice it
- New route choice model, cognitive map, giving agents the possibility to explore the environment and discover doors for instance.
- Different sensors for improving the navigation of pedestrians (smoke/jam sensor).
- New verification and validation tests.
- General statistics over the evacuation (for instance areas egress time and door usage)
- Support for Visual Studio and Xcode compilers.


### Changed
Mohcine Chraibi's avatar
Mohcine Chraibi committed
155
- refactor NumCPU and ExitCrossingStrategy tags to `num_threads and exit_crossing_strategy`
Ulrich Kemloh's avatar
Ulrich Kemloh committed
156 157


Ulrich Kemloh's avatar
Ulrich Kemloh committed
158 159 160 161 162 163 164 165 166 167

## v0.5.0 - 2014-08-05
First release of the the Juelich Pedestrian Simulator. Most noteworthy features:

- Simulate pedestrians movement in a space continuous geometry
- Forces based models for describing the pedestrians interactions
- Shortest and quickest path route choice strategies
- Loading and visualizing trajectories and geometries
- Easy to use visualization interface
- Making high quality videos directly from the visualization interface or generating png sequences
Mohcine Chraibi's avatar
Mohcine Chraibi committed
168
- XML based input files