{"id":30895543,"url":"https://github.com/ladybug-tools/spider-rad-viewer","last_synced_at":"2025-09-08T22:07:26.456Z","repository":{"id":150368188,"uuid":"146489148","full_name":"ladybug-tools/spider-rad-viewer","owner":"ladybug-tools","description":"View RAD files produced by Radiance scripts in interactive 3D in your browser","archived":false,"fork":false,"pushed_at":"2021-09-21T16:05:35.000Z","size":2090,"stargazers_count":7,"open_issues_count":3,"forks_count":0,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-01-25T11:41:03.961Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.ladybug.tools/spider-rad-viewer/cookbook/rad-viewer-iframe-carousel/r1/rad-viewer-iframe-carousel.html","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ladybug-tools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-08-28T18:24:02.000Z","updated_at":"2023-11-22T19:50:45.000Z","dependencies_parsed_at":"2023-07-27T16:16:11.158Z","dependency_job_id":null,"html_url":"https://github.com/ladybug-tools/spider-rad-viewer","commit_stats":{"total_commits":132,"total_committers":1,"mean_commits":132.0,"dds":0.0,"last_synced_commit":"a5ab66cdf0f9b9f4af8433eabf9d66a8cbe5f851"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/ladybug-tools/spider-rad-viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fspider-rad-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fspider-rad-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fspider-rad-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fspider-rad-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ladybug-tools","download_url":"https://codeload.github.com/ladybug-tools/spider-rad-viewer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fspider-rad-viewer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274231549,"owners_count":25245659,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-08T02:00:09.813Z","response_time":121,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-08T22:07:22.983Z","updated_at":"2025-09-08T22:07:26.439Z","avatar_url":"https://github.com/ladybug-tools.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n\u003cspan style=display:none; \u003e[You are now in a GitHub source code view - click this link to view Read Me file as a web page]( https://www.ladybug.tools/spider-rad-viewer/#README.md \"View file as a web page.\" ) \u003c/span\u003e\n\n\u003cdiv\u003e\u003cinput type=button class = 'btn btn-secondary btn-sm' onclick=window.location.href='https://github.com/ladybug-tools/spider-rad-viewer' value='You are now in a GitHub web page view - Click this button to view this read me file as source code' \u003e\u003c/div\u003e\n\n\u003cbr\u003e\n\n# [Ladybug Tools / Spider RAD Viewer Read Me]( #README.md )\n\n\n\u003ciframe src=https://www.ladybug.tools/spider-rad-viewer/cookbook/rad-viewer-iframe-carousel/r1/rad-viewer-iframe-carousel.html width=100% height=520px \u003eIframes are not viewable in GitHub source code view\u003c/iframe\u003e\n_\u003csmall\u003eRAD Viewer Iframe Carousel: still at an early stage of development\u003c/small\u003e_\n\n## Welcome \u003ca href=\"https://www.rtcevents.com/bilt/eur18/\" title=\"Ahoj Michal! Ahoj Ljubljana! Pivo, prosím.\" style=color:red; target=\"_blank\"\u003eBILT EUR 2018\u003c/a\u003e attendees!\n\n\u003c!--\nWelcome visitors from the [17th International Radiance Workshop]( http://climate-based-daylighting.com/doku.php?id=radiance2018:programme#workshop_programme )\n--\u003e\n\n***\n\n### Full Screen: [Spider RAD Viewer]( https://www.ladybug.tools/spider-rad-viewer/rad-viewer/ )\n### Learn more: [Read Me]( https://www.ladybug.tools/spider-rad-viewer/index.html#rad-viewer/README.md )\n### Edit the source code: [Download scripts]( https://github.com/ladybug-tools/spider-rad-viewer/releases )\n\n* A [Radiance]( https://www.radiance-online.org/ ) RAD file viewer with a limited feature set\n\t* Open files via an API, a file dialog box, via drag and drop or from a selection of sample files\n\t* View selected individual surface data in a pop-up\n\t* Adjust a variety of display settings\n* Open, display and manipulate RAD files in real-time 3D in your browser\n* Built with plain-vanilla JavaScript using the [Three.js]( https://threejs.org ) library\n* All free and open source software hosted on [GitHub]( https://github.com ) with an MIT license\n\n\n### [Spider RAD Viewer Cookbook Gallery]( https://www.ladybug.tools/spider-rad-viewer/#cookbook/cookbook-viewer-one-pager.html )\n#### Learn more: [Cookbook Read Me]( https://www.ladybug.tools/spider-rad-viewer/#cookbook/README.md )\n\nThe Spider RAD Viewer is designed to be a tool that you can edit and update according to your needs. In order to help you, the cookbook Spider RAD Cookbook supplies a number of simple code samples. The cookbook is a collection of scripts that:\n* Enhance the basic file RAD file viewer to carry out specific tasks.\n* Isolate features in the main viewer so you can see how the work in a more simple way\n* Add special features not in the main viewer\n* Experiment with new ideas\n\nScripts of interest include:\n* Point cursor at a surface and view its geometry and materials in a pop-up: [Spider Rad Viewer with Pop-Up Info]( https://www.ladybug.tools/spider-rad-viewer/cookbook/rad-viewer-pop-up-info )\n* Display a slide-show carousel of RAD files: [RAD Viewer Iframe Carousel]( https://www.ladybug.tools/spider-rad-viewer/cookbook/rad-viewer-iframe-carousel/ )\n* View all the RAD files in a GitHub repository: [RAD Sample File Gallery]( https://www.ladybug.tools/spider-rad-viewer/cookbook/rad-sample-file-gallery/ )\n* A very basic script with a minimal feature set: [RAD Viewer Basic]( https://www.ladybug.tools/spider-rad-viewer/cookbook/rad-viewer-basic/ )\n\t* Use this script to start building your own modules\n* More scripts are available in the Cookbook. See the read me file\n\nBTW: The cookbook read me script obtains list of sub-folders from a given folder on GitHub using the GitHub API. Creates an iframe for each sub-folder. Sets index.html of each sub-folder as the source for each iframe.\n\n\n### Forum / https://discourse.ladybug.tools/c/spider\n\n* General discussion on Spider projects\n* Updates on latest features added\n* Obtain help and support\n\n\u003cbr\u003e\n\n### Issues / GitHub issues: [Spider RAD Viewer Issues]( https://github.com/ladybug-tools/spider-rad-viewer/issues )\n\n* Report bugs\n* Discuss wish list items\n\n\u003cbr\u003e\n\n### To do / wish list / GitHub Project: [Spider RAD Viewer Projects]( https://github.com/ladybug-tools/spider-rad-viewer/projects )\n\n* What's in the pipeline\n\n\n***\n\n## Concept / Issues to be addressed\n\nRadiance Software may be used to produce stunning images with engaging effects. Interestingly the [The RADIANCE 5.1 Synthetic Imaging System.pdf]( http://radsite.lbl.gov/radiance/refer/refman.pdf ) contains a single diagram and no images in its twenty pages. The [Radiance ManPages.pdf]( https://www.radiance-online.org/learning/documentation/manual-pages/pdfs/manpages.pdf ) contains zero images within its **227** pages.\n\nWhat can we do can to help illustrate the beauties of Radiance software?\n\nHere is a small start: Scripts to view RAD files produced by Radiance scripts in interactive 3D in your browser\n\nAnd provide new-user support for [Radiance Online]( https://www.radiance-online.org/ )\n\n***\n\n### Mission\n\nTranslate Radiance RAD file types into Three.js views - all building on [Mostapha's efforts]( https://github.com/mostaphaRoudsari/radJSON)\n\n* Select and display RAD files very quickly\n* Access RAD files from anywhere: computer/tablet/phone\n* Reduce labor needs and increase engineering insights\n* Easy code you learn from and can easily adapt to your specific needs\n\n### Vision\n\n* Help make it faster, easier, simpler to do cataloguing and file management on large numbers of Radiance RAD files\n\n\n## Features\n\nOne liner\n* Select, open, view and manipulate [Radiance]( https://www.radiance-online.org/ ) RAD Files with interactive 3D on any device\n\nSelecting files\n* Open file or files locally or remotely via\n\t* Operating system dialog box - single or multiple files\n\t* URL - remote or local - supplied by a [location.hash]( https://developer.mozilla.org/en-US/docs/Web/API/Window/location ) update - single files only for now\n\t* Drag and drop (work-in progress)\n* Select files from lists of links to available online [sample RAD files](\nfile:///D:/Dropbox/Public/git-repos/spider/index.html#radiance-sample-files/README.md )\n\nViewing files as models\n* Display RAD files in interactive 3D with rotate, zoom and pan\n* Update scene settings: rotation, wireframe mode, edges visibility, surfaces opacity\n* UX intended to work on computer, tablet or mobile device (work-in-progress)\n\nViewing files as data\n* View RAD file data in the menu\n\t* Native text format\n\t* Translated to JSON\n* Highlight individual elements visually and view their numeric parameters in a pop-up\n\t* Shows use of Three.js Raycaster and Object3D.traverse\n\n\nParsing file data\n* Uses converter from [github.com/mostaphaRoudsari/radJSON]( https://github.com/mostaphaRoudsari/radJSON )\n\t* Outlines a possible JSON schema\n* Basic look-up table supplies a basic polygon color palette if no material specified\n* Handles openings in surfaces moderately well\n* Files under a megabyte in size handled in a speedy fashion / Larger files are a work-in-progress\n\n\nWritten in plan-vanilla JavaScript\n* All free and open source on [GitHub]( https://github.com ) with an MIT license\n* [Plain-vanilla JavaScript]( http://vanilla-js.com/ ) with [Three.js]( https://threejs.org ) as the only dependency\n* Written in a very beginner-friendly style\n* Run offline and locally / No server or localhost required\n* Follows the code style guidelines of the [Three.js Examples]( https://threejs.org/examples/ )\n\n\nCookbook sample files add scripts with these extra features\n* Select files to view from lists of links to available online sample RAD files\n* Mouseover a surface to display details of its geometry and material in a pop-up\n* View RAD files in an iframe embedded in an HTML file or a Markdown file\n* View RAD files in a slide-show carousel\n\n\nUse cases\n* View large numbers of RAD files quickly and easily on any device\n* Locate  for individual geometry elements visually and identify numeric parameters instantly\n\nPossible future uses\n\n* Part of a system for extracting data and creating RAD files from other file types such as: gbXML, IDF, OSM and glTF\n* Display large numbers of RAD files selected at user run-time in a single 3D space\n\t* To enable speedy visual compare and contrast\n* Speed up some 'housekeeping' operations for numbers of RAD files by enabling GPU access with lower skill-level requirements\n\n\n\n\n\n\n## Links of Interest\n\nSpider\n\n* [Spider RAD Resources Read Me]( http://www.ladybug.tools/spider/#radiance-sample-files/README.md )\n\t* As and when we start receiving more sample files these folders wil be forked into their own repository\n\n\nRadiance\n\n* [17th International Radiance Workshop]( http://climate-based-daylighting.com/doku.php?id=radiance2018:programme#workshop_programme )\n* [The RADIANCE 5.1 Synthetic Imaging System.pdf]( http://radsite.lbl.gov/radiance/refer/refman.pdf )\n* [Radiance ManPages.pdf]( https://www.radiance-online.org/learning/documentation/manual-pages/pdfs/manpages.pdf )\n\n\n## Notes\n\nThis repo replaces and deprecates the following scripts\n* [RAD to JSON]( https://www.ladybug.tools/spider/#cookbook/rad-to-json/README.md )\n* [Radiance RAD to Three.js]( https://rawgit.com/ladybug-tools/spider/master/#cookbook/rad-to-threejs/README.md )\n* [radJSON Fork]( https://rawgit.com/ladybug-tools/spider/master/#cookbook/rad-json-fork/README.md )\n* [Rad Viewer]( https://www.ladybug.tools/spider/#rad-viewer/README.md )\n\n\nTry to follow Mostapha's suggestions\n\n1. Keep the code clean.\n2. Test the code.\n3. Learn from the code and hack it for other uses.\n4. And finally use the repository as a dependency. Especially when it comes to JavaScript we can use GitHub submodules functionality between the repositories.\n\n\n***\n\n# \u003ccenter title=\"hello!\" \u003e\u003ca href=javascript:window.scrollTo(0,0); style=text-decoration:none; \u003e ❦ \u003c/a\u003e\u003c/center\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fladybug-tools%2Fspider-rad-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fladybug-tools%2Fspider-rad-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fladybug-tools%2Fspider-rad-viewer/lists"}