OSGeo - User contributions [en]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-08-20T21:05:43Z

Wiki-Simonebt92: /* Week 12 - Final Report */

== Introduction ==

My project will focus on creating a plugin to allow clusterization of markers in the
ESA-NASA Web World Wind framework. These following capabilities are the
features I would like to implement:
1. Clustering based on different algorithms
2. Set a custom icon based on user parameters: i.e., number of clusters or custom
variables
3. Cluster based on geometries and not just polygons
4. Filter clusters based on user criteria
5. Precache the cluster at the zoom levels for optimized performance

== Schedule ==

{| class="wikitable"
|-
! TODO !! Timeline !! Status
|-
| Coding begins || May 30 || Done!
|-
| Research about the clustering functionalities and about the marker classes in WWW || May 30 - June 10 ||Done!
|-
| Implementation of a clustering algorithm in WWW || June 11 - June 20 || Done!
|-
| Phase 1 Evaluation || June 26 || Done!
|-
| Creating a first version of the clustering plugin || June 26 - June 30 || Done!
|-
| Implementing clustering options to cluster markers based on attributes || July 1 - July 10 || Done!
|-
| <del> Vacation</del> Comment code and documentation || July 11 - July 18 || Done!
|-
| Phase 2 Evaluation || July 24 || Done!
|-
| Customize the design of clusters with colors and effects || July 24 - July 31 || Done!
|-
| Filter clusters on predefined attributes || August 1 - August 10 || Done!
|-
| Creating Unit Tests for the code || August 11 - August 16 || Done!
|-
| <del> Comment code and documentation</del> Vacation|| August 17 - August 21 || Done!
|-
| Finalizing documentation and reviewing the code || August 21 - 28 || Done!
|-
| Submit final work product and mentor evaluation || August 29 || Awaiting..
|}

We will try to follow the schedule and report the status of the project each week.

== Weekly Reports ==

=== Week 1 ===
* What did you get done this week?
This week I set-up the development environment and made some research about the clustering algorithms and libraries available.
I found out some good library for clustering point and it can be integrated with WebWorldWind.
* What do you plan on doing next week?
Next week I will set up the unit test environment.
* Are you blocked on anything?
I already tried this week but had some problems. However, talking with my mentors I got some advice on how to proceed.

=== Week 2 ===
* What did you get done this week?
I prepared the testing environment and unit tests are working. I prepared a sample test but also improved the structure of the project and created some functionalities.
* What do you plan on doing next week?
Next week I will improve the current functionalities and create new more to allow a better insertion of markers into the plugin.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 3 ===
* What did you get done this week?
I developed some methods to improve the clustering functionalities. It accepts now a single marker, as well a list of markers. Also, some functionalities to show and hide single and groups of markers.
I'm able to create a cluster for a specified zoom level and show it in the globe.
* What do you plan on doing next week?
Next week I would like to show and hide the clusters automatically based on the zoom level and generate at the start all the groups.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 4 ===
* What did you get done this week?
I managed to show and hide clusters based on the zoom level and hide the others. However, I encountered a small performance issue when there all too many markers in the globe.
* What do you plan on doing next week?
Next week I'm planning to hide all the markers that are not visible in the current view. I started researching and studying some code examples to achieve this.
* Are you blocked on anything?
I'm not really blocked, but I need the help of the mentors to proceed because I'm not really sure right now.

