Spider Viewer 2021

Spider Viewer 2021

View full screen: https://www.ladybug.tools/spider-2021/spider-viewer/

The Spider Viewer 2021 is now an early stage work-in-progress.

  • Mix and match OSM, RAD, HBJSON and gbXML files in the same scene
  • Load multiple files via URL, file dialog or drag & drop
  • Drag and drop models in the scene to new locations
  • Decompress and load models from ZIP file automatically
  • Explore dozens of sample files
  • View renderer statistics and frames per seconds
  • Right-click surfaces to view their details in a pop-up

Instead of multiple viewers each supporting a single file format, it’s now one viewer that reads any number of formats. There’s more on the way:

  • Faster drawing algorithms. For example. try loading this 21MB model 62K triangles of geometry: urban_district.hbjson. It takes a while lo load, but once it’s up: click the reload button. Right-click on and notice the pop-up appears without delay. Over the next few weeks the new algorithms will be refactored into all file format loaders
  • More file formats to be added. Anybody want IFC or EPW or Design Explorer support?
  • Better user experience in moving, viewing and editing the data
  • Of course many - if not all - the features you have enjoyed from previous releases will be added.

As always with the Spider scripts,

  • you don’t have to change your ways! All the previous releases will continue to be available. Choose to work the way you want.
  • The code is so simple and easy to tweak it even runs is Discourse!

And - as is so often the case with open source apps:

  • No feedback from users means programmers get bored and work on other projects
  • Lots of feedback makes for lots of coding. :wink:

So let’s talk about making this the best Spider Viewer!


Woah, this is so awesome, great work @TheoA .

Is it possible to load simulation results and how would you recommend doing this? For example daylight grid calculations?


Thank you for the kind words.

Is it possible to load simulation results

The quick answer is: yes

The longer answer is there are many type of data so it depends.

Post a sample of the data and an image of how you want to visualize it. I will build an interactive demo around your sample and post it on GitHub.


Great, thank you.

Here is the GH file w/ internalized data:
DF_calc_spider_view.gh (76.6 KB)

Here is the view:

What i think would be very useful when using the viewer (shown in the example):

  • View grid based calculations as a mesh (daylight results)
  • View custom colored surfaces (green/red)
  • Text tag for visualizing custom results
  • View the buildings/objects as wireframe colored black

What do you think, is it possible? Is there any workarounds? Thanks for taking your time!


1 Like

Nice project @TheoA
Would you mind to give the git link?
I have an friend doing his master thesis related to this problem.
I think the Spider Viwer may help him.

Hi @TK, @TheoA doesn’t use Grasshopper! You should share the result file itself with him.

Here is the link: spider-2021/spider-viewer at main · ladybug-tools/spider-2021 · GitHub

You can click on the GitHub icon inside the viewer to go to the GitHub repository.

1 Like


Hi Tobias

Oh, lovely!

Is it possible for you to view the calculations in the original file? In other words are you able to export the calculations as a 3DM file?

Or - if you have the 3DM file of the calculations - using the Spider Viewer 2021:

Load the original modef (HBJSON, gbXML, RAD or whatever).

Uncheck the “Open new file” checkbox

Load the 3DM file and the calculations should appear inside the model.

There would still be a small number of solvable issues

  • Scale, position and rotation of the inserted data might have to be edited. Currently only the position can be updated
  • Exporting the combined data is still at an early stage. Monocolor OBJ and STL are not useful. More and better formats will happen in future releases.
  • All the other aspects you highlight have appeared in previous releases of the many viewers, so they just a matter of time and priority.

If you have a sample model and calculations file, can you share these? Then I could build a demo for testing and learning.


1 Like


Thanks for helping!

1 Like

Hi team,
U have done a great job.
Merci beaucoup

I am sorry Theo,

Here are the files:
Baked_model_DF.3dm (741.2 KB)
Results_DF.txt (5.2 KB)
Model_DF.hbjson (220.1 KB)

I did manage to load the 3dm file with the color coding on the windows:

Neat project. I will definitely try other models!

1 Like


Yay! great start.

And, especially, thank you for sharing the model, data and results files.

I will a have a look, but my guess is that, would to:

  • Adjust the opacity of walls and floors etc
  • Add edge lines to selected edges
  • Text in 3D at suitable locations
  • Adjust the position of the Sun
  • Display selected info when you right click selected surfaces

I will look at the first two - first. Also there are still several open open issues with HBJSON files to be fixed.

Please keep sending data like this! The more I get things to test, the faster the project will progress!

1 Like

Great, thank you @TheoA. This would be perfect!


Thank you again for sending these files. It’s encouraging to see that we can do this.

Here are two ideas on how we can get this even better:

  1. Can you export a file with just the colored panels? If so we could insert and add these into the original HBJSON (and save the combined output to file if needed ). Then we could use soon-be added Spider 2021 features to adjust the display to you see what is going on even better


  1. If you point to something that explains to me the numbers in results_DF.txt, the we could apply the colors to directly to the apertures in the original model - and save the results or make a video or whatever.

Great, yes, here is the file containing only the window surfaces:

  1. Spider_Df_colorsurfaces.3dm (112.4 KB)

  2. The txt file contains the numbers for the mesh which is visualized here:

If we are able to visualize this mesh, we don’t need the numbers from the txt file I guess :smiley:

1 Like


Looks good. I will create a demo with this file and the original model soon

If you can help me understand the text numbers then I can create a suitable legend. I see that there are 864 values in the text file which indicates that the 18 spaces have 48 values each - which looks like matches the 6 x 8 colored patches, but I have no idea what the numbers represent nor how they are linked to the colors. Can you help here?

Could the numbers be representing hours of sunlight?

You are correct. Good guess! But the numbers represent daylight factor (%) for each point (each patch). Usually i use a legend going from 0 to 10 as illustrated in the figure below:

1 Like


Got it. Thank you for speedy reply.

It will take me a bit of time to add opacity sliders for each of the surface types. Once they are in, we can view the inserted 3DM file easily. I will keep you informed of progress.

Cool! Looking forward :smiley: