SOLMAPS(1) General Commands Manual SOLMAPS(1)

solmaps — extract and save receiver flux maps from Solstice results

solmaps [file]

solmaps reads the results of a solstice(1) simulation from file or from standard input whether a filename is provided as an argument or not, respectively. It extracts the maps of incoming flux computed by solstice(1) for the receivers whose per_primitive flag is enabled. Refer to solstice-receiver(5) for more information. Each map is then saved in a separate VTK file that can be visualised and analysed in a data visualisation tool such as ParaView.

The naming scheme for the output files depends on the way the sun direction was provided to solstice(1):

  • using the -D azimuth,elevation flag: the output file is named after the following pattern: 
    printf "%g-%g-%s.vtk" azimuth elevation receiver_name
  • using the -L latitude,longitude and -T time flags: the output file is named after the following pattern: 
    printf "%g-%g-%s-%s.vtk" latitude longitude time receiver_name

The solmaps utility exits 0 on success, and >0 if an error occurs.

Pipe solstice(1) with solmaps to extract the flux maps of the receivers for each provided sun direction:

solstice -D45,70 -D50,75 -R rcvs.yaml input.yaml | solmaps

First, invoke solstice(1) to write the results to output, then run solmaps on this file to extract the flux maps of the receivers for the provided sun direction:

solstice -L3,40 -T"2026-08-15T17:20:00" -R rcvs.yaml -o output input.yaml
solmaps output

solpaths(1), solpp(1), solppraw(1), solstice(1), solstice-output(5), solstice-receiver(5)

solmaps was initially developed with funding from the (Laboratory of Excellence), in collaboration with the PROMES Laboratory of the French National Centre for Scientific Research (CNRS). Starting in 2026, a new development effort funded by Ademe is ongoing.

solmaps was written and is maintained by |Méso|Star> <contact@meso-star.com>.

August 17, 2026 UNIX