# A July 2020 VTK Hackathon

**URL:** https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600
**Category:** Announcements
**Created:** [June 20, 2020, 4:44pm UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600 "2020-06-20T16:44:24Z")
**Posts on this page:** 20
**Page:** 1

<div class="post-metadata">

### Author: ![will.schroeder](https://discourse.vtk.org/user_avatar/discourse.vtk.org/will.schroeder/32/233_2.png) [@will.schroeder](https://discourse.vtk.org/u/will.schroeder)
#### Post date: [June 20, 2020, 4:44pm UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/1 "2020-06-20T16:44:24Z")

</div>

It’s time for another VTK hackathon. Given relatively recent events, and after talking to several folks (thanks Andrew, Seb, Rob, Ben, and others), I’d like to hold the hackathon in memory of Bill Lorensen (who died in December 2019), specifically focused on the VTK examples (behind which Bill was the driving force).

Currently July 8 looks promising. But before we pin the date and schedule down, if there are any serious objections, or suggestions, please let me know. Also, I’d like to accommodate Andrew who codes in Sydney, Down Under time - so the schedule will need to reflect this.

---

<div class="post-metadata">

### Author: ![mwestphal](https://discourse.vtk.org/user_avatar/discourse.vtk.org/mwestphal/32/19_2.png) [@mwestphal](https://discourse.vtk.org/u/mwestphal)
#### Post date: [June 22, 2020, 3:14am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/2 "2020-06-22T03:14:40Z")

</div>

Great idea @will.schroeder !

We would first need a to make sure that we know what we want to do, see the discussion here:

