! The MIT License (MIT) ! ! Copyright (c) 2023-2024 Vincent Magnin ! ! Permission is hereby granted, free of charge, to any person obtaining a copy ! of this software and associated documentation files (the "Software"), to deal ! in the Software without restriction, including without limitation the rights ! to use, copy, modify, merge, publish, distribute, sublicense, and/or sell ! copies of the Software, and to permit persons to whom the Software is ! furnished to do so, subject to the following conditions: ! ! The above copyright notice and this permission notice shall be included in all ! copies or substantial portions of the Software. ! ! THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR ! IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, ! FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE ! AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER ! LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, ! OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE ! SOFTWARE. !------------------------------------------------------------------------------- ! Contributed by vmagnin: 2023-09-26 ! Last modification: gha3mi 2023-11-01, vmagnin 2026-01-08 !------------------------------------------------------------------------------- !> This example demonstrates the use of the 'reverse' optional argument to !> reverse the order of a colormap. program demo_reverse use forcolormap, only: Colormap, wp, cmap_info implicit none integer :: i type(Colormap) :: cmap, custom_cmap real(wp), dimension(2), parameter :: xmin = [0.0_wp, 0.0_wp] real(wp), dimension(2), parameter :: xmax = [599.0_wp, 599.0_wp] !> A discrete colormap with 8 levels, by @alozada, resembling the color !> changes in red cabbage (containing Anthocyanins) with pH: integer, dimension(0:7, 3) :: my_colormap = reshape( [ & 198, 29, 32, & 189, 21, 56, & 171, 82, 150, & 102, 81, 156, & 38, 53, 108, & 5, 65, 40, & 221, 199, 44, & 237, 191, 44 ], & shape(my_colormap), order = [2, 1] ) !> The name of your colormap must conform to the max length !> defined in forcolormap_parameters.f90 ! Use the create() method instead of the set() method. call custom_cmap%create('red_cabbage_reverse', 0.0_wp, 2.0_wp, my_colormap, reverse=.true.) call custom_cmap%colorbar('red_cabbage_reverse_colorbar') call custom_cmap%colormap('red_cabbage_reverse_test', zfun, xmin, xmax) ! We create PPM files (binary encoded by default) for each built-in colormap. ! The built-in z=f(x,y) test function is in the [0, 2] range: do i = 1, cmap_info%get_ncolormaps() call cmap%set(trim(cmap_info%get_name(i)), 0.0_wp, 2.0_wp, reverse=.true.) call cmap%colorbar(trim(cmap_info%get_name(i))//'_reverse_colorbar') call cmap%colormap(trim(cmap_info%get_name(i))//'_reverse_test', zfun, xmin, xmax) print '("Colormap ", A30, " has ", I0, " levels")', trim(cmap%get_name()), cmap%get_levels() end do ! Cubehelix can also accept other parameters (varargs array): call cmap%set("cubehelix", 0.0_wp, 2.0_wp, 1024, [0.5_wp, -1.0_wp, 1.0_wp, 1.0_wp], reverse=.true.) ! We change the name for the output test files: call cmap%colorbar('cubehelix_customized_reverse_colorbar') call cmap%colormap('cubehelix_customized_reverse_test', zfun, xmin, xmax) !> You can also download your colormap from a .txt file by !> using the load() method instead of the set() method. call custom_cmap%load("test_map_to_load.txt", 0.0_wp, 2.0_wp, reverse=.true.) call custom_cmap%colorbar('a_loaded_reverse_colorbar') call custom_cmap%colormap('a_loaded_reverse_colormap_test', zfun, xmin, xmax) call custom_cmap%print() contains !> A sample test function to generate colormap images. pure function zfun(x,y) result(z) real(wp), intent(in) :: x, y real(wp) :: z z = 1.0_wp + sin(x*y/10000.0_wp) * cos(y/100.0_wp) end function end program demo_reverse