%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%% Description of MARSIS and SHARAD blackout files %%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


%% This data set contains the time when the radars Mars Advanced Radar for Subsurface and Ionosphere Sounding (MARSIS)
%% on board Mars Express and the Shallow Radar (SHARAD) on board Mars Reconnaissance Orbiter suffered total or partial
%% blackouts when sounding the surface of Mars. The files including all operational orbits by both radars are also 
%% included. 

%% If this dataset is used, please acknowledge the following paper together with this dataset:

   --> M. Lester, B. Sanchez-Cano, D. Potts, R. Lillis, M. Cartacci, F. Bernardini, R. Orosei, M. Perry, N. Putzig,
	B. Campbell, P.-L. Blelly, S. Milan, H. Opgenoorth, O.Witasse, The Impact of Energetic Particles on the Martian
	Ionosphere during a Full Solar Cycle of Radar Observations: Radar Blackouts, Journal of Geophysical
	Research Space Physics (awaiting for DOI).

%% In addition, this dataset contains a color-blind friendly version of the figures that use the "colormap jet" (from MATLAB)
%% in the previous paper. The new versions are made with both "colormap parula" and "colormap jet".


%% For information, contact Prof Mark Lester, University of Leicester, UK [mle@leicester.ac.uk] or
%% Dr Beatriz Sanchez-Cano, University of Leicester, UK [bscmdr1@leicester.ac.uk] 


%% Description of the files

	- MARSIS_blackout_list.txt
		-Decription: Mars Express-MARSIS blackout list, when MARSIS was operating in subsurface mode
		-Columns:
			day : day of month
			month : month of year
			year : four digit year in the Common Era
			hour : hours of day
			min : minutes of hour
			sec : seconds of minute
			total_blackout : 0 if not a total blackout, 1 if a true 
			partial_blackout : 0 if not a partial blackout, 1 if true

	- SHARAD_blackout_list.txt
		-Decription: Mars Reconnaisance Orbiter -SHARAD blackout list
		-Columns:
			day : day of month
			month : month of year
			year : four digit year in the Common Era
			hour : hours of day
			min : minutes of hour
			sec : seconds of minute
			total_blackout : 0 if not a total blackout, 1 if a true 
			partial_blackout : 0 if not a partial blackout, 1 if true
			
	- MARSIS_Orbits.txt
		-Decription:  Mars Express-MARSIS orbit list, when MARSIS was operating in subsurface mode
		-Columns:
			year : four digit year in the Common Era
			month : month of year
			day : day of month
			hour : hours of day
			min : minutes of hour
			sec : seconds of minute
			total_blackout : 0 if not a total blackout, 1 if a true 
			orbit : 0 if not an orbit, 1 if a true 	
			
	- SHARAD_Orbits.txt
		-Decription: Mars Reconnaisance Orbiter -SHARAD orbit list
		-Columns:
			day : day of month
			month : month of year
			year : four digit year in the Common Era
			hour : hours of day
			min : minutes of hour
			sec : seconds of minute
			total_blackout : 0 if not a total blackout, 1 if a true 
			orbit : 0 if not an orbit, 1 if a true 	

	- List of figures (color-blind friendly)	
		- Figure3_colorblind1.png (colormap parula)
		- Figure3_colorblind2.png (colormap hot)
		- Figure6_colorblind1.png (colormap parula)
		- Figure6_colorblind2.png (colormap hot)	
		- Figure7_colorblind1.png (colormap parula)
		- Figure7_colorblind2.png (colormap hot)
		- Figure8_colorblind1.png (colormap parula)
		- Figure8_colorblind2.png (colormap hot)	
		- Figure9upper_colorblind1.png (colormap parula, upper panel of original figure)
		- Figure9upper_colorblind2.png (colormap hot, upper panel of original figure)		
		- Figure9bottom_colorblind1.png (colormap parula, bottom panel of original figure)
		- Figure9bottom_colorblind2.png (colormap hot, bottom panel of original figure)	

		
%% Acknowledgments:

	This dataset has been created in the frame of UK-STFC grant ST/S000429/1.