Skip to content

DeveloperPages

Peter van Hoof edited this page Jan 21, 2025 · 46 revisions

Release version to-do list

The GoldVersionToDo page has the steps for creating a release version of the code.

Notes on Git, GitLab, and Markdown

Git

  • Official GitLab Git cheat sheet
  • Notes on helpful Git commit messages
  • The official Pro Git book and the documentation main page, including this book, the complete reference manual, and a set of learning videos.
  • Notes for merging a branch to master MergeToMaster.

GitLab

MarkDown and the Wiki

  • Gary's notes on markdown are here. A quick and simple introduction of Markdown is here and another more useful GitLab Markdown Cheat sheet. The very complicated documentation for GitLab's version of Markdown is here.
  • You can clone the wiki repo by clicking on the clone icon. By default you then have the full set of wiki files in the cloudy.wiki directory. You can edit the wiki locally then push the changes back to origin/master
  • Check that there are no dead links (use a dead link checker, e.g., Check my Links)

Other notes

The monitors for our test suite

MakingContributions

HotFixToDo has the steps for creating a hot-fix entry.

Experimental version of prototype minimal instructions for building Cloudy

The code's StylePage includes a description of some routines that should be used to do common chores.

The DataParser page describes our custom parser specifically designed for efficiently reading data files.

The MultiArrPage describes the new multi_arr structure for allocating and accessing multi-dimensional arrays in Cloudy.

On the VectorMathRoutines page you will find a discussion of all the transcendental math functions that were vectorized using the AVX and later instruction sets.

Our license file is in the root directory of any checkout.

Hardware

Cloudy with MacOS

Developing With Dlx

Developing With Physics Cluster and other Lexington Physics cluster machines

Developing With Windows

Compilers and the helpers

Developing With Valgrind

Developing With Gcc

Cloudy with Mac homebrew gcc

Developing With Icc

Developing With ClangLLVM

Code Analysis Tools

The MakefileDescription page describes how to use the make utility to compile Cloudy. The MakeFileDeveloping page explains some debugging options.

DevelopingInMPI

Emacs and IDEs

EmacsSettings has suggestions for .emacs file settings to get indentation consistent with the coding conventions.

Developing With Eclipse

Developing With Net Beans

Developing With Xcode

Developing with Visual Studio

Scripts

RemoveHeaders removes unused header files.

scripts/rm-tests-from-git.pl removes a CLOUDY_ROOT/tests/ directory from the entire repository history. Useful with debugging.

svn, git, and hg

The SubversionPage outlines the way we maintain the Subversion repository.

DevelopingWithGitAndHg

Testing

TestFramework

UnitTest

AssertTrapping

Discussions and Meetings

Discussions at the 2016 CloudySummitMexico16

Discussions at the 2014 CloudySummitBelfast14

Discussions at the 2012 CloudySummitAthens

The 2011 NLTE7 code comparison meeting

Discussions at the 2011 CloudySummitBelfast

Discussions at the 2009 CloudySummitDurham

Discussions at the 2008 CloudySummitImperial

Discussions at the 2007 CloudySummitBrussels

Papers

SharingBibliography


Return to home page


Clone this wiki locally