• This repository has been archived on 21/Dec/2021
  • Stars
    star
    156
  • Rank 239,589 (Top 5 %)
  • Language
    C
  • License
    Other
  • Created almost 12 years ago
  • Updated almost 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

This repo has been archived. Please refer to https://github.com/LBNL-ETA/Radiance/tree/master for the latest updates.
		RCSid "$Id: README.txt,v 1.7 2020/09/03 15:46:32 greg Exp $"

Hello and welcome to the Radiance synthetic imaging system.  This is
the twenty-fifth release, Version 5.4, and it includes all source files
for local compilation with a standard C compiler.  To find out what's
new in this release, check the text file "doc/notes/ReleaseNotes".

Radiance is OpenSource software copyrighted and distributed by
Lawrence Berkeley National Laboratory in California.  By downloading
and installing this software, you are implicitly agreeing to the
OpenSource license appended to this README file.  Please read it
carefully before proceeding -- this is very different from previous
licenses, and contains fewer restrictions on commercialization.

Please read this entire file before sending e-mail asking
how to install this software or what to do with it.  Some
frequently asked questions are answered here and also on our
website at:

	http://radsite.lbl.gov/radiance/

The CVS source tree is available, including post-release bug-fixes and
mailing lists access at:

	http://www.radiance-online.org/

The websites above should also have some precompiled Radiance binaries
and add-ons for common Unix platforms.

We have attempted to make it easy for you (and for us) to install
the software on differently configured systems using a global make
script.  To install the software, just type:

	./makeall install

You can clean up the .o files and so forth with:

	./makeall clean

Or, if you are confident you can do both at the same time with:

	./makeall install clean

You can give other make options at the end of the command as well.  For
example, the -n option will tell you what makeall is going to do without
actually doing it.

If you downloaded the binaries, so compilation is not necessary,
run the following command to install the library files only:

	./makeall library

The makeall may script ask you questions about your system and where you
want to install the executables and library files.  The pathnames you
give should be relative to root for the programs to work properly.  You
may also use the tilde ('~') character to give paths starting with
someone's home directory.

If you do NOT have X11 support, please read the note "noX11.help" in
this directory.  It explains what to change to make things work.

Although it is set automatically by makeall, individuals may want to
set the RAYPATH environment variable manually.  This variable tells
Radiance where to look for auxiliary files, and usually includes the
current directory as well as the system library (ray/lib in this
distribution).  As you develop auxiliary files yourself, it is often
useful to add in your own library directory before the system directory.
An example setting such as this would go in a user's .login file:

	setenv RAYPATH .:${HOME}/mylib:/usr/local/lib/ray

After installing the software, you may want to start by scanning the
troff input documentation contained in "doc/ray.1", which is also formatted
for web browsers in "doc/ray.html".
A PDF version of this manual may be found in
"doc/pdf/ray.pdf", along with an older tutorial by Cindy Larson,
"doc/pdf/raduser1_6.pdf".

For complete documentation on the system as of release 3.1, refer to
"Rendering with Radiance" by Larson and Shakespeare, which used to be
available from Morgan Kauffman Publishing.  Recently, the authors have
taken over printing of the book, which is now available from booksurge.com.
You may find it linked to the Radiance website page:

	http://radsite.lbl.gov/radiance/book/

The first chapter of this book, which includes a basic tutorial and
serves as a good introduction for new users, may be found in
"doc/pdf/RwR01.pdf".

Important additions since version 3.1 include the holodeck programs (rholo,
etc., built in src/hd), glrad, ranimove, the new "mesh" primitive,
and rtcontrib.  Again, check doc/notes/ReleaseNotes for details.

Individual manual pages may be found in the subdirectory "doc/man".
You may want to copy these to the system manual directory, or add this
directory to your MANPATH environment variable in your shell
initialization file.  A good starting place is to print the text file
ray/doc/man/whatis, which gives a one line description of each program in
the Radiance package.  To print out the manual pages, use the "-man"
macro package.