=== Week 5 ===
* What did you get done this week?
This week, as planned, I managed to hide all the markers outside the current view. I spent almost all week researching about the approaches to do that, and to improve performances I ended up using a camera model for a 2D view. Which works very well on small areas, like in our case. While, on a bigger area, I will implement maybe the 3D camera model, as suggested by my mentors.
I also created a smooth navigation to match zoom levels with cluster levels. I also implemented a GitHub page where is possible to test a demo with 200k markers.
Demo: [https://simonebt92.github.io/NASA-WWW-MarkerCluster/ https://simonebt92.github.io/NASA-WWW-MarkerCluster/]
* What do you plan on doing next week?
I will try to understand how to correlate zoom levels from WorldWind (camera range) with zoom levels from the cluster and its radius, and an optimal number of markers to show on each level.
* Are you blocked on anything?
I'm not totally blocked but I'm struggling on finding a good way to show the right amount of clusters and select a good radius when clustering.

=== Week 6 ===
* What did you get done this week?
This week I finally found how to correlate the zoom levels of World Wind with the cluster levels.
I allow now users to set a maximum level on which they can cluster.
I created some images, with a color variation depending on the number of markers a cluster contains.
I show markers on the visible area while zooming or pressing the +/- buttons.
I allow to manage at the same time different clusters (each with his setting).
I created an example with all the US cities.
I implemented single markers without clusters.
* What do you plan on doing next week?
Next week I was expected to be on vacation, but since I won't be able to go, I agreed with my mentor that I will skip few days in August and next week I will work on two things:
Handling the pan on the globe to show the markers on the visible area (now works only with zoom).
Starting commenting the code because it's getting confusing. And create a documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 7 ===
* What did you get done this week?
This week I implemented the possibility to pan in the globe and display the markers in the panning area.
I created an option to limit the visible markers to improve performances.
I commented all the functions briefly and created many unit tests (more yet to come).
* What do you plan on doing next week?
Next week I will create more unit tests, and I will work more on the customization of the clustering functionalities.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 8 ===
* What did you get done this week?
This week i've done the followings:
Enable the plugin to work with customized navigators and controls
Fixed a problem that prevented to click on a cluster and zoom
Allow the customization of the marker icons
Removed jQuery from the project
Implemented a build version for the gh-page
Implemented the plugin in a real application, and fixed a few problem that found on the project while doing it
* What do you plan on doing next week?
Next week I have still to finish some unit test and I will also try to customize more the clustering functionalities
* Are you blocked on anything?
I'm not blocked on anything

=== Week 9 ===
* What did you get done this week?
This week I allowed some customization of the settings from the user interface.
I changed the structure for the examples to insert many of them
I implemented many new examples with their own UI so that users can follow an HTML+JS example as is done in the WWW examples page.
One example for instance run 65k clusters very easily.
* What do you plan on doing next week?
Next week I need to finish the examples and use the build version to improve performances.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 10 ===
* What did you get done this week?
This week I completed some examples, and I hosted the app using the build version which is much faster.
I also created a quick start documentation and a short video showing how to use the plugin.
* What do you plan on doing next week?
Next week I will create some other examples and improve more the documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 11 ===
* What did you get done this week?
This week I created some examples, showing more functionalities of the plugin, and now users are able to test them directly on the example page.
I also started created more advanced unit tests, using mock object and spies.
* What do you plan on doing next week?
Next week I will write some other tests and finalizing the documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 12 - Final Report ===
* Project: Plugin Marker Cluster for NASA Web World Wind

* Abstract: The motivation behind Marker Cluster stands behind the need of porting a useful functionality into a popular framework such as Web World Wind, which, could benefit in different areas thanks to this plugin

* The state of the art BEFORE my GSoC: Before my project, Web World Wind didn't have any external plugin, made in the same form of mine. Especially there were no cluster functionalities for the markers. Even though the concept of clustering markers is not new to the public, it was not available on this framework.

* The added value that my project brought to the software: Thanks to my project, now any Web World Wind developer can easily import the clustering functionality in any application. Following the documentation anyone can do it, as we already tried in an example application.

* Work to be done on the project: The project itself is quite complete, including some basic functionalities. What could miss is trying in more application the product and find problems and new features to implement.

* Website & Documentation: https://simonebt92.github.io/NASA-WWW-MarkerCluster/
* Code Developed: https://github.com/simonebt92/NASA-WWW-MarkerCluster/commits/master

* Image: [[File:https://simonebt92.github.io/NASA-WWW-MarkerCluster/assets/logo.JPG]]

== Brief description of the idea ==
My project consists in the development of a Plugin for the ESA/NASA WebWorldWind framework, to allow clustering of multiple markers. 

A link to all my commits is available here: [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub].

== State of the art before this project ==

Currently there is no plugin for clustering large amounts of markers, even though an
app may implement a similar functionality, but not with a modular plugin that can be
generically reused for any number of user-specific criteria.

== Additions that this project will bring to the software ==

As a result of the plugin I will develop, it will be possible for anyone to easily import
the plugin into the framework and use it as a modular component. In this way it will
be possible to cluster markers easily, using any number of options.
As an example, it can be useful to use this plugin when visualizing a marker for each
city in Italy, because, having thousand of markers in a small area could be very
difficult to render on the globe, but also to understand. Thanks to the plugin, users
will see only a few clusters while viewing the markers from a far distance and
zooming in they will see more and more details.

== Public Repository & Testing==

The application is available in GitHub at [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub] .
More instruction on how to use the plugin will be available soon
# Instructions

== Student's Biography ==

My name is Simone Battaglia, I'm a Ph.D student in Neuroscience at Alma Mater Studiorum Bologna. I'm passionate about programming, and I like to integrate the IT world inside the neuroscience field.
I started learning programming thanks to my scientific researches and the needs of creating experiments in my study field. I got to know about WebWorldWind thanks to Patrick Hogan back in 2016 and I started using it since then.
This is my first time in the GSoC and I'm very happy to be coding for these 3 months and have the guidance of my mentors Patrick Hogan and Gabriele Prestifilippo.
[[Category:Google Summer of Code]]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-08-20T21:02:36Z

Wiki-Simonebt92: /* Week 12 - Final Report */

== Introduction ==

My project will focus on creating a plugin to allow clusterization of markers in the
ESA-NASA Web World Wind framework. These following capabilities are the
features I would like to implement:
1. Clustering based on different algorithms
2. Set a custom icon based on user parameters: i.e., number of clusters or custom
variables
3. Cluster based on geometries and not just polygons
4. Filter clusters based on user criteria
5. Precache the cluster at the zoom levels for optimized performance

== Schedule ==

{| class="wikitable"
|-
! TODO !! Timeline !! Status
|-
| Coding begins || May 30 || Done!
|-
| Research about the clustering functionalities and about the marker classes in WWW || May 30 - June 10 ||Done!
|-
| Implementation of a clustering algorithm in WWW || June 11 - June 20 || Done!
|-
| Phase 1 Evaluation || June 26 || Done!
|-
| Creating a first version of the clustering plugin || June 26 - June 30 || Done!
|-
| Implementing clustering options to cluster markers based on attributes || July 1 - July 10 || Done!
|-
| <del> Vacation</del> Comment code and documentation || July 11 - July 18 || Done!
|-
| Phase 2 Evaluation || July 24 || Done!
|-
| Customize the design of clusters with colors and effects || July 24 - July 31 || Done!
|-
| Filter clusters on predefined attributes || August 1 - August 10 || Done!
|-
| Creating Unit Tests for the code || August 11 - August 16 || Done!
|-
| <del> Comment code and documentation</del> Vacation|| August 17 - August 21 || Done!
|-
| Finalizing documentation and reviewing the code || August 21 - 28 || Done!
|-
| Submit final work product and mentor evaluation || August 29 || Awaiting..
|}

We will try to follow the schedule and report the status of the project each week.

== Weekly Reports ==

=== Week 1 ===
* What did you get done this week?
This week I set-up the development environment and made some research about the clustering algorithms and libraries available.
I found out some good library for clustering point and it can be integrated with WebWorldWind.
* What do you plan on doing next week?
Next week I will set up the unit test environment.
* Are you blocked on anything?
I already tried this week but had some problems. However, talking with my mentors I got some advice on how to proceed.

=== Week 2 ===
* What did you get done this week?
I prepared the testing environment and unit tests are working. I prepared a sample test but also improved the structure of the project and created some functionalities.
* What do you plan on doing next week?
Next week I will improve the current functionalities and create new more to allow a better insertion of markers into the plugin.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 3 ===
* What did you get done this week?
I developed some methods to improve the clustering functionalities. It accepts now a single marker, as well a list of markers. Also, some functionalities to show and hide single and groups of markers.
I'm able to create a cluster for a specified zoom level and show it in the globe.
* What do you plan on doing next week?
Next week I would like to show and hide the clusters automatically based on the zoom level and generate at the start all the groups.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 4 ===
* What did you get done this week?
I managed to show and hide clusters based on the zoom level and hide the others. However, I encountered a small performance issue when there all too many markers in the globe.
* What do you plan on doing next week?
Next week I'm planning to hide all the markers that are not visible in the current view. I started researching and studying some code examples to achieve this.
* Are you blocked on anything?
I'm not really blocked, but I need the help of the mentors to proceed because I'm not really sure right now.

=== Week 5 ===
* What did you get done this week?
This week, as planned, I managed to hide all the markers outside the current view. I spent almost all week researching about the approaches to do that, and to improve performances I ended up using a camera model for a 2D view. Which works very well on small areas, like in our case. While, on a bigger area, I will implement maybe the 3D camera model, as suggested by my mentors.
I also created a smooth navigation to match zoom levels with cluster levels. I also implemented a GitHub page where is possible to test a demo with 200k markers.
Demo: [https://simonebt92.github.io/NASA-WWW-MarkerCluster/ https://simonebt92.github.io/NASA-WWW-MarkerCluster/]
* What do you plan on doing next week?
I will try to understand how to correlate zoom levels from WorldWind (camera range) with zoom levels from the cluster and its radius, and an optimal number of markers to show on each level.
* Are you blocked on anything?
I'm not totally blocked but I'm struggling on finding a good way to show the right amount of clusters and select a good radius when clustering.

=== Week 6 ===
* What did you get done this week?
This week I finally found how to correlate the zoom levels of World Wind with the cluster levels.
I allow now users to set a maximum level on which they can cluster.
I created some images, with a color variation depending on the number of markers a cluster contains.
I show markers on the visible area while zooming or pressing the +/- buttons.
I allow to manage at the same time different clusters (each with his setting).
I created an example with all the US cities.
I implemented single markers without clusters.
* What do you plan on doing next week?
Next week I was expected to be on vacation, but since I won't be able to go, I agreed with my mentor that I will skip few days in August and next week I will work on two things:
Handling the pan on the globe to show the markers on the visible area (now works only with zoom).
Starting commenting the code because it's getting confusing. And create a documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 7 ===
* What did you get done this week?
This week I implemented the possibility to pan in the globe and display the markers in the panning area.
I created an option to limit the visible markers to improve performances.
I commented all the functions briefly and created many unit tests (more yet to come).
* What do you plan on doing next week?
Next week I will create more unit tests, and I will work more on the customization of the clustering functionalities.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 8 ===
* What did you get done this week?
This week i've done the followings:
Enable the plugin to work with customized navigators and controls
Fixed a problem that prevented to click on a cluster and zoom
Allow the customization of the marker icons
Removed jQuery from the project
Implemented a build version for the gh-page
Implemented the plugin in a real application, and fixed a few problem that found on the project while doing it
* What do you plan on doing next week?
Next week I have still to finish some unit test and I will also try to customize more the clustering functionalities
* Are you blocked on anything?
I'm not blocked on anything

=== Week 9 ===
* What did you get done this week?
This week I allowed some customization of the settings from the user interface.
I changed the structure for the examples to insert many of them
I implemented many new examples with their own UI so that users can follow an HTML+JS example as is done in the WWW examples page.
One example for instance run 65k clusters very easily.
* What do you plan on doing next week?
Next week I need to finish the examples and use the build version to improve performances.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 10 ===
* What did you get done this week?
This week I completed some examples, and I hosted the app using the build version which is much faster.
I also created a quick start documentation and a short video showing how to use the plugin.
* What do you plan on doing next week?
Next week I will create some other examples and improve more the documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 11 ===
* What did you get done this week?
This week I created some examples, showing more functionalities of the plugin, and now users are able to test them directly on the example page.
I also started created more advanced unit tests, using mock object and spies.
* What do you plan on doing next week?
Next week I will write some other tests and finalizing the documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 12 - Final Report ===
1- Project: Plugin Marker Cluster for NASA Web World Wind

2- Abstract: The motivation behind Marker Cluster stands behind the need of porting a useful functionality into a popular framework such as Web World Wind, which, could benefit in different areas thanks to this plugin

3- The state of the art BEFORE my GSoC: Before my project, Web World Wind didn't have any external plugin, made in the same form of mine. Especially there were no cluster functionalities for the markers. Even though the concept of clustering markers is not new to the public, it was not available on this framework.

4- The added value that my project brought to the software: Thanks to my project, now any Web World Wind developer can easily import the clustering functionality in any application. Following the documentation anyone can do it, as we already tried in an example application.

5- Work to be done on the project: The project itself is quite complete, including some basic functionalities. What could miss is trying in more application the product and find problems and new features to implement.

6- Website & Documentation: https://simonebt92.github.io/NASA-WWW-MarkerCluster/

7- Image: [[File:https://simonebt92.github.io/NASA-WWW-MarkerCluster/assets/logo.JPG]]

== Brief description of the idea ==
My project consists in the development of a Plugin for the ESA/NASA WebWorldWind framework, to allow clustering of multiple markers. 

A link to all my commits is available here: [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub].

== State of the art before this project ==

Currently there is no plugin for clustering large amounts of markers, even though an
app may implement a similar functionality, but not with a modular plugin that can be
generically reused for any number of user-specific criteria.

== Additions that this project will bring to the software ==

As a result of the plugin I will develop, it will be possible for anyone to easily import
the plugin into the framework and use it as a modular component. In this way it will
be possible to cluster markers easily, using any number of options.
As an example, it can be useful to use this plugin when visualizing a marker for each
city in Italy, because, having thousand of markers in a small area could be very
difficult to render on the globe, but also to understand. Thanks to the plugin, users
will see only a few clusters while viewing the markers from a far distance and
zooming in they will see more and more details.

== Public Repository & Testing==

The application is available in GitHub at [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub] .
More instruction on how to use the plugin will be available soon
# Instructions

== Student's Biography ==

My name is Simone Battaglia, I'm a Ph.D student in Neuroscience at Alma Mater Studiorum Bologna. I'm passionate about programming, and I like to integrate the IT world inside the neuroscience field.
I started learning programming thanks to my scientific researches and the needs of creating experiments in my study field. I got to know about WebWorldWind thanks to Patrick Hogan back in 2016 and I started using it since then.
This is my first time in the GSoC and I'm very happy to be coding for these 3 months and have the guidance of my mentors Patrick Hogan and Gabriele Prestifilippo.
[[Category:Google Summer of Code]]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-08-20T21:00:06Z

Wiki-Simonebt92: /* Weekly Reports */

== Introduction ==

My project will focus on creating a plugin to allow clusterization of markers in the
ESA-NASA Web World Wind framework. These following capabilities are the
features I would like to implement:
1. Clustering based on different algorithms
2. Set a custom icon based on user parameters: i.e., number of clusters or custom
variables
3. Cluster based on geometries and not just polygons
4. Filter clusters based on user criteria
5. Precache the cluster at the zoom levels for optimized performance

== Schedule ==

{| class="wikitable"
|-
! TODO !! Timeline !! Status
|-
| Coding begins || May 30 || Done!
|-
| Research about the clustering functionalities and about the marker classes in WWW || May 30 - June 10 ||Done!
|-
| Implementation of a clustering algorithm in WWW || June 11 - June 20 || Done!
|-
| Phase 1 Evaluation || June 26 || Done!
|-
| Creating a first version of the clustering plugin || June 26 - June 30 || Done!
|-
| Implementing clustering options to cluster markers based on attributes || July 1 - July 10 || Done!
|-
| <del> Vacation</del> Comment code and documentation || July 11 - July 18 || Done!
|-
| Phase 2 Evaluation || July 24 || Done!
|-
| Customize the design of clusters with colors and effects || July 24 - July 31 || Done!
|-
| Filter clusters on predefined attributes || August 1 - August 10 || Done!
|-
| Creating Unit Tests for the code || August 11 - August 16 || Done!
|-
| <del> Comment code and documentation</del> Vacation|| August 17 - August 21 || Done!
|-
| Finalizing documentation and reviewing the code || August 21 - 28 || Done!
|-
| Submit final work product and mentor evaluation || August 29 || Awaiting..
|}

We will try to follow the schedule and report the status of the project each week.

== Weekly Reports ==

=== Week 1 ===
* What did you get done this week?
This week I set-up the development environment and made some research about the clustering algorithms and libraries available.
I found out some good library for clustering point and it can be integrated with WebWorldWind.
* What do you plan on doing next week?
Next week I will set up the unit test environment.
* Are you blocked on anything?
I already tried this week but had some problems. However, talking with my mentors I got some advice on how to proceed.

=== Week 2 ===
* What did you get done this week?
I prepared the testing environment and unit tests are working. I prepared a sample test but also improved the structure of the project and created some functionalities.
* What do you plan on doing next week?
Next week I will improve the current functionalities and create new more to allow a better insertion of markers into the plugin.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 3 ===
* What did you get done this week?
I developed some methods to improve the clustering functionalities. It accepts now a single marker, as well a list of markers. Also, some functionalities to show and hide single and groups of markers.
I'm able to create a cluster for a specified zoom level and show it in the globe.
* What do you plan on doing next week?
Next week I would like to show and hide the clusters automatically based on the zoom level and generate at the start all the groups.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 4 ===
* What did you get done this week?
I managed to show and hide clusters based on the zoom level and hide the others. However, I encountered a small performance issue when there all too many markers in the globe.
* What do you plan on doing next week?
Next week I'm planning to hide all the markers that are not visible in the current view. I started researching and studying some code examples to achieve this.
* Are you blocked on anything?
I'm not really blocked, but I need the help of the mentors to proceed because I'm not really sure right now.

=== Week 5 ===
* What did you get done this week?
This week, as planned, I managed to hide all the markers outside the current view. I spent almost all week researching about the approaches to do that, and to improve performances I ended up using a camera model for a 2D view. Which works very well on small areas, like in our case. While, on a bigger area, I will implement maybe the 3D camera model, as suggested by my mentors.
I also created a smooth navigation to match zoom levels with cluster levels. I also implemented a GitHub page where is possible to test a demo with 200k markers.
Demo: [https://simonebt92.github.io/NASA-WWW-MarkerCluster/ https://simonebt92.github.io/NASA-WWW-MarkerCluster/]
* What do you plan on doing next week?
I will try to understand how to correlate zoom levels from WorldWind (camera range) with zoom levels from the cluster and its radius, and an optimal number of markers to show on each level.
* Are you blocked on anything?
I'm not totally blocked but I'm struggling on finding a good way to show the right amount of clusters and select a good radius when clustering.

=== Week 6 ===
* What did you get done this week?
This week I finally found how to correlate the zoom levels of World Wind with the cluster levels.
I allow now users to set a maximum level on which they can cluster.
I created some images, with a color variation depending on the number of markers a cluster contains.
I show markers on the visible area while zooming or pressing the +/- buttons.
I allow to manage at the same time different clusters (each with his setting).
I created an example with all the US cities.
I implemented single markers without clusters.
* What do you plan on doing next week?
Next week I was expected to be on vacation, but since I won't be able to go, I agreed with my mentor that I will skip few days in August and next week I will work on two things:
Handling the pan on the globe to show the markers on the visible area (now works only with zoom).
Starting commenting the code because it's getting confusing. And create a documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 7 ===
* What did you get done this week?
This week I implemented the possibility to pan in the globe and display the markers in the panning area.
I created an option to limit the visible markers to improve performances.
I commented all the functions briefly and created many unit tests (more yet to come).
* What do you plan on doing next week?
Next week I will create more unit tests, and I will work more on the customization of the clustering functionalities.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 8 ===
* What did you get done this week?
This week i've done the followings:
Enable the plugin to work with customized navigators and controls
Fixed a problem that prevented to click on a cluster and zoom
Allow the customization of the marker icons
Removed jQuery from the project
Implemented a build version for the gh-page
Implemented the plugin in a real application, and fixed a few problem that found on the project while doing it
* What do you plan on doing next week?
Next week I have still to finish some unit test and I will also try to customize more the clustering functionalities
* Are you blocked on anything?
I'm not blocked on anything

=== Week 9 ===
* What did you get done this week?
This week I allowed some customization of the settings from the user interface.
I changed the structure for the examples to insert many of them
I implemented many new examples with their own UI so that users can follow an HTML+JS example as is done in the WWW examples page.
One example for instance run 65k clusters very easily.
* What do you plan on doing next week?
Next week I need to finish the examples and use the build version to improve performances.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 10 ===
* What did you get done this week?
This week I completed some examples, and I hosted the app using the build version which is much faster.
I also created a quick start documentation and a short video showing how to use the plugin.
* What do you plan on doing next week?
Next week I will create some other examples and improve more the documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 11 ===
* What did you get done this week?
This week I created some examples, showing more functionalities of the plugin, and now users are able to test them directly on the example page.
I also started created more advanced unit tests, using mock object and spies.
* What do you plan on doing next week?
Next week I will write some other tests and finalizing the documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 12 - Final Report ===
1- Project: Plugin Marker Cluster for NASA Web World Wind

2- Abstract: The motivation behind Marker Cluster stands behind the need of porting a useful functionality into a popular framework such as Web World Wind, which, could benefit in different areas thanks to this plugin

3- The state of the art BEFORE my GSoC: Before my project, Web World Wind didn't have any external plugin, made in the same form of mine. Especially there were no cluster functionalities for the markers. Even though the concept of clustering markers is not new to the public, it was not available on this framework.

4- The added value that my project brought to the software: Thanks to my project, now any Web World Wind developer can easily import the clustering functionality in any application. Following the documentation anyone can do it, as we already tried in an example application.

5- Work to be done on the project: The project itself is quite complete, including some basic functionalities. What could miss is trying in more application the product and find problems and new features to implement.

6- Website & Documentation: https://simonebt92.github.io/NASA-WWW-MarkerCluster/

7- Image:

== Brief description of the idea ==
My project consists in the development of a Plugin for the ESA/NASA WebWorldWind framework, to allow clustering of multiple markers. 

A link to all my commits is available here: [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub].

== State of the art before this project ==

Currently there is no plugin for clustering large amounts of markers, even though an
app may implement a similar functionality, but not with a modular plugin that can be
generically reused for any number of user-specific criteria.

== Additions that this project will bring to the software ==

As a result of the plugin I will develop, it will be possible for anyone to easily import
the plugin into the framework and use it as a modular component. In this way it will
be possible to cluster markers easily, using any number of options.
As an example, it can be useful to use this plugin when visualizing a marker for each
city in Italy, because, having thousand of markers in a small area could be very
difficult to render on the globe, but also to understand. Thanks to the plugin, users
will see only a few clusters while viewing the markers from a far distance and
zooming in they will see more and more details.

== Public Repository & Testing==

The application is available in GitHub at [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub] .
More instruction on how to use the plugin will be available soon
# Instructions

== Student's Biography ==

My name is Simone Battaglia, I'm a Ph.D student in Neuroscience at Alma Mater Studiorum Bologna. I'm passionate about programming, and I like to integrate the IT world inside the neuroscience field.
I started learning programming thanks to my scientific researches and the needs of creating experiments in my study field. I got to know about WebWorldWind thanks to Patrick Hogan back in 2016 and I started using it since then.
This is my first time in the GSoC and I'm very happy to be coding for these 3 months and have the guidance of my mentors Patrick Hogan and Gabriele Prestifilippo.
[[Category:Google Summer of Code]]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-08-20T20:52:46Z

Wiki-Simonebt92: /* Schedule */

== Introduction ==

My project will focus on creating a plugin to allow clusterization of markers in the
ESA-NASA Web World Wind framework. These following capabilities are the
features I would like to implement:
1. Clustering based on different algorithms
2. Set a custom icon based on user parameters: i.e., number of clusters or custom
variables
3. Cluster based on geometries and not just polygons
4. Filter clusters based on user criteria
5. Precache the cluster at the zoom levels for optimized performance

== Schedule ==

{| class="wikitable"
|-
! TODO !! Timeline !! Status
|-
| Coding begins || May 30 || Done!
|-
| Research about the clustering functionalities and about the marker classes in WWW || May 30 - June 10 ||Done!
|-
| Implementation of a clustering algorithm in WWW || June 11 - June 20 || Done!
|-
| Phase 1 Evaluation || June 26 || Done!
|-
| Creating a first version of the clustering plugin || June 26 - June 30 || Done!
|-
| Implementing clustering options to cluster markers based on attributes || July 1 - July 10 || Done!
|-
| <del> Vacation</del> Comment code and documentation || July 11 - July 18 || Done!
|-
| Phase 2 Evaluation || July 24 || Done!
|-
| Customize the design of clusters with colors and effects || July 24 - July 31 || Done!
|-
| Filter clusters on predefined attributes || August 1 - August 10 || Done!
|-
| Creating Unit Tests for the code || August 11 - August 16 || Done!
|-
| <del> Comment code and documentation</del> Vacation|| August 17 - August 21 || Done!
|-
| Finalizing documentation and reviewing the code || August 21 - 28 || Done!
|-
| Submit final work product and mentor evaluation || August 29 || Awaiting..
|}

We will try to follow the schedule and report the status of the project each week.

== Weekly Reports ==

=== Week 1 ===
* What did you get done this week?
This week I set-up the development environment and made some research about the clustering algorithms and libraries available.
I found out some good library for clustering point and it can be integrated with WebWorldWind.
* What do you plan on doing next week?
Next week I will set up the unit test environment.
* Are you blocked on anything?
I already tried this week but had some problems. However, talking with my mentors I got some advice on how to proceed.

=== Week 2 ===
* What did you get done this week?
I prepared the testing environment and unit tests are working. I prepared a sample test but also improved the structure of the project and created some functionalities.
* What do you plan on doing next week?
Next week I will improve the current functionalities and create new more to allow a better insertion of markers into the plugin.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 3 ===
* What did you get done this week?
I developed some methods to improve the clustering functionalities. It accepts now a single marker, as well a list of markers. Also, some functionalities to show and hide single and groups of markers.
I'm able to create a cluster for a specified zoom level and show it in the globe.
* What do you plan on doing next week?
Next week I would like to show and hide the clusters automatically based on the zoom level and generate at the start all the groups.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 4 ===
* What did you get done this week?
I managed to show and hide clusters based on the zoom level and hide the others. However, I encountered a small performance issue when there all too many markers in the globe.
* What do you plan on doing next week?
Next week I'm planning to hide all the markers that are not visible in the current view. I started researching and studying some code examples to achieve this.
* Are you blocked on anything?
I'm not really blocked, but I need the help of the mentors to proceed because I'm not really sure right now.

=== Week 5 ===
* What did you get done this week?
This week, as planned, I managed to hide all the markers outside the current view. I spent almost all week researching about the approaches to do that, and to improve performances I ended up using a camera model for a 2D view. Which works very well on small areas, like in our case. While, on a bigger area, I will implement maybe the 3D camera model, as suggested by my mentors.
I also created a smooth navigation to match zoom levels with cluster levels. I also implemented a GitHub page where is possible to test a demo with 200k markers.
Demo: [https://simonebt92.github.io/NASA-WWW-MarkerCluster/ https://simonebt92.github.io/NASA-WWW-MarkerCluster/]
* What do you plan on doing next week?
I will try to understand how to correlate zoom levels from WorldWind (camera range) with zoom levels from the cluster and its radius, and an optimal number of markers to show on each level.
* Are you blocked on anything?
I'm not totally blocked but I'm struggling on finding a good way to show the right amount of clusters and select a good radius when clustering.

=== Week 6 ===
* What did you get done this week?
This week I finally found how to correlate the zoom levels of World Wind with the cluster levels.
I allow now users to set a maximum level on which they can cluster.
I created some images, with a color variation depending on the number of markers a cluster contains.
I show markers on the visible area while zooming or pressing the +/- buttons.
I allow to manage at the same time different clusters (each with his setting).
I created an example with all the US cities.
I implemented single markers without clusters.
* What do you plan on doing next week?
Next week I was expected to be on vacation, but since I won't be able to go, I agreed with my mentor that I will skip few days in August and next week I will work on two things:
Handling the pan on the globe to show the markers on the visible area (now works only with zoom).
Starting commenting the code because it's getting confusing. And create a documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 7 ===
* What did you get done this week?
This week I implemented the possibility to pan in the globe and display the markers in the panning area.
I created an option to limit the visible markers to improve performances.
I commented all the functions briefly and created many unit tests (more yet to come).
* What do you plan on doing next week?
Next week I will create more unit tests, and I will work more on the customization of the clustering functionalities.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 8 ===
* What did you get done this week?
This week i've done the followings:
Enable the plugin to work with customized navigators and controls
Fixed a problem that prevented to click on a cluster and zoom
Allow the customization of the marker icons
Removed jQuery from the project
Implemented a build version for the gh-page
Implemented the plugin in a real application, and fixed a few problem that found on the project while doing it
* What do you plan on doing next week?
Next week I have still to finish some unit test and I will also try to customize more the clustering functionalities
* Are you blocked on anything?
I'm not blocked on anything

=== Week 9 ===
* What did you get done this week?
This week I allowed some customization of the settings from the user interface.
I changed the structure for the examples to insert many of them
I implemented many new examples with their own UI so that users can follow an HTML+JS example as is done in the WWW examples page.
One example for instance run 65k clusters very easily.
* What do you plan on doing next week?
Next week I need to finish the examples and use the build version to improve performances.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 10 ===
* What did you get done this week?
This week I completed some examples, and I hosted the app using the build version which is much faster.
I also created a quick start documentation and a short video showing how to use the plugin.
* What do you plan on doing next week?
Next week I will create some other examples and improve more the documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 11 ===
* What did you get done this week?
This week I created some examples, showing more functionalities of the plugin, and now users are able to test them directly on the example page.
I also started created more advanced unit tests, using mock object and spies.
* What do you plan on doing next week?
Next week I will write some other tests and finalizing the documentation.
* Are you blocked on anything?
I'm not blocked on anything

== Brief description of the idea ==
My project consists in the development of a Plugin for the ESA/NASA WebWorldWind framework, to allow clustering of multiple markers. 

A link to all my commits is available here: [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub].

== State of the art before this project ==

Currently there is no plugin for clustering large amounts of markers, even though an
app may implement a similar functionality, but not with a modular plugin that can be
generically reused for any number of user-specific criteria.

== Additions that this project will bring to the software ==

As a result of the plugin I will develop, it will be possible for anyone to easily import
the plugin into the framework and use it as a modular component. In this way it will
be possible to cluster markers easily, using any number of options.
As an example, it can be useful to use this plugin when visualizing a marker for each
city in Italy, because, having thousand of markers in a small area could be very
difficult to render on the globe, but also to understand. Thanks to the plugin, users
will see only a few clusters while viewing the markers from a far distance and
zooming in they will see more and more details.

== Public Repository & Testing==

The application is available in GitHub at [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub] .
More instruction on how to use the plugin will be available soon
# Instructions

== Student's Biography ==

My name is Simone Battaglia, I'm a Ph.D student in Neuroscience at Alma Mater Studiorum Bologna. I'm passionate about programming, and I like to integrate the IT world inside the neuroscience field.
I started learning programming thanks to my scientific researches and the needs of creating experiments in my study field. I got to know about WebWorldWind thanks to Patrick Hogan back in 2016 and I started using it since then.
This is my first time in the GSoC and I'm very happy to be coding for these 3 months and have the guidance of my mentors Patrick Hogan and Gabriele Prestifilippo.
[[Category:Google Summer of Code]]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-08-13T07:41:19Z

Wiki-Simonebt92: /* Weekly Reports */

== Introduction ==

My project will focus on creating a plugin to allow clusterization of markers in the
ESA-NASA Web World Wind framework. These following capabilities are the
features I would like to implement:
1. Clustering based on different algorithms
2. Set a custom icon based on user parameters: i.e., number of clusters or custom
variables
3. Cluster based on geometries and not just polygons
4. Filter clusters based on user criteria
5. Precache the cluster at the zoom levels for optimized performance

== Schedule ==

{| class="wikitable"
|-
! TODO !! Timeline !! Status
|-
| Coding begins || May 30 || Done!
|-
| Research about the clustering functionalities and about the marker classes in WWW || May 30 - June 10 ||Done!
|-
| Implementation of a clustering algorithm in WWW || June 11 - June 20 || Done!
|-
| Phase 1 Evaluation || June 26 || Done!
|-
| Creating a first version of the clustering plugin || June 26 - June 30 || Done!
|-
| Implementing clustering options to cluster markers based on attributes || July 1 - July 10 || Done!
|-
| <del> Vacation</del> Comment code and documentation || July 11 - July 18 || Done!
|-
| Phase 2 Evaluation || July 24 || Done!
|-
| Customize the design of clusters with colors and effects || July 24 - July 31 || Done!
|-
| Filter clusters on predefined attributes || August 1 - August 10 || Done!
|-
| Creating Unit Tests for the code || August 11 - August 16 || Done!
|-
| <del> Comment code and documentation</del> Vacation|| August 17 - August 21 || Awaiting..
|-
| Finalizing documentation and reviewing the code || August 21 - 28 || Awaiting..
|-
| Submit final work product and mentor evaluation || August 29 || Awaiting..
|}

We will try to follow the schedule and report the status of the project each week.

== Weekly Reports ==

=== Week 1 ===
* What did you get done this week?
This week I set-up the development environment and made some research about the clustering algorithms and libraries available.
I found out some good library for clustering point and it can be integrated with WebWorldWind.
* What do you plan on doing next week?
Next week I will set up the unit test environment.
* Are you blocked on anything?
I already tried this week but had some problems. However, talking with my mentors I got some advice on how to proceed.

=== Week 2 ===
* What did you get done this week?
I prepared the testing environment and unit tests are working. I prepared a sample test but also improved the structure of the project and created some functionalities.
* What do you plan on doing next week?
Next week I will improve the current functionalities and create new more to allow a better insertion of markers into the plugin.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 3 ===
* What did you get done this week?
I developed some methods to improve the clustering functionalities. It accepts now a single marker, as well a list of markers. Also, some functionalities to show and hide single and groups of markers.
I'm able to create a cluster for a specified zoom level and show it in the globe.
* What do you plan on doing next week?
Next week I would like to show and hide the clusters automatically based on the zoom level and generate at the start all the groups.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 4 ===
* What did you get done this week?
I managed to show and hide clusters based on the zoom level and hide the others. However, I encountered a small performance issue when there all too many markers in the globe.
* What do you plan on doing next week?
Next week I'm planning to hide all the markers that are not visible in the current view. I started researching and studying some code examples to achieve this.
* Are you blocked on anything?
I'm not really blocked, but I need the help of the mentors to proceed because I'm not really sure right now.

=== Week 5 ===
* What did you get done this week?
This week, as planned, I managed to hide all the markers outside the current view. I spent almost all week researching about the approaches to do that, and to improve performances I ended up using a camera model for a 2D view. Which works very well on small areas, like in our case. While, on a bigger area, I will implement maybe the 3D camera model, as suggested by my mentors.
I also created a smooth navigation to match zoom levels with cluster levels. I also implemented a GitHub page where is possible to test a demo with 200k markers.
Demo: [https://simonebt92.github.io/NASA-WWW-MarkerCluster/ https://simonebt92.github.io/NASA-WWW-MarkerCluster/]
* What do you plan on doing next week?
I will try to understand how to correlate zoom levels from WorldWind (camera range) with zoom levels from the cluster and its radius, and an optimal number of markers to show on each level.
* Are you blocked on anything?
I'm not totally blocked but I'm struggling on finding a good way to show the right amount of clusters and select a good radius when clustering.

=== Week 6 ===
* What did you get done this week?
This week I finally found how to correlate the zoom levels of World Wind with the cluster levels.
I allow now users to set a maximum level on which they can cluster.
I created some images, with a color variation depending on the number of markers a cluster contains.
I show markers on the visible area while zooming or pressing the +/- buttons.
I allow to manage at the same time different clusters (each with his setting).
I created an example with all the US cities.
I implemented single markers without clusters.
* What do you plan on doing next week?
Next week I was expected to be on vacation, but since I won't be able to go, I agreed with my mentor that I will skip few days in August and next week I will work on two things:
Handling the pan on the globe to show the markers on the visible area (now works only with zoom).
Starting commenting the code because it's getting confusing. And create a documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 7 ===
* What did you get done this week?
This week I implemented the possibility to pan in the globe and display the markers in the panning area.
I created an option to limit the visible markers to improve performances.
I commented all the functions briefly and created many unit tests (more yet to come).
* What do you plan on doing next week?
Next week I will create more unit tests, and I will work more on the customization of the clustering functionalities.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 8 ===
* What did you get done this week?
This week i've done the followings:
Enable the plugin to work with customized navigators and controls
Fixed a problem that prevented to click on a cluster and zoom
Allow the customization of the marker icons
Removed jQuery from the project
Implemented a build version for the gh-page
Implemented the plugin in a real application, and fixed a few problem that found on the project while doing it
* What do you plan on doing next week?
Next week I have still to finish some unit test and I will also try to customize more the clustering functionalities
* Are you blocked on anything?
I'm not blocked on anything

=== Week 9 ===
* What did you get done this week?
This week I allowed some customization of the settings from the user interface.
I changed the structure for the examples to insert many of them
I implemented many new examples with their own UI so that users can follow an HTML+JS example as is done in the WWW examples page.
One example for instance run 65k clusters very easily.
* What do you plan on doing next week?
Next week I need to finish the examples and use the build version to improve performances.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 10 ===
* What did you get done this week?
This week I completed some examples, and I hosted the app using the build version which is much faster.
I also created a quick start documentation and a short video showing how to use the plugin.
* What do you plan on doing next week?
Next week I will create some other examples and improve more the documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 11 ===
* What did you get done this week?
This week I created some examples, showing more functionalities of the plugin, and now users are able to test them directly on the example page.
I also started created more advanced unit tests, using mock object and spies.
* What do you plan on doing next week?
Next week I will write some other tests and finalizing the documentation.
* Are you blocked on anything?
I'm not blocked on anything

== Brief description of the idea ==
My project consists in the development of a Plugin for the ESA/NASA WebWorldWind framework, to allow clustering of multiple markers. 

A link to all my commits is available here: [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub].

== State of the art before this project ==

Currently there is no plugin for clustering large amounts of markers, even though an
app may implement a similar functionality, but not with a modular plugin that can be
generically reused for any number of user-specific criteria.

== Additions that this project will bring to the software ==

As a result of the plugin I will develop, it will be possible for anyone to easily import
the plugin into the framework and use it as a modular component. In this way it will
be possible to cluster markers easily, using any number of options.
As an example, it can be useful to use this plugin when visualizing a marker for each
city in Italy, because, having thousand of markers in a small area could be very
difficult to render on the globe, but also to understand. Thanks to the plugin, users
will see only a few clusters while viewing the markers from a far distance and
zooming in they will see more and more details.

== Public Repository & Testing==

The application is available in GitHub at [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub] .
More instruction on how to use the plugin will be available soon
# Instructions

== Student's Biography ==

My name is Simone Battaglia, I'm a Ph.D student in Neuroscience at Alma Mater Studiorum Bologna. I'm passionate about programming, and I like to integrate the IT world inside the neuroscience field.
I started learning programming thanks to my scientific researches and the needs of creating experiments in my study field. I got to know about WebWorldWind thanks to Patrick Hogan back in 2016 and I started using it since then.
This is my first time in the GSoC and I'm very happy to be coding for these 3 months and have the guidance of my mentors Patrick Hogan and Gabriele Prestifilippo.
[[Category:Google Summer of Code]]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-08-13T07:39:22Z

Wiki-Simonebt92: /* Schedule */

== Introduction ==

My project will focus on creating a plugin to allow clusterization of markers in the
ESA-NASA Web World Wind framework. These following capabilities are the
features I would like to implement:
1. Clustering based on different algorithms
2. Set a custom icon based on user parameters: i.e., number of clusters or custom
variables
3. Cluster based on geometries and not just polygons
4. Filter clusters based on user criteria
5. Precache the cluster at the zoom levels for optimized performance

== Schedule ==

{| class="wikitable"
|-
! TODO !! Timeline !! Status
|-
| Coding begins || May 30 || Done!
|-
| Research about the clustering functionalities and about the marker classes in WWW || May 30 - June 10 ||Done!
|-
| Implementation of a clustering algorithm in WWW || June 11 - June 20 || Done!
|-
| Phase 1 Evaluation || June 26 || Done!
|-
| Creating a first version of the clustering plugin || June 26 - June 30 || Done!
|-
| Implementing clustering options to cluster markers based on attributes || July 1 - July 10 || Done!
|-
| <del> Vacation</del> Comment code and documentation || July 11 - July 18 || Done!
|-
| Phase 2 Evaluation || July 24 || Done!
|-
| Customize the design of clusters with colors and effects || July 24 - July 31 || Done!
|-
| Filter clusters on predefined attributes || August 1 - August 10 || Done!
|-
| Creating Unit Tests for the code || August 11 - August 16 || Done!
|-
| <del> Comment code and documentation</del> Vacation|| August 17 - August 21 || Awaiting..
|-
| Finalizing documentation and reviewing the code || August 21 - 28 || Awaiting..
|-
| Submit final work product and mentor evaluation || August 29 || Awaiting..
|}

We will try to follow the schedule and report the status of the project each week.

== Weekly Reports ==

=== Week 1 ===
* What did you get done this week?
This week I set-up the development environment and made some research about the clustering algorithms and libraries available.
I found out some good library for clustering point and it can be integrated with WebWorldWind.
* What do you plan on doing next week?
Next week I will set up the unit test environment.
* Are you blocked on anything?
I already tried this week but had some problems. However, talking with my mentors I got some advice on how to proceed.

=== Week 2 ===
* What did you get done this week?
I prepared the testing environment and unit tests are working. I prepared a sample test but also improved the structure of the project and created some functionalities.
* What do you plan on doing next week?
Next week I will improve the current functionalities and create new more to allow a better insertion of markers into the plugin.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 3 ===
* What did you get done this week?
I developed some methods to improve the clustering functionalities. It accepts now a single marker, as well a list of markers. Also, some functionalities to show and hide single and groups of markers.
I'm able to create a cluster for a specified zoom level and show it in the globe.
* What do you plan on doing next week?
Next week I would like to show and hide the clusters automatically based on the zoom level and generate at the start all the groups.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 4 ===
* What did you get done this week?
I managed to show and hide clusters based on the zoom level and hide the others. However, I encountered a small performance issue when there all too many markers in the globe.
* What do you plan on doing next week?
Next week I'm planning to hide all the markers that are not visible in the current view. I started researching and studying some code examples to achieve this.
* Are you blocked on anything?
I'm not really blocked, but I need the help of the mentors to proceed because I'm not really sure right now.

=== Week 5 ===
* What did you get done this week?
This week, as planned, I managed to hide all the markers outside the current view. I spent almost all week researching about the approaches to do that, and to improve performances I ended up using a camera model for a 2D view. Which works very well on small areas, like in our case. While, on a bigger area, I will implement maybe the 3D camera model, as suggested by my mentors.
I also created a smooth navigation to match zoom levels with cluster levels. I also implemented a GitHub page where is possible to test a demo with 200k markers.
Demo: [https://simonebt92.github.io/NASA-WWW-MarkerCluster/ https://simonebt92.github.io/NASA-WWW-MarkerCluster/]
* What do you plan on doing next week?
I will try to understand how to correlate zoom levels from WorldWind (camera range) with zoom levels from the cluster and its radius, and an optimal number of markers to show on each level.
* Are you blocked on anything?
I'm not totally blocked but I'm struggling on finding a good way to show the right amount of clusters and select a good radius when clustering.

=== Week 6 ===
* What did you get done this week?
This week I finally found how to correlate the zoom levels of World Wind with the cluster levels.
I allow now users to set a maximum level on which they can cluster.
I created some images, with a color variation depending on the number of markers a cluster contains.
I show markers on the visible area while zooming or pressing the +/- buttons.
I allow to manage at the same time different clusters (each with his setting).
I created an example with all the US cities.
I implemented single markers without clusters.
* What do you plan on doing next week?
Next week I was expected to be on vacation, but since I won't be able to go, I agreed with my mentor that I will skip few days in August and next week I will work on two things:
Handling the pan on the globe to show the markers on the visible area (now works only with zoom).
Starting commenting the code because it's getting confusing. And create a documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 7 ===
* What did you get done this week?
This week I implemented the possibility to pan in the globe and display the markers in the panning area.
I created an option to limit the visible markers to improve performances.
I commented all the functions briefly and created many unit tests (more yet to come).
* What do you plan on doing next week?
Next week I will create more unit tests, and I will work more on the customization of the clustering functionalities.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 8 ===
* What did you get done this week?
This week i've done the followings:
Enable the plugin to work with customized navigators and controls
Fixed a problem that prevented to click on a cluster and zoom
Allow the customization of the marker icons
Removed jQuery from the project
Implemented a build version for the gh-page
Implemented the plugin in a real application, and fixed a few problem that found on the project while doing it
* What do you plan on doing next week?
Next week I have still to finish some unit test and I will also try to customize more the clustering functionalities
* Are you blocked on anything?
I'm not blocked on anything

=== Week 9 ===
* What did you get done this week?
This week I allowed some customization of the settings from the user interface.
I changed the structure for the examples to insert many of them
I implemented many new examples with their own UI so that users can follow an HTML+JS example as is done in the WWW examples page.
One example for instance run 65k clusters very easily.
* What do you plan on doing next week?
Next week I need to finish the examples and use the build version to improve performances.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 10 ===
* What did you get done this week?
This week I completed some examples, and I hosted the app using the build version which is much faster.
I also created a quick start documentation and a short video showing how to use the plugin.
* What do you plan on doing next week?
Next week I will create some other examples and improve more the documentation.
* Are you blocked on anything?
I'm not blocked on anything

== Brief description of the idea ==
My project consists in the development of a Plugin for the ESA/NASA WebWorldWind framework, to allow clustering of multiple markers. 

A link to all my commits is available here: [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub].

== State of the art before this project ==

Currently there is no plugin for clustering large amounts of markers, even though an
app may implement a similar functionality, but not with a modular plugin that can be
generically reused for any number of user-specific criteria.

== Additions that this project will bring to the software ==

As a result of the plugin I will develop, it will be possible for anyone to easily import
the plugin into the framework and use it as a modular component. In this way it will
be possible to cluster markers easily, using any number of options.
As an example, it can be useful to use this plugin when visualizing a marker for each
city in Italy, because, having thousand of markers in a small area could be very
difficult to render on the globe, but also to understand. Thanks to the plugin, users
will see only a few clusters while viewing the markers from a far distance and
zooming in they will see more and more details.

== Public Repository & Testing==

The application is available in GitHub at [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub] .
More instruction on how to use the plugin will be available soon
# Instructions

== Student's Biography ==

My name is Simone Battaglia, I'm a Ph.D student in Neuroscience at Alma Mater Studiorum Bologna. I'm passionate about programming, and I like to integrate the IT world inside the neuroscience field.
I started learning programming thanks to my scientific researches and the needs of creating experiments in my study field. I got to know about WebWorldWind thanks to Patrick Hogan back in 2016 and I started using it since then.
This is my first time in the GSoC and I'm very happy to be coding for these 3 months and have the guidance of my mentors Patrick Hogan and Gabriele Prestifilippo.
[[Category:Google Summer of Code]]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-08-06T17:44:08Z

Wiki-Simonebt92: /* Weekly Reports */

== Introduction ==

My project will focus on creating a plugin to allow clusterization of markers in the
ESA-NASA Web World Wind framework. These following capabilities are the
features I would like to implement:
1. Clustering based on different algorithms
2. Set a custom icon based on user parameters: i.e., number of clusters or custom
variables
3. Cluster based on geometries and not just polygons
4. Filter clusters based on user criteria
5. Precache the cluster at the zoom levels for optimized performance

== Schedule ==

{| class="wikitable"
|-
! TODO !! Timeline !! Status
|-
| Coding begins || May 30 || Done!
|-
| Research about the clustering functionalities and about the marker classes in WWW || May 30 - June 10 ||Done!
|-
| Implementation of a clustering algorithm in WWW || June 11 - June 20 || Done!
|-
| Phase 1 Evaluation || June 26 || Done!
|-
| Creating a first version of the clustering plugin || June 26 - June 30 || Done!
|-
| Implementing clustering options to cluster markers based on attributes || July 1 - July 10 || Done!
|-
| <del> Vacation</del> Comment code and documentation || July 11 - July 18 || Done!
|-
| Phase 2 Evaluation || July 24 || Done!
|-
| Customize the design of clusters with colors and effects || July 24 - July 31 || Done!
|-
| Filter clusters on predefined attributes || August 1 - August 10 || Awaiting..
|-
| Creating Unit Tests for the code || August 11 - August 16 || Awaiting..
|-
| <del> Comment code and documentation</del> Vacation|| August 17 - August 21 || Awaiting..
|-
| Finalizing documentation and reviewing the code || August 21 - 28 || Awaiting..
|-
| Submit final work product and mentor evaluation || August 29 || Awaiting..
|}

We will try to follow the schedule and report the status of the project each week.

== Weekly Reports ==

=== Week 1 ===
* What did you get done this week?
This week I set-up the development environment and made some research about the clustering algorithms and libraries available.
I found out some good library for clustering point and it can be integrated with WebWorldWind.
* What do you plan on doing next week?
Next week I will set up the unit test environment.
* Are you blocked on anything?
I already tried this week but had some problems. However, talking with my mentors I got some advice on how to proceed.

=== Week 2 ===
* What did you get done this week?
I prepared the testing environment and unit tests are working. I prepared a sample test but also improved the structure of the project and created some functionalities.
* What do you plan on doing next week?
Next week I will improve the current functionalities and create new more to allow a better insertion of markers into the plugin.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 3 ===
* What did you get done this week?
I developed some methods to improve the clustering functionalities. It accepts now a single marker, as well a list of markers. Also, some functionalities to show and hide single and groups of markers.
I'm able to create a cluster for a specified zoom level and show it in the globe.
* What do you plan on doing next week?
Next week I would like to show and hide the clusters automatically based on the zoom level and generate at the start all the groups.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 4 ===
* What did you get done this week?
I managed to show and hide clusters based on the zoom level and hide the others. However, I encountered a small performance issue when there all too many markers in the globe.
* What do you plan on doing next week?
Next week I'm planning to hide all the markers that are not visible in the current view. I started researching and studying some code examples to achieve this.
* Are you blocked on anything?
I'm not really blocked, but I need the help of the mentors to proceed because I'm not really sure right now.

=== Week 5 ===
* What did you get done this week?
This week, as planned, I managed to hide all the markers outside the current view. I spent almost all week researching about the approaches to do that, and to improve performances I ended up using a camera model for a 2D view. Which works very well on small areas, like in our case. While, on a bigger area, I will implement maybe the 3D camera model, as suggested by my mentors.
I also created a smooth navigation to match zoom levels with cluster levels. I also implemented a GitHub page where is possible to test a demo with 200k markers.
Demo: [https://simonebt92.github.io/NASA-WWW-MarkerCluster/ https://simonebt92.github.io/NASA-WWW-MarkerCluster/]
* What do you plan on doing next week?
I will try to understand how to correlate zoom levels from WorldWind (camera range) with zoom levels from the cluster and its radius, and an optimal number of markers to show on each level.
* Are you blocked on anything?
I'm not totally blocked but I'm struggling on finding a good way to show the right amount of clusters and select a good radius when clustering.

=== Week 6 ===
* What did you get done this week?
This week I finally found how to correlate the zoom levels of World Wind with the cluster levels.
I allow now users to set a maximum level on which they can cluster.
I created some images, with a color variation depending on the number of markers a cluster contains.
I show markers on the visible area while zooming or pressing the +/- buttons.
I allow to manage at the same time different clusters (each with his setting).
I created an example with all the US cities.
I implemented single markers without clusters.
* What do you plan on doing next week?
Next week I was expected to be on vacation, but since I won't be able to go, I agreed with my mentor that I will skip few days in August and next week I will work on two things:
Handling the pan on the globe to show the markers on the visible area (now works only with zoom).
Starting commenting the code because it's getting confusing. And create a documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 7 ===
* What did you get done this week?
This week I implemented the possibility to pan in the globe and display the markers in the panning area.
I created an option to limit the visible markers to improve performances.
I commented all the functions briefly and created many unit tests (more yet to come).
* What do you plan on doing next week?
Next week I will create more unit tests, and I will work more on the customization of the clustering functionalities.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 8 ===
* What did you get done this week?
This week i've done the followings:
Enable the plugin to work with customized navigators and controls
Fixed a problem that prevented to click on a cluster and zoom
Allow the customization of the marker icons
Removed jQuery from the project
Implemented a build version for the gh-page
Implemented the plugin in a real application, and fixed a few problem that found on the project while doing it
* What do you plan on doing next week?
Next week I have still to finish some unit test and I will also try to customize more the clustering functionalities
* Are you blocked on anything?
I'm not blocked on anything

=== Week 9 ===
* What did you get done this week?
This week I allowed some customization of the settings from the user interface.
I changed the structure for the examples to insert many of them
I implemented many new examples with their own UI so that users can follow an HTML+JS example as is done in the WWW examples page.
One example for instance run 65k clusters very easily.
* What do you plan on doing next week?
Next week I need to finish the examples and use the build version to improve performances.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 10 ===
* What did you get done this week?
This week I completed some examples, and I hosted the app using the build version which is much faster.
I also created a quick start documentation and a short video showing how to use the plugin.
* What do you plan on doing next week?
Next week I will create some other examples and improve more the documentation.
* Are you blocked on anything?
I'm not blocked on anything

== Brief description of the idea ==
My project consists in the development of a Plugin for the ESA/NASA WebWorldWind framework, to allow clustering of multiple markers. 

A link to all my commits is available here: [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub].

== State of the art before this project ==

Currently there is no plugin for clustering large amounts of markers, even though an
app may implement a similar functionality, but not with a modular plugin that can be
generically reused for any number of user-specific criteria.

== Additions that this project will bring to the software ==

As a result of the plugin I will develop, it will be possible for anyone to easily import
the plugin into the framework and use it as a modular component. In this way it will
be possible to cluster markers easily, using any number of options.
As an example, it can be useful to use this plugin when visualizing a marker for each
city in Italy, because, having thousand of markers in a small area could be very
difficult to render on the globe, but also to understand. Thanks to the plugin, users
will see only a few clusters while viewing the markers from a far distance and
zooming in they will see more and more details.

== Public Repository & Testing==

The application is available in GitHub at [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub] .
More instruction on how to use the plugin will be available soon
# Instructions

== Student's Biography ==

My name is Simone Battaglia, I'm a Ph.D student in Neuroscience at Alma Mater Studiorum Bologna. I'm passionate about programming, and I like to integrate the IT world inside the neuroscience field.
I started learning programming thanks to my scientific researches and the needs of creating experiments in my study field. I got to know about WebWorldWind thanks to Patrick Hogan back in 2016 and I started using it since then.
This is my first time in the GSoC and I'm very happy to be coding for these 3 months and have the guidance of my mentors Patrick Hogan and Gabriele Prestifilippo.
[[Category:Google Summer of Code]]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-07-29T08:15:34Z

Wiki-Simonebt92:

== Introduction ==

My project will focus on creating a plugin to allow clusterization of markers in the
ESA-NASA Web World Wind framework. These following capabilities are the
features I would like to implement:
1. Clustering based on different algorithms
2. Set a custom icon based on user parameters: i.e., number of clusters or custom
variables
3. Cluster based on geometries and not just polygons
4. Filter clusters based on user criteria
5. Precache the cluster at the zoom levels for optimized performance

== Schedule ==

{| class="wikitable"
|-
! TODO !! Timeline !! Status
|-
| Coding begins || May 30 || Done!
|-
| Research about the clustering functionalities and about the marker classes in WWW || May 30 - June 10 ||Done!
|-
| Implementation of a clustering algorithm in WWW || June 11 - June 20 || Done!
|-
| Phase 1 Evaluation || June 26 || Done!
|-
| Creating a first version of the clustering plugin || June 26 - June 30 || Done!
|-
| Implementing clustering options to cluster markers based on attributes || July 1 - July 10 || Done!
|-
| <del> Vacation</del> Comment code and documentation || July 11 - July 18 || Done!
|-
| Phase 2 Evaluation || July 24 || Done!
|-
| Customize the design of clusters with colors and effects || July 24 - July 31 || Done!
|-
| Filter clusters on predefined attributes || August 1 - August 10 || Awaiting..
|-
| Creating Unit Tests for the code || August 11 - August 16 || Awaiting..
|-
| <del> Comment code and documentation</del> Vacation|| August 17 - August 21 || Awaiting..
|-
| Finalizing documentation and reviewing the code || August 21 - 28 || Awaiting..
|-
| Submit final work product and mentor evaluation || August 29 || Awaiting..
|}

We will try to follow the schedule and report the status of the project each week.

== Weekly Reports ==

=== Week 1 ===
* What did you get done this week?
This week I set-up the development environment and made some research about the clustering algorithms and libraries available.
I found out some good library for clustering point and it can be integrated with WebWorldWind.
* What do you plan on doing next week?
Next week I will set up the unit test environment.
* Are you blocked on anything?
I already tried this week but had some problems. However, talking with my mentors I got some advice on how to proceed.

=== Week 2 ===
* What did you get done this week?
I prepared the testing environment and unit tests are working. I prepared a sample test but also improved the structure of the project and created some functionalities.
* What do you plan on doing next week?
Next week I will improve the current functionalities and create new more to allow a better insertion of markers into the plugin.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 3 ===
* What did you get done this week?
I developed some methods to improve the clustering functionalities. It accepts now a single marker, as well a list of markers. Also, some functionalities to show and hide single and groups of markers.
I'm able to create a cluster for a specified zoom level and show it in the globe.
* What do you plan on doing next week?
Next week I would like to show and hide the clusters automatically based on the zoom level and generate at the start all the groups.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 4 ===
* What did you get done this week?
I managed to show and hide clusters based on the zoom level and hide the others. However, I encountered a small performance issue when there all too many markers in the globe.
* What do you plan on doing next week?
Next week I'm planning to hide all the markers that are not visible in the current view. I started researching and studying some code examples to achieve this.
* Are you blocked on anything?
I'm not really blocked, but I need the help of the mentors to proceed because I'm not really sure right now.

=== Week 5 ===
* What did you get done this week?
This week, as planned, I managed to hide all the markers outside the current view. I spent almost all week researching about the approaches to do that, and to improve performances I ended up using a camera model for a 2D view. Which works very well on small areas, like in our case. While, on a bigger area, I will implement maybe the 3D camera model, as suggested by my mentors.
I also created a smooth navigation to match zoom levels with cluster levels. I also implemented a GitHub page where is possible to test a demo with 200k markers.
Demo: [https://simonebt92.github.io/NASA-WWW-MarkerCluster/ https://simonebt92.github.io/NASA-WWW-MarkerCluster/]
* What do you plan on doing next week?
I will try to understand how to correlate zoom levels from WorldWind (camera range) with zoom levels from the cluster and its radius, and an optimal number of markers to show on each level.
* Are you blocked on anything?
I'm not totally blocked but I'm struggling on finding a good way to show the right amount of clusters and select a good radius when clustering.

=== Week 6 ===
* What did you get done this week?
This week I finally found how to correlate the zoom levels of World Wind with the cluster levels.
I allow now users to set a maximum level on which they can cluster.
I created some images, with a color variation depending on the number of markers a cluster contains.
I show markers on the visible area while zooming or pressing the +/- buttons.
I allow to manage at the same time different clusters (each with his setting).
I created an example with all the US cities.
I implemented single markers without clusters.
* What do you plan on doing next week?
Next week I was expected to be on vacation, but since I won't be able to go, I agreed with my mentor that I will skip few days in August and next week I will work on two things:
Handling the pan on the globe to show the markers on the visible area (now works only with zoom).
Starting commenting the code because it's getting confusing. And create a documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 7 ===
* What did you get done this week?
This week I implemented the possibility to pan in the globe and display the markers in the panning area.
I created an option to limit the visible markers to improve performances.
I commented all the functions briefly and created many unit tests (more yet to come).
* What do you plan on doing next week?
Next week I will create more unit tests, and I will work more on the customization of the clustering functionalities.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 8 ===
* What did you get done this week?
This week i've done the followings:
Enable the plugin to work with customized navigators and controls
Fixed a problem that prevented to click on a cluster and zoom
Allow the customization of the marker icons
Removed jQuery from the project
Implemented a build version for the gh-page
Implemented the plugin in a real application, and fixed a few problem that found on the project while doing it
* What do you plan on doing next week?
Next week I have still to finish some unit test and I will also try to customize more the clustering functionalities
* Are you blocked on anything?
I'm not blocked on anything

=== Week 9 ===
* What did you get done this week?
This week I allowed some customization of the settings from the user interface.
I changed the structure for the examples to insert many of them
I implemented many new examples with their own UI so that users can follow an HTML+JS example as is done in the WWW examples page.
One example for instance run 65k clusters very easily.
* What do you plan on doing next week?
Next week I need to finish the examples and use the build version to improve performances.
* Are you blocked on anything?
I'm not blocked on anything

== Brief description of the idea ==
My project consists in the development of a Plugin for the ESA/NASA WebWorldWind framework, to allow clustering of multiple markers. 

A link to all my commits is available here: [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub].

== State of the art before this project ==

Currently there is no plugin for clustering large amounts of markers, even though an
app may implement a similar functionality, but not with a modular plugin that can be
generically reused for any number of user-specific criteria.

== Additions that this project will bring to the software ==

As a result of the plugin I will develop, it will be possible for anyone to easily import
the plugin into the framework and use it as a modular component. In this way it will
be possible to cluster markers easily, using any number of options.
As an example, it can be useful to use this plugin when visualizing a marker for each
city in Italy, because, having thousand of markers in a small area could be very
difficult to render on the globe, but also to understand. Thanks to the plugin, users
will see only a few clusters while viewing the markers from a far distance and
zooming in they will see more and more details.

== Public Repository & Testing==

The application is available in GitHub at [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub] .
More instruction on how to use the plugin will be available soon
# Instructions

== Student's Biography ==

My name is Simone Battaglia, I'm a Ph.D student in Neuroscience at Alma Mater Studiorum Bologna. I'm passionate about programming, and I like to integrate the IT world inside the neuroscience field.
I started learning programming thanks to my scientific researches and the needs of creating experiments in my study field. I got to know about WebWorldWind thanks to Patrick Hogan back in 2016 and I started using it since then.
This is my first time in the GSoC and I'm very happy to be coding for these 3 months and have the guidance of my mentors Patrick Hogan and Gabriele Prestifilippo.
[[Category:Google Summer of Code]]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-07-23T09:42:19Z

Wiki-Simonebt92: /* Weekly Reports */

== Introduction ==

My project will focus on creating a plugin to allow clusterization of markers in the
ESA-NASA Web World Wind framework. These following capabilities are the
features I would like to implement:
1. Clustering based on different algorithms
2. Set a custom icon based on user parameters: i.e., number of clusters or custom
variables
3. Cluster based on geometries and not just polygons
4. Filter clusters based on user criteria
5. Precache the cluster at the zoom levels for optimized performance

== Schedule ==

{| class="wikitable"
|-
! TODO !! Timeline !! Status
|-
| Coding begins || May 30 || Done!
|-
| Research about the clustering functionalities and about the marker classes in WWW || May 30 - June 10 ||Done!
|-
| Implementation of a clustering algorithm in WWW || June 11 - June 20 || Done!
|-
| Phase 1 Evaluation || June 26 || Done!
|-
| Creating a first version of the clustering plugin || June 26 - June 30 || Done!
|-
| Implementing clustering options to cluster markers based on attributes || July 1 - July 10 || Done!
|-
| <del> Vacation</del> Comment code and documentation || July 11 - July 18 || Done!
|-
| Phase 2 Evaluation || July 24 || Awaiting..
|-
| Customize the design of clusters with colors and effects || July 24 - July 31 || Awaiting..
|-
| Filter clusters on predefined attributes || August 1 - August 10 || Awaiting..
|-
| Creating Unit Tests for the code || August 11 - August 16 || Awaiting..
|-
| <del> Comment code and documentation</del> Vacation|| August 17 - August 21 || Awaiting..
|-
| Finalizing documentation and reviewing the code || August 21 - 28 || Awaiting..
|-
| Submit final work product and mentor evaluation || August 29 || Awaiting..
|}

We will try to follow the schedule and report the status of the project each week.

== Weekly Reports ==

=== Week 1 ===
* What did you get done this week?
This week I set-up the development environment and made some research about the clustering algorithms and libraries available.
I found out some good library for clustering point and it can be integrated with WebWorldWind.
* What do you plan on doing next week?
Next week I will set up the unit test environment.
* Are you blocked on anything?
I already tried this week but had some problems. However, talking with my mentors I got some advice on how to proceed.

=== Week 2 ===
* What did you get done this week?
I prepared the testing environment and unit tests are working. I prepared a sample test but also improved the structure of the project and created some functionalities.
* What do you plan on doing next week?
Next week I will improve the current functionalities and create new more to allow a better insertion of markers into the plugin.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 3 ===
* What did you get done this week?
I developed some methods to improve the clustering functionalities. It accepts now a single marker, as well a list of markers. Also, some functionalities to show and hide single and groups of markers.
I'm able to create a cluster for a specified zoom level and show it in the globe.
* What do you plan on doing next week?
Next week I would like to show and hide the clusters automatically based on the zoom level and generate at the start all the groups.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 4 ===
* What did you get done this week?
I managed to show and hide clusters based on the zoom level and hide the others. However, I encountered a small performance issue when there all too many markers in the globe.
* What do you plan on doing next week?
Next week I'm planning to hide all the markers that are not visible in the current view. I started researching and studying some code examples to achieve this.
* Are you blocked on anything?
I'm not really blocked, but I need the help of the mentors to proceed because I'm not really sure right now.

=== Week 5 ===
* What did you get done this week?
This week, as planned, I managed to hide all the markers outside the current view. I spent almost all week researching about the approaches to do that, and to improve performances I ended up using a camera model for a 2D view. Which works very well on small areas, like in our case. While, on a bigger area, I will implement maybe the 3D camera model, as suggested by my mentors.
I also created a smooth navigation to match zoom levels with cluster levels. I also implemented a GitHub page where is possible to test a demo with 200k markers.
Demo: [https://simonebt92.github.io/NASA-WWW-MarkerCluster/ https://simonebt92.github.io/NASA-WWW-MarkerCluster/]
* What do you plan on doing next week?
I will try to understand how to correlate zoom levels from WorldWind (camera range) with zoom levels from the cluster and its radius, and an optimal number of markers to show on each level.
* Are you blocked on anything?
I'm not totally blocked but I'm struggling on finding a good way to show the right amount of clusters and select a good radius when clustering.

=== Week 6 ===
* What did you get done this week?
This week I finally found how to correlate the zoom levels of World Wind with the cluster levels.
I allow now users to set a maximum level on which they can cluster.
I created some images, with a color variation depending on the number of markers a cluster contains.
I show markers on the visible area while zooming or pressing the +/- buttons.
I allow to manage at the same time different clusters (each with his setting).
I created an example with all the US cities.
I implemented single markers without clusters.
* What do you plan on doing next week?
Next week I was expected to be on vacation, but since I won't be able to go, I agreed with my mentor that I will skip few days in August and next week I will work on two things:
Handling the pan on the globe to show the markers on the visible area (now works only with zoom).
Starting commenting the code because it's getting confusing. And create a documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 7 ===
* What did you get done this week?
This week I implemented the possibility to pan in the globe and display the markers in the panning area.
I created an option to limit the visible markers to improve performances.
I commented all the functions briefly and created many unit tests (more yet to come).
* What do you plan on doing next week?
Next week I will create more unit tests, and I will work more on the customization of the clustering functionalities.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 8 ===
* What did you get done this week?
This week i've done the followings:
Enable the plugin to work with customized navigators and controls
Fixed a problem that prevented to click on a cluster and zoom
Allow the customization of the marker icons
Removed jQuery from the project
Implemented a build version for the gh-page
Implemented the plugin in a real application, and fixed a few problem that found on the project while doing it
* What do you plan on doing next week?
Next week I have still to finish some unit test and I will also try to customize more the clustering functionalities
* Are you blocked on anything?
I'm not blocked on anything

== Brief description of the idea ==
My project consists in the development of a Plugin for the ESA/NASA WebWorldWind framework, to allow clustering of multiple markers. 

A link to all my commits is available here: [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub].

== State of the art before this project ==

Currently there is no plugin for clustering large amounts of markers, even though an
app may implement a similar functionality, but not with a modular plugin that can be
generically reused for any number of user-specific criteria.

== Additions that this project will bring to the software ==

As a result of the plugin I will develop, it will be possible for anyone to easily import
the plugin into the framework and use it as a modular component. In this way it will
be possible to cluster markers easily, using any number of options.
As an example, it can be useful to use this plugin when visualizing a marker for each
city in Italy, because, having thousand of markers in a small area could be very
difficult to render on the globe, but also to understand. Thanks to the plugin, users
will see only a few clusters while viewing the markers from a far distance and
zooming in they will see more and more details.

== Public Repository & Testing==

The application is available in GitHub at [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub] .
More instruction on how to use the plugin will be available soon
# Instructions

== Student's Biography ==

My name is Simone Battaglia, I'm a Ph.D student in Neuroscience at Alma Mater Studiorum Bologna. I'm passionate about programming, and I like to integrate the IT world inside the neuroscience field.
I started learning programming thanks to my scientific researches and the needs of creating experiments in my study field. I got to know about WebWorldWind thanks to Patrick Hogan back in 2016 and I started using it since then.
This is my first time in the GSoC and I'm very happy to be coding for these 3 months and have the guidance of my mentors Patrick Hogan and Gabriele Prestifilippo.
[[Category:Google Summer of Code]]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-07-16T07:40:34Z

Wiki-Simonebt92: /* Weekly Reports */

== Introduction ==

My project will focus on creating a plugin to allow clusterization of markers in the
ESA-NASA Web World Wind framework. These following capabilities are the
features I would like to implement:
1. Clustering based on different algorithms
2. Set a custom icon based on user parameters: i.e., number of clusters or custom
variables
3. Cluster based on geometries and not just polygons
4. Filter clusters based on user criteria
5. Precache the cluster at the zoom levels for optimized performance

== Schedule ==

{| class="wikitable"
|-
! TODO !! Timeline !! Status
|-
| Coding begins || May 30 || Done!
|-
| Research about the clustering functionalities and about the marker classes in WWW || May 30 - June 10 ||Done!
|-
| Implementation of a clustering algorithm in WWW || June 11 - June 20 || Done!
|-
| Phase 1 Evaluation || June 26 || Done!
|-
| Creating a first version of the clustering plugin || June 26 - June 30 || Done!
|-
| Implementing clustering options to cluster markers based on attributes || July 1 - July 10 || Done!
|-
| <del> Vacation</del> Comment code and documentation || July 11 - July 18 || Done!
|-
| Phase 2 Evaluation || July 24 || Awaiting..
|-
| Customize the design of clusters with colors and effects || July 24 - July 31 || Awaiting..
|-
| Filter clusters on predefined attributes || August 1 - August 10 || Awaiting..
|-
| Creating Unit Tests for the code || August 11 - August 16 || Awaiting..
|-
| <del> Comment code and documentation</del> Vacation|| August 17 - August 21 || Awaiting..
|-
| Finalizing documentation and reviewing the code || August 21 - 28 || Awaiting..
|-
| Submit final work product and mentor evaluation || August 29 || Awaiting..
|}

We will try to follow the schedule and report the status of the project each week.

== Weekly Reports ==

=== Week 1 ===
* What did you get done this week?
This week I set-up the development environment and made some research about the clustering algorithms and libraries available.
I found out some good library for clustering point and it can be integrated with WebWorldWind.
* What do you plan on doing next week?
Next week I will set up the unit test environment.
* Are you blocked on anything?
I already tried this week but had some problems. However, talking with my mentors I got some advice on how to proceed.

=== Week 2 ===
* What did you get done this week?
I prepared the testing environment and unit tests are working. I prepared a sample test but also improved the structure of the project and created some functionalities.
* What do you plan on doing next week?
Next week I will improve the current functionalities and create new more to allow a better insertion of markers into the plugin.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 3 ===
* What did you get done this week?
I developed some methods to improve the clustering functionalities. It accepts now a single marker, as well a list of markers. Also, some functionalities to show and hide single and groups of markers.
I'm able to create a cluster for a specified zoom level and show it in the globe.
* What do you plan on doing next week?
Next week I would like to show and hide the clusters automatically based on the zoom level and generate at the start all the groups.
* Are you blocked on anything?
I'm not blocked on anything right now

=== Week 4 ===
* What did you get done this week?
I managed to show and hide clusters based on the zoom level and hide the others. However, I encountered a small performance issue when there all too many markers in the globe.
* What do you plan on doing next week?
Next week I'm planning to hide all the markers that are not visible in the current view. I started researching and studying some code examples to achieve this.
* Are you blocked on anything?
I'm not really blocked, but I need the help of the mentors to proceed because I'm not really sure right now.

=== Week 5 ===
* What did you get done this week?
This week, as planned, I managed to hide all the markers outside the current view. I spent almost all week researching about the approaches to do that, and to improve performances I ended up using a camera model for a 2D view. Which works very well on small areas, like in our case. While, on a bigger area, I will implement maybe the 3D camera model, as suggested by my mentors.
I also created a smooth navigation to match zoom levels with cluster levels. I also implemented a GitHub page where is possible to test a demo with 200k markers.
Demo: [https://simonebt92.github.io/NASA-WWW-MarkerCluster/ https://simonebt92.github.io/NASA-WWW-MarkerCluster/]
* What do you plan on doing next week?
I will try to understand how to correlate zoom levels from WorldWind (camera range) with zoom levels from the cluster and its radius, and an optimal number of markers to show on each level.
* Are you blocked on anything?
I'm not totally blocked but I'm struggling on finding a good way to show the right amount of clusters and select a good radius when clustering.

=== Week 6 ===
* What did you get done this week?
This week I finally found how to correlate the zoom levels of World Wind with the cluster levels.
I allow now users to set a maximum level on which they can cluster.
I created some images, with a color variation depending on the number of markers a cluster contains.
I show markers on the visible area while zooming or pressing the +/- buttons.
I allow to manage at the same time different clusters (each with his setting).
I created an example with all the US cities.
I implemented single markers without clusters.
* What do you plan on doing next week?
Next week I was expected to be on vacation, but since I won't be able to go, I agreed with my mentor that I will skip few days in August and next week I will work on two things:
Handling the pan on the globe to show the markers on the visible area (now works only with zoom).
Starting commenting the code because it's getting confusing. And create a documentation.
* Are you blocked on anything?
I'm not blocked on anything

=== Week 7 ===
* What did you get done this week?
This week I implemented the possibility to pan in the globe and display the markers in the panning area.
I created an option to limit the visible markers to improve performances.
I commented all the functions briefly and created many unit tests (more yet to come).
* What do you plan on doing next week?
Next week I will create more unit tests, and I will work more on the customization of the clustering functionalities.
* Are you blocked on anything?
I'm not blocked on anything

== Brief description of the idea ==
My project consists in the development of a Plugin for the ESA/NASA WebWorldWind framework, to allow clustering of multiple markers. 

A link to all my commits is available here: [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub].

== State of the art before this project ==

Currently there is no plugin for clustering large amounts of markers, even though an
app may implement a similar functionality, but not with a modular plugin that can be
generically reused for any number of user-specific criteria.

== Additions that this project will bring to the software ==

As a result of the plugin I will develop, it will be possible for anyone to easily import
the plugin into the framework and use it as a modular component. In this way it will
be possible to cluster markers easily, using any number of options.
As an example, it can be useful to use this plugin when visualizing a marker for each
city in Italy, because, having thousand of markers in a small area could be very
difficult to render on the globe, but also to understand. Thanks to the plugin, users
will see only a few clusters while viewing the markers from a far distance and
zooming in they will see more and more details.

== Public Repository & Testing==

The application is available in GitHub at [https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub] .
More instruction on how to use the plugin will be available soon
# Instructions

== Student's Biography ==

My name is Simone Battaglia, I'm a Ph.D student in Neuroscience at Alma Mater Studiorum Bologna. I'm passionate about programming, and I like to integrate the IT world inside the neuroscience field.
I started learning programming thanks to my scientific researches and the needs of creating experiments in my study field. I got to know about WebWorldWind thanks to Patrick Hogan back in 2016 and I started using it since then.
This is my first time in the GSoC and I'm very happy to be coding for these 3 months and have the guidance of my mentors Patrick Hogan and Gabriele Prestifilippo.
[[Category:Google Summer of Code]]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-07-16T07:36:46Z

Wiki-Simonebt92: /* Schedule */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-07-09T10:07:22Z

Wiki-Simonebt92: /* Schedule */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-07-09T10:02:26Z

Wiki-Simonebt92: /* Weekly Reports */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-07-02T15:24:05Z

Wiki-Simonebt92: /* Week 5 */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-07-02T15:22:21Z

Wiki-Simonebt92: /* Weekly Reports */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-07-02T15:10:00Z

Wiki-Simonebt92: /* Schedule */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-06-25T14:01:23Z

Wiki-Simonebt92: /* Weekly Reports */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-06-18T14:23:53Z

Wiki-Simonebt92: /* Weekly Reports */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-06-18T14:19:54Z

Wiki-Simonebt92: /* Schedule */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-06-11T13:09:50Z

Wiki-Simonebt92: /* Weekly Reports */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-06-11T13:07:29Z

Wiki-Simonebt92: /* Schedule */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-06-05T07:44:53Z

Wiki-Simonebt92: /* Week 1 */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-06-03T17:40:19Z

Wiki-Simonebt92: /* Public Repository & Testing */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-06-03T17:33:51Z

Wiki-Simonebt92: /* Week 1 */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-06-03T17:30:59Z

Wiki-Simonebt92: /* Schedule */

Google Summer of Code 2017 Accepted

2017-05-15T15:17:13Z

Wiki-Simonebt92: /* Accepted Proposals */

<center>
[[Image:GSoC2016Logo.jpg|400px|link=https://developers.google.com/open-source/gsoc/]] @ 
[[Image:OSGeo_300_127_pixel.png|300px|link=http://www.osgeo.org]]
</center>

* Back to the main OSGeo [[Google Summer of Code 2017]] @ OSGeo wiki page.

== Accepted Proposals ==

This year OSGeo accepted 15 students working on the following projects:

{|class="wikitable sortable" border="2" cellspacing="0" cellpadding="4" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse; background-color:#D7E3D1; font-size:95%; empty-cells:show;"
|'''Community'''
|'''Project'''
|'''Student'''
|'''1st mentor'''
|'''2nd mentor'''
|'''3rd mentor'''
|'''Wiki page'''
|'''Repository'''
|-
|GRASS GIS
|GRASS GIS Locations Created From Public Data
|Zechariah Krautwurst
|[https://wiki.osgeo.org/wiki/Anna_Petrasova Anna Petrasova]
|[https://wiki.osgeo.org/wiki/OSGeo_Advocate#Vaclav_Petras Vaclav Petras]
|
|
|
|-
|-
|GRASS GIS
|Integration of PDAL into GRASS GIS
|Paul Schrum
|[https://wiki.osgeo.org/wiki/Anna_Petrasova Anna Petrasova]
|[https://wiki.osgeo.org/wiki/OSGeo_Advocate#Vaclav_Petras Vaclav Petras]
|
|
|
|-
|-
|GRASS GIS
|SOS tools in GRASS GIS
|Ondřej Pešek
|[https://wiki.osgeo.org/wiki/User:Lucadelu Luca Delucchi]
|Matteo De Stefano
|
|[https://trac.osgeo.org/grass/wiki/GSoC/2017/SOSInGRASS Trac]
|
|-
|-
|gvSIG
|Educational games add-on for gvSIG Batoví/Educa
|Carlos I. Colombana
|Nadia Chaer
|Francisco Puga
|
|
|
|-
|-
|istSOS
|istSOS-Data analysis and statistical tools suite
|Rahul Chauhan
|[https://wiki.osgeo.org/wiki/Massimiliano_Cannata Massimiliano Cannata]
|[https://wiki.osgeo.org/wiki/Milan_Antonovic Milan Antonovic]
|
|
|
|-
|-
|istSOS
|Improving IstSOS Web API and finalizing IstSOS Javascript Core Library
|Luka Glušica
|[https://wiki.osgeo.org/wiki/Milan_Antonovic Milan Antonovic]
|[https://wiki.osgeo.org/wiki/User:Lucadelu Luca Delucchi]
|
|[https://wiki.osgeo.org/wiki/IstSOS_Web_API IstSOS Web API]
|[https://github.com/istSOS/javascript-core Javascript Core] 
[https://github.com/istSOS/web-widget-creator Web Widget Creator]
|-
|-
|MapMint
|Integrating istSOS as a data store in MapMint
|Niroshan Bandara
|[https://wiki.osgeo.org/wiki/User:Djay Gérald Fenoy]
|[https://wiki.osgeo.org/wiki/Massimiliano_Cannata Massimiliano Cannata]
|[https://wiki.osgeo.org/wiki/User:Sittichai_choosumrong Sittichai Choosumrong]
|[https://wiki.osgeo.org/wiki/Integrating_istSOS_as_a_data_store_in_MapMint Wiki]
|
|-
|-
|MapMint4ME
|Adding Audio/Video and SOS input support in MapMint4ME
|Rajat Shinde
|[https://wiki.osgeo.org/wiki/User:Djay Gérald Fenoy]
|[https://wiki.osgeo.org/wiki/Milan_Antonovic Milan Antonovic]
|[https://wiki.osgeo.org/wiki/User:Sittichai_choosumrong Sittichai Choosumrong]
|[https://wiki.osgeo.org/wiki/GSoC_17:_Add_Audio,_Video_and_SOS_input_support_in_MapMint4ME Wiki]
|
|-
|-
|NASA Web World Wind
|3D OSM Plugin API
|Candan Eylül Kilsedar
|Patrick Hogan
|Jakub Balhar
|
|[https://wiki.osgeo.org/wiki/GSoC_2017_-_3D_OSM_Plugin_API_for_ESA-NASA_Web_World_Wind Wiki]
|[https://github.com/kilsedar/3dosm GitHub]
|-
|-
|NASA Web World Wind
|MarkerCluster Plugin
|Simone Battaglia
|Patrick Hogan
|Gabriele Prestifilippo
|
|[https://wiki.osgeo.org/wiki/GSoC_2017_-_NASA/ESA_WebWorldWind_Marker_Cluster Wiki]
|[https://github.com/simonebt92/NASA-WWW-MarkerCluster GitHub]
|-
|-
|OneBusAway
|Integration of Bikeshare Information into an Open-source Transportation App
|Rodrigo Carvalho
|Stefan Steiniger
|Sean Óg Crudden
|Sean Barbeau
|
|
|-
|-
|pgRouting
|Rewrite for Turn Restricted Shortest Path Algorithm in pgRouting
|Vidhan Jain
|[https://wiki.osgeo.org/wiki/Daniel_Kastl Daniel Kastl]
|Rohith Reddy
|
|[https://github.com/pgRouting/pgrouting/wiki/GSoC-2017-Rewrite-TRSP Wiki]
|[https://github.com/pgRouting/pgrouting/projects/1 Github Project]
|-
|-
|pgRouting
|Implement Connected Components Algorithms for pgRouting by the Boost Graph Library
|Maoguang Wang
|[https://wiki.osgeo.org/wiki/User:Cvvergara Vicky Vergara]
|[https://wiki.osgeo.org/wiki/Daniel_Kastl Daniel Kastl]
|
|[https://github.com/pgRouting/pgrouting/wiki/GSoC-2017-Connected-Components Wiki]
|[https://github.com/pgRouting/pgrouting/tree/gsoc/connectComponent Github Branch]
|-
|-
|pgRouting
|Extension of pgRouting Contraction framework to implement Contraction By Area
|Ankur Shukla
|Rohith Reddy
|[https://wiki.osgeo.org/wiki/User:Cvvergara Vicky Vergara]
|
|[https://github.com/pgRouting/pgrouting/wiki/GSoC-2017-Area-Contraction Wiki]
|
|-
|-
|QGIS
|QGIS Web API and remote control Plugin (for Notebook integration)
|Kevin Stadler
|Barry Rowlingson
|Julia Wagemann
|
|
|
|-
|}

See the [https://summerofcode.withgoogle.com/organizations/4660070039158784/ accepted projects on Google's platform].

[[Category: Google Summer of Code]]

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-05-14T16:55:43Z

Wiki-Simonebt92: /* Student's Biography */

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-05-14T15:29:02Z

Wiki-Simonebt92:

GSoC 2017 - NASA/ESA WebWorldWind Marker Cluster

2017-05-14T15:23:35Z

Wiki-Simonebt92: Created page with " == Introduction == My project will focus on creating a plugin to allow clusterization of markers in the ESA-NASA Web World Wind framework. These following capabilities are..."