> [@About the VTK examples](https://discourse.vtk.org/t/about-the-vtk-examples/3292/4):
>
> I would also like to emphasize the usefulness of this project. I use it for: proposals: for instance, what is available in VTK for mesh and point processing? The VTK Examples uses a filter categorization not available anywhere else as far as I know. coding: in the past I used to use tests to see how to use various classes, now I often use the VTK Examples. I also think VTKExamples is a great advertising tool for VTK. Dan

---

<div class="post-metadata">

### Author: ![amaclean](https://discourse.vtk.org/user_avatar/discourse.vtk.org/amaclean/32/224_2.png) [@amaclean](https://discourse.vtk.org/u/amaclean)
#### Post date: [June 23, 2020, 7:13am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/3 "2020-06-23T07:13:54Z")

</div>

Great idea @will.schroeder.

I’m happy to fit in with whatever people decide, Fridays (your time) would be out as it it Saturday here. I have Yoga in the early morning!

It is worth having a look at [About the VTK examples](https://discourse.vtk.org/t/about-the-vtk-examples/3292)

As of just now, I have made good progress in creating working scripts to build the web site.

---

<div class="post-metadata">

### Author: ![will.schroeder](https://discourse.vtk.org/user_avatar/discourse.vtk.org/will.schroeder/32/233_2.png) [@will.schroeder](https://discourse.vtk.org/u/will.schroeder)
#### Post date: [June 23, 2020, 10:34am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/4 "2020-06-23T10:34:54Z")

</div>

Here are some consolidated suggestions for how to proceed.

1. Work on the back-log of issues on [https://github.com/lorensen/VTKExamples](https://github.com/lorensen/VTKExamples)
2. Extend [https://github.com/lorensen/VTKExamples](https://github.com/lorensen/VTKExamples) with more examples
3. Work on providing more ‘application’ focused examples; e.g., an example that shows how to convert/resample an unstructured grid to structured grid.
4. Investigate adding the examples repo as a contract test for VTK.

If possible, I’d like to find a way for Andrew to provide a short intro/summary to kick things off. With the current 14-hr time difference, this is going to be tricky 🙂 One thing we could do is have Andrew speak early in the morning Sydney time (on July 8 his time) so that we could listen in late afternoon _the afternoon before, on July 7 EDT_ - and BTW see if we can record it for our European friends. Then we’d follow the next morning 9:00am July 8 EDT with the hackathon proper.

---

<div class="post-metadata">

### Author: ![mwestphal](https://discourse.vtk.org/user_avatar/discourse.vtk.org/mwestphal/32/19_2.png) [@mwestphal](https://discourse.vtk.org/u/mwestphal)
#### Post date: [June 23, 2020, 10:36am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/5 "2020-06-23T10:36:14Z")

</div>

No repository migration planned ?

---

<div class="post-metadata">

### Author: ![will.schroeder](https://discourse.vtk.org/user_avatar/discourse.vtk.org/will.schroeder/32/233_2.png) [@will.schroeder](https://discourse.vtk.org/u/will.schroeder)
#### Post date: [June 23, 2020, 10:38am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/6 "2020-06-23T10:38:21Z")

</div>

I think this is a VTK community decision… hopefully others weigh in.

---

<div class="post-metadata">

### Author: ![mwestphal](https://discourse.vtk.org/user_avatar/discourse.vtk.org/mwestphal/32/19_2.png) [@mwestphal](https://discourse.vtk.org/u/mwestphal)
#### Post date: [June 23, 2020, 10:42am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/7 "2020-06-23T10:42:56Z")

</div>

Well, unless I’m mistaken, even though @amaclean can push and merge, he do no have access to bill’s account. The destination of the migration should indeed be discussed, but as of right now, the repository is unmanaged.

---

<div class="post-metadata">

### Author: ![amaclean](https://discourse.vtk.org/user_avatar/discourse.vtk.org/amaclean/32/224_2.png) [@amaclean](https://discourse.vtk.org/u/amaclean)
#### Post date: [June 29, 2020, 6:00am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/8 "2020-06-29T06:00:24Z")

</div>

I strongly endorse the suggestions from @will.schroeder.

Here is a “short” summary of the history of the site, work done and future directions. I have created a PDF: [VTKExamples.pdf](https://discourse.vtk.org/uploads/short-url/5FGPPJyvjvDCYZ9RJGWojGaj5kN.pdf) (55.6 KB) that can be used as a starting point to any discussion.

If you want to look at the mirrored repository, here is the link [VTKExamples mirror](https://github.com/ajpmaclean/VTKEx/). Web pages of this site are found at [VTKEx](https://ajpmaclean.github.io/VTKEx/site/)

---

<div class="post-metadata">

### Author: ![mwestphal](https://discourse.vtk.org/user_avatar/discourse.vtk.org/mwestphal/32/19_2.png) [@mwestphal](https://discourse.vtk.org/u/mwestphal)
#### Post date: [June 30, 2020, 3:42am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/11 "2020-06-30T03:42:48Z")

</div>

> 1. Have a Linux machine in Kitware that holds the master repository.

+1. The repo could be in [https://gitlab.kitware.com/vtk/VTKExamples](https://gitlab.kitware.com/vtk/VTKExamples) imo.

> 1. Track the VTK master closely in the same way as the old examples in the VTK master  
> did. This enhances the testing of VTK and also exposes users to new features.

Yes. Considering testing, a gitlab-ci could build and test against VTK master regularly as well as against the last release.

> 1. There is a bit of work […]I do have some issues with git-lfs.

Can you elaborate ?

> 1. Within Kitware remove all references to the original examples site. (We had someone trying to download examples from VTK/Examples/Instructions/ForUsers)

Yes please !

> 1. If we generate a new site it would essential to have re-direct from the current VTK examples site along with a paragraph or two celebrating Bill’s achievements.

Can we do that without the “full” access to the site ?

> I am prepared to spend a lot of time achieving these goals with the help of the community and Kitware.

Thanks you very much @amaclean ! I’m willing to help !

---

<div class="post-metadata">

### Author: ![amaclean](https://discourse.vtk.org/user_avatar/discourse.vtk.org/amaclean/32/224_2.png) [@amaclean](https://discourse.vtk.org/u/amaclean)
#### Post date: [June 30, 2020, 4:39am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/12 "2020-06-30T04:39:32Z")

</div>

> [@mwestphal](#):
>
> +1. The repo could be in [https://gitlab.kitware.com/vtk/VTKExamples](https://gitlab.kitware.com/vtk/VTKExamples) imo.

I can’t agree more, it really should sit within Kitware and we must keep the name. We need to check if the static pages in the site folder will work, but they should. Bill did move to GitLab for some reason relating to building the web pages for the site. It may have been because he initially used gh-pages and the page layout flexibility wasn’t present in GitLab at that time. However I can’t see any issues when looking at the `mkdocs` documentation.

> [@mwestphal](#):
>
> > 1. There is a bit of work […]I do have some issues with git-lfs.
> 
> Can you elaborate ?

The main issue is that at present when committing to VTKEx, the [VTKExamples mirror](https://github.com/ajpmaclean/VTKEx/) I keep getting prompted for my Kitware, (not GitLab) username and password. I’m not doing something right wrt to Bill’s LFS repository which for some reason looks to be empty see [VTKExamplesLFS](https://gitlab.kitware.com/lorensen/VTKExamplesLFS). Anyway it is something to be looked at later as I have all the files.

> [@mwestphal](#):
>
> > 1. If we generate a new site it would essential to have re-direct from the current VTK examples site along with a paragraph or two celebrating Bill’s achievements.
> 
> Can we do that without the “full” access to the site ?

I think that there could be two approaches here:

1. Contact GitHub and see if they can put in a redirect.
2. I could try to modify the site folder contents to do this.

However we would need a fully functioning alternate site before doing this!

---

<div class="post-metadata">

### Author: ![amaclean](https://discourse.vtk.org/user_avatar/discourse.vtk.org/amaclean/32/224_2.png) [@amaclean](https://discourse.vtk.org/u/amaclean)
#### Post date: [June 30, 2020, 4:54am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/13 "2020-06-30T04:54:32Z")

</div>

In the [VTKExamples mirror](https://github.com/ajpmaclean/VTKEx/) I have just edited a lot of the documentation, fixing links etc. Also on the [VTKEx](https://ajpmaclean.github.io/VTKEx/site/) site you will see that the highlighting has been subtly changed … it helps me differentiate between this site and the old site.

Here is a map of the site as it stands now:

```bash
|-- 
  |-- CMakeLists.txt # To build all of the examples
  |-- _layouts # Contains _default.html
  |-- custom_theme # tweaks to the material theme
  |-- mkdocs.yml # config file for MkDocs
  |-- src # all of the content to create site/
    |-- SyncSiteWithRepo.sh # master script to update site/
    |-- Admin
    | |-- ScrapeRepo.py # script to create docs/
    | |-- VTKCMakeLists # template for Cxx examples
    | |-- VTKQtCMakeLists # template for Cxx Qt
    | |-- sitemap.xml # generated sitemap
    | |-- sitemapGenerator.sh # site map generator
    |-- Artifacts # Additional images, docs, etc.
    |-- Cache # Stores cache files used by ScrapeRepo.py.
    |-- Coverage # Stores VTK classes used and classes used by language.
    |-- Images # Images used in creating the static web pages.
    |-- Instructions # Documentation
    |-- LANGUAGE.md # Summary file for language
    |-- LANGUAGE # Language examples
    | |-- TOPIC
    |-- Tarballs # Tar files for each Cxx example
    |-- Testing
    | |-- Baseline # Baselines for examples
    | | |-- LANGUAGE
    | | | |-- TOPIC
    | |-- Data # Data for examples
    |-- VTKBook # Markdown version of the VTK Book
    |-- VTKBookLaTeX # LaTex version of the VTK Book
    |-- stylesheets
        |-- extra.css # mkdocs search config
  |-- site # static web pages generated by mkdocs

```

---

<div class="post-metadata">

### Author: ![mwestphal](https://discourse.vtk.org/user_avatar/discourse.vtk.org/mwestphal/32/19_2.png) [@mwestphal](https://discourse.vtk.org/u/mwestphal)
#### Post date: [June 30, 2020, 5:26am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/14 "2020-06-30T05:26:40Z")

</div>

> It may have been because he initially used gh-pages and the page layout flexibility wasn’t present in GitLab at that time.

Gitlab pages are not activated on [gitlab.kitware.com](http://gitlab.kitware.com) and will not be for the time.  
A simple solution is to have a github mirror that host the gh-pages.  
(That what we did for F3D : [https://kitware.github.io/F3D/](https://kitware.github.io/F3D/))

> I keep getting prompted for my Kitware, (not GitLab) username and password.

We had a similar issue with F3D, it can be fixed locally easilly.

---

<div class="post-metadata">

### Author: ![amaclean](https://discourse.vtk.org/user_avatar/discourse.vtk.org/amaclean/32/224_2.png) [@amaclean](https://discourse.vtk.org/u/amaclean)
#### Post date: [June 30, 2020, 5:45am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/15 "2020-06-30T05:45:31Z")

</div>

The `gh-pages` are not being used anymore in VTKExamples it was last used 3 years ago.

Who do I contact to fix the issue the prompting for username/password in relation to git-lfs?

---

<div class="post-metadata">

### Author: ![mwestphal](https://discourse.vtk.org/user_avatar/discourse.vtk.org/mwestphal/32/19_2.png) [@mwestphal](https://discourse.vtk.org/u/mwestphal)
#### Post date: [June 30, 2020, 5:47am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/16 "2020-06-30T05:47:36Z")

</div>

I mean, locally on your repository : [https://help.github.com/en/github/using-git/caching-your-github-credentials-in-git](https://help.github.com/en/github/using-git/caching-your-github-credentials-in-git)

---

<div class="post-metadata">

### Author: ![amaclean](https://discourse.vtk.org/user_avatar/discourse.vtk.org/amaclean/32/224_2.png) [@amaclean](https://discourse.vtk.org/u/amaclean)
#### Post date: [June 30, 2020, 5:49am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/17 "2020-06-30T05:49:41Z")

</div>

Thanks, I saw that and I now realise what I did! It works! Obviously I cloned using https.

---

<div class="post-metadata">

### Author: ![Edoardo\_Pasca](https://discourse.vtk.org/user_avatar/discourse.vtk.org/edoardo_pasca/32/742_2.png) [@Edoardo\_Pasca](https://discourse.vtk.org/u/Edoardo_Pasca)
#### Post date: [July 1, 2020, 12:29pm UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/18 "2020-07-01T12:29:17Z")

</div>

Hi all,

I’d love to contribute. I’m in UK and somewhat familiar with VTK through the Python bindings.

Thanks for this project

Edo

---

<div class="post-metadata">

### Author: ![will.schroeder](https://discourse.vtk.org/user_avatar/discourse.vtk.org/will.schroeder/32/233_2.png) [@will.schroeder](https://discourse.vtk.org/u/will.schroeder)
#### Post date: [July 6, 2020, 11:43am UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/19 "2020-07-06T11:43:54Z")

</div>

Schedule for the VTK Hackathon:

**We will kick off the meeting with an informal presentation by Andrew Maclean at 8am on July 8 (EDT)**. Yes this is early, but recall this is 10pm Andrew’s time (Sydney, Australia). It will also benefit our European friends. We’ll send a video link shortly.

In terms of how you can help out: from recent discussions, you can see that a few folks are discussing the logistics of hosting the Examples repository etc. - feel free to join the discussion. However, probably the best way for most of us to help out is to review the examples and look for “missing pieces” i.e., identify application focused examples that we should add to improve the user experience. And better yet, take a stab at writing such example code. We can also make sure the code is documented well, avoids using legacy or less preferred approaches, and exercises important features.

---

<div class="post-metadata">

### Author: ![will.schroeder](https://discourse.vtk.org/user_avatar/discourse.vtk.org/will.schroeder/32/233_2.png) [@will.schroeder](https://discourse.vtk.org/u/will.schroeder)
#### Post date: [July 7, 2020, 4:32pm UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/20 "2020-07-07T16:32:23Z")

</div>

Google Meet video link for the VTK hackathon:

> **[Meet](https://meet.google.com/unsupported?meetingCode=vwk-pjhz-vci&ref=https:%2F%2Fmeet.google.com%2Fvwk-pjhz-vci)**
>
> Real-time meetings by Google. Using your browser, share your video, desktop, and presentations with teammates and customers.

Optionally, join by phone:  
(US) +1 417-719-9470‬ PIN: ‪242 704 486‬#

---

<div class="post-metadata">

### Author: ![dgobbi](https://discourse.vtk.org/user_avatar/discourse.vtk.org/dgobbi/32/18_2.png) [@dgobbi](https://discourse.vtk.org/u/dgobbi)
#### Post date: [July 7, 2020, 7:33pm UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/21 "2020-07-07T19:33:36Z")

</div>

Thanks for arranging this. I’ll be there tomorrow.

---

<div class="post-metadata">

### Author: ![will.schroeder](https://discourse.vtk.org/user_avatar/discourse.vtk.org/will.schroeder/32/233_2.png) [@will.schroeder](https://discourse.vtk.org/u/will.schroeder)
#### Post date: [July 7, 2020, 7:38pm UTC](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600/22 "2020-07-07T19:38:10Z")

</div>

Most excellent it will be good to see you

[Next page](https://discourse.vtk.org/t/a-july-2020-vtk-hackathon/3600.md?page=2)