The most important program to learn about if you are a new user of Radiance
(or have not used this program before) is "rad".  It controls Radiance
lighting parameters, and automates much of the rendering process.
To get started, change directory to obj/misc and try running:

	% rad -o x11 daf.rif

This works if you are running X11.  If you are not, you can still generate
an image with:

	% rad daf.rif &

When the picture is done, you can convert it to another format for display
with any of the ra_* programs listed in the doc/whatis database.

There is a user interface built on top of this using Tcl/Tk, called trad.
If you do not have Tcl/Tk installed on your system, you must do so prior
to building this distribution if you want trad to install.  (Try a google
search on "Tcl/Tk" or go to "http://www.scriptics.com/software/tcltk/".)

More Repositories

1

api-umbrella

Open source API management platform
Ruby
1,944
star
2

EnergyPlus

EnergyPlusâ„¢ is a whole building energy simulation program that engineers, architects, and researchers use to model both energy consumption and water use in buildings.
C++
1,117
star
3

OpenStudio

OpenStudio is a cross-platform collection of software tools to support whole building energy modeling using EnergyPlus and advanced daylight analysis using Radiance.
C++
502
star
4

SAM

System Advisor Model (SAM)
C++
338
star
5

floris

A controls-oriented engineering wake model.
Python
208
star
6

OpenOA

This library provides a framework for assessing wind plant performance using operational assessment (OA) methodologies that consume time series data from wind plants. The goal of the project is to provide an open source implementation of common data structures, analysis methods, and utility functions relevant to wind plant OA.
Jupyter Notebook
185
star
7

rdtools

PV Analysis Tools in Python
Python
153
star
8

vagrant-boxes

Shell
146
star
9

SOWFA

Roff
133
star
10

ReEDS-2.0

Python
125
star
11

pysam

Python Wrapper for the System Advisor Model
C
108
star
12

HPC

A collection of various resources, examples, and executables for the general NREL HPC user community's benefit. Use the following website for accessing documentation.
Jupyter Notebook
107
star
13

resstock

Highly granular modeling of residential building stocks at national, regional, and local scales using OpenStudio/EnergyPlus.
Ruby
105
star
14

ROSCO

A Reference Open Source Controller for Wind Turbines
Python
105
star
15

PowerGridworld

PowerGridworld provides users with a lightweight, modular, and customizable framework for creating power-systems-focused, multi-agent Gym environments that readily integrate with existing training frameworks for reinforcement learning (RL). https://arxiv.org/abs/2111.05969
Python
102
star
16

reV

Renewable Energy Potential (reV) Model
Python
101
star
17

hsds-examples

Examples of using the HSDS Service to Access NREL WIND Toolkit data
Jupyter Notebook
100
star
18

REopt_API

The model for the REopt API, which is used as the back-end for the REopt Webtool (reopt.nrel.gov/tool), and can be accessed directly via the NREL Developer Network (https://developer.nrel.gov/docs/energy-optimization/reopt)
Python
89
star
19

bifacial_radiance

Toolkit for working with RADIANCE for the ray-trace modeling of Bifacial Photovoltaics
Python
89
star
20

openstudio-standards

Ruby
81
star
21

sup3r

The Super-Resolution for Renewable Resource Data (sup3r) software uses generative adversarial networks to create synthetic high-resolution wind and solar spatiotemporal data from coarse low-resolution inputs.
Python
80
star
22

ssc

SAM Simulation Core (SSC) contains the underlying performance and financial models for SAM
C++
79
star
23

phygnn

physics-guided neural networks (phygnn)
Python
74
star
24

ditto

DiTTo is a Distribution Transformation Tool that aims at providing an open source framework to convert various distribution systems modeling formats.
Python
69
star
25

floorspace.js

JavaScript
68
star
26

mappymatch

Pure-python package for map matching
Python
66
star
27

EvoProtGrad

Directed evolution of proteins in sequence space with gradients
Jupyter Notebook
60
star
28

PhIRE

Python
58
star
29

dgen

The Distributed Generation Market Demand (dGen) model simulates customer adoption of distributed energy resources (DERs) for residential, commercial, and industrial entities in the United States and other countries.
Python
58
star
30

BuildingsBench

Large-scale pretraining and benchmarking for short-term load forecasting.
Jupyter Notebook
55
star
31

wex

WEX, which is short for WxWidgets Extensions, is a cross-platform library of graphical user interface tools that extends the popular open-source project WxWidgets. WEX includes many features including the powerful DView program (https://github.com/NREL/wex/wiki/DView), which provides an easy-to-use way to visualize complex time series data.
C
55
star
32

turbine-models

Documentation for the turbine models in this repository is available below.
Python
54
star
33

nfp

Keras layers for end-to-end learning with rdkit and pymatgen
Python
52
star
34

alfabet

Machine learning predictions of bond dissociation energy
Python
52
star
35

WindSE

Python
51
star
36

ParaEMT_public

Python
50
star
37

BuildingMOTIF

Building Metadata OnTology Interoperability Framework (BuildingMOTIF). For models, see https://models.open223.info/
Jupyter Notebook
49
star
38

SolarPILOT

SolarPILOT power tower layout and optimization tool
C++
46
star
39

dynamo

A modular MATLAB toolkit for Dynamic programming (DP) and Approximate Dynamic Programming (ADP) for Adaptive Modeling and Optimization
MATLAB
45
star
40

OpenStudio-server

The OpenStudio Server is a docker or Helm deployable instance which allows for large-scale parametric analyses of building energy models using the OpenStudio or URBANopt CLIs.
Ruby
45
star
41

PRAS

NREL's Probabilistic Resource Adequacy Suite (PRAS)
Julia
44
star
42

developer.nrel.gov

An issue tracker for NREL's APIs available at https://developer.nrel.gov
HTML
43
star
43

gdx-pandas

Python interface to read and write GAMS GDX files using pandas.DataFrames as the intermediate data format.
Python
43
star
44

alfalfa

Alfalfa is a web service that enables runtime interaction with building energy models (OpenStudio/EnergyPlus and FMUs compiled from Modelica or Spawn) over REST APIs.
Python
42
star
45

OpenStudio-HPXML

Modeling of residential buildings in EnergyPlus using OpenStudio/HPXML.
Ruby
41
star
46

OCHRE

A Python-based building energy modeling (BEM) tool designed to model flexible loads in residential buildings
Python
40
star
47

graph-env

Reinforcement learning for combinatorial optimization over directed graphs
Python
38
star
48

elm

ELM is a collection of utilities to apply Large Language Models (LLMs) to energy research.
Python
37
star
49

OPFLearn.jl

A Julia package that efficiently creates representative datasets for machine learning approaches to AC optimal power flow
Julia
37
star
50

PyPSCAD

36
star
51

PV_ICE

An open-source tool to quantify Solar Photovoltaics (PV) Energy and Mass Flows in the Circular Economy, from a Reliability and Lifetime approach
HTML
34
star
52

windtools

Python tools for wind simulation setup, data processing, and analysis
Python
34
star
53

PyDSS

Python
33
star
54

SolTrace

SolTrace
C++
33
star
55

MATBOX_Microstructure_analysis_toolbox

MATBOX is an open-source MATLAB toolbox dedicated to microstructure analsyis of porous/heterogeneous materials
MATLAB
32
star
56

REopt-Analysis-Scripts

Jupyter Notebook
32
star
57

OpenStudio-analysis-spreadsheet

The OpenStudio Analysis Spreadsheet is a front-end for the OpenStudio Server, allowing for users to create large-scale cloud analyses using OpenStudio measures.
Ruby
31
star
58

flasc

A rich floris-driven suite for SCADA analysis
Jupyter Notebook
31
star
59

SOWFA-6

31
star
60

lk

LK (Language Kit) is a simple but powerful scripting language that is designed to be small, fast, and easily embedded in other applications. The core LK engine, including lexical analyzer, parser, compiler, and virtual machine is only dependent on the Standard C++ Library (STL), making it extremely lightweight and portable.
C
31
star
61

rlmolecule

A reinforcement learning library for material and molecule optimization
Python
30
star
62

GEOPHIRES-v2

GEOPHIRES v2.0: a free and open-source geothermal techno-economic simulator
Python
30
star
63

bifacialvf

Bifacial PV View Factor model for system performance calculation
Python
29
star
64

openfast-turbine-models

A repository of OpenFAST turbine models developed by NREL researchers.
Jupyter Notebook
29
star
65

ATB-calc

Python files and Jupyter notebooks for processing the Annual Technology Baseline (ATB) electricity data and determining LCOE and other metrics.
Python
29
star
66

MoorPy

Python
28
star
67

EnergyPlusRelease

Fortran
27
star
68

ComStock

National scale modeling of the U.S. commercial building stock supported by U.S. DOE, LADWP, and others and maintained by NREL
Ruby
27
star
69

PVDegradationTools

Set of tools to calculate degradation responses and degradation related parameters for PV.
Jupyter Notebook
27
star
70

OpenStudio-PAT

The Parametric Analysis Tool (PAT) is part of the OpenStudio collection of software tools.
Ruby
27
star
71

m2p

Python
26
star
72

DSS-SimPy-RL

This repository is an Reinforcement Learning Platform for learning agents to control cyber-physical Power Distribution Systems resiliently. The cyber environment in based on SimPy Discrete Event Simulator, while the distribution system is backened by Open-DSS.
Python
25
star
73

BACnet

Java
24
star
74

REopt.jl

Julia
24
star
75

api-umbrella-gatekeeper

See the https://github.com/NREL/api-umbrella repository instead.
JavaScript
23
star
76

HOPP

Jupyter Notebook
22
star
77

api-umbrella-web

See the https://github.com/NREL/api-umbrella repository instead.
Ruby
22
star
78

OpenWARP

Please visit http://nrel.github.io/OpenWARP/ for more information.
Python
22
star
79

ROSCO_toolbox

A repository for generating ROSCO controller input files and more.
Python
22
star
80

hive

HIVEâ„¢ is a mobility services research platform
Python
22
star
81

buildstockbatch

Python
21
star
82

PyPSSE

Python
21
star
83

Panel-Segmentation

This open-source package provides a framework for automatically detecting and extracting metadata from solar array installations in satellite images.
Jupyter Notebook
21
star
84

reVX

The Renewable Energy Potential(V) eXchange Tool: reVX
Python
21
star
85

OpenStudio-Prototype-Buildings

Ruby
20
star
86

HydroChrono

A hydrodynamics extension for Project Chrono, enabling simulations of wave energy converters, floating offshore wind turbines, and more.
C++
20
star
87

docker-openstudio

Repository for managing the builds of OpenStudio Docker images.
Dockerfile
20
star
88

fastsim

Python
20
star
89

electrolyzer

Python
20
star
90

ProgressiveHedging.jl

Basic progressive hedging implementation in Julia
Julia
20
star
91

rex

REsource eXtraction Tool (rex)
Python
20
star
92

powerscenarios

Realistic renewable energy scenarios for stochastic grid optimization problems
MATLAB
20
star
93

hescore-hpxml

HPXML to Home Energy Score Translator
Python
18
star
94

OpenStudio-fault-measure-gem

OpenStudio measures for modeling building faults
Ruby
18
star
95

CampusEnergyModeling

MATLAB
18
star
96

latex_editing

TeX
18
star
97

OpenStudio-resources

HTML
18
star
98

OpenStudio-ERI

Energy Rating Index (ERI) calculation via OpenStudio/EnergyPlus.
Ruby
18
star
99

NRWAL

The National Renewable Energy Laboratory Wind Analysis Libray (NRWAL)
Python
17
star
100

altrios

Rust
17
star