These files contain software codes used in the manuscript
"Convective vortices and dust devils detected and characterized by Mars 2020"
by Hueso et al. submitted to JGR: Planets on August 2022.

These files are a combination of fortran programs and IDL scripts documented as below:

Questions in the use of these tools can be directed to ricardo.hueso@ehu.eus

================================================================================
* MEDA IDL Programs 
================================================================================
These folder contains a set of IDL based programs used in the manuscript
"Convective vortices and dust devils detected and characterized by Mars 2020"
by Hueso et al.

The programs are organized in subfolders and all of them need to be installed in the IDL path.

To run the detection of vortices you can start with the program dd_multi_search.pro in the folder meda vortices

The "datafolder" keyword might appear on errors when running the software. This variable is the one where MEDA data is supposed to be stored in folders named Sol0001, Sol0002 and so on...

Questions can be sent to ricardo.hueso@ehu.eus


================================================================================
* DRIFTING VORTICES (F90 programs)
================================================================================

  - DD_MEDA_generate_parameters.f90  Run this program to generate a table of parameters to launch models
  - DD_MC_model.f90                  Run then this program to read the table and launch a model for each set of parameters
  
  After the models have been launched use the following scripts in IDL:

  MC_Vortices_Plots_Sol_0311.pro to compare the models in a given directory with a MEDA file extracted from the original data and centered around the vortex to model

  To extract the data from MEDA files you can use the software:
  dd_extract_ps_and_ws_from_catalog.pro

  MC_Vortices_Analyze_chi2_General.pro (in IDL) to examine the results


================================================================================
* LES Analysis (IDL)
================================================================================
The LES analyzed in this paper was transformed into an IDL sav file storing only the pressure data from the original simulation. 
The file is named: "P_auxhist5_d01_0001-00090_12_00_00.sav"
and its contents can be restored with the IDL command: restore, P_auxhist5_d01_0001-00090_12_00_00.sav

The IDL programs in this directory provide a set of tools to interact with the data and investigate the vortices in the simulation

================================================================================
* Monte Carlo analysis of crossing distances (IDL)
================================================================================

  Monte_carlo_vortices_distancesv2.pro

================================================================================