Preface to 2.3 11
Introduction 13
Acknowledgments 15
I User's Guide 17
1 Installation 19
1.1 Getting the sources 19
1.2 Installing Vairmer 19
1.3 Installing the visualization softwares 20
2 Getting Started 21
2.1 How does Vairmer work ? 21
2.2 The General Circulation models 21
2.3 Running a tool 22
2.4 Defining tools variables 22
2.4.1 Directories 23
2.4.2 Field names 23
2.4.3 Calendar and date format 23
3 The extraction tool: deepost 24
3.1 Specific deepost variables 24
3.2 Arpege extraction 24
3.3 Daily to Monthly Vairmer format extraction 25
4 The analysis tool: vairfim 27
4.1 What can be done ? 27
4.2 Specific vairfim variables 27
4.3 Basic analysis 28
4.4 Hovmoeller analysis 29
4.5 Difference analysis (DI) 31
4.6 Vertical Slice analysis (VS) 32
4.7 Horizontal Slice analysis (HS) 32
4.8 Zonal Mean analysis (ZM) 32
4.9 Time serie brick extraction (EB) 33
4.10 Macro Field Operations analysis 33
4.11 Automatic launch of vairfim 34
4.12 Automatic visualization 34
4.13 Using vairfim on Crays 35
5 The visualization tool: post-it 36
5.1 Specific post-it variables 36
5.2 Types of analysis 36
5.3 Input Databases 38
5.4 Output formats 38
5.5 GMT 38
5.5.1 Page layout 38
5.5.2 Page text contents 40
5.5.3 Fields and curves superposition 40
5.6 VISUO 41
5.7 Defining your plot domain 41
5.8 Types of output 42
5.9 Color palettes and grey shading for GMT output 43
5.9.1 Palettes 43
5.9.2 Shading 43
5.9.3 Shading/color technique 43
5.10 Vectors for GMT outputs 44
5.11 Visualization defaults 44
5.12 Automatic launch of post-it 45
5.13 Examples 46
6 The Vairmer environment 48
6.1 Using Vairmer Databases 48
6.2 Vairmer Relational Database VDBR 48
6.3 Vairmer files related tools 49
6.4 Communication with remote machines 50
6.5 Running Vairmer on Crays 50
6.6 Report edition 51
6.7 Error handling 51
7 The Vairmer default parameters 53
7.1 Vairmer general defaults: vairmer_def.h 53
7.2 Experiments definitions: exper_title.h 55
7.3 Visualization defaults 55
7.3.1 Fields legends: field_legen.h 55
7.3.2 Plot domains: gmt_default.h 56
7.3.3 Interpolation algorithms: gmt_default.h 57
7.3.4 Isocontours 57
7.3.5 Color and Shading 59
7.3.6 Vectors 60
7.3.7 Presentation and layout parameters 60
7.3.8 Other parameters 62
II Programmer's Guide 63
8 Introduction to the Programmer's Guide 65
9 Directory Organization 66
9.1 The Defaults/ directory 67
9.2 The Reports/ directory 67
9.3 The work/ directory 67
9.4 Directory variables 67
10 Typical Chain of Execution 69
11 The UNIX Shell Scripts 70
11.1 The tool scripts 70
11.2 The deepost tool scripts 70
11.3 The post-it tool scripts 71
11.4 Error handling 71
12 Data Handling 73
12.1 Getting the data from VDBs 73
12.2 Transforming the data 74
12.3 Storing the new data to VDBs 75
12.4 Remote file handling 75
13 The FORTRAN Tools 77
13.1 The MAIN program 77
13.2 Compiling 77
13.3 Grids 78
13.4 Error handling 79
13.5 The subroutines 79
14 Cray routines and scripts 81
14.1 Automatic 'relance' system 81
14.2 Batch requests 81
15 Extending Vairmer functionnalities 82
15.1 Fields 82
15.2 Grids, masks \& scale factors 82
15.2.1 File formats 82
15.2.2 Nomenclature 83
15.2.3 FORTRAN initializing 84
15.2.4 Problems when compiling or executing? 84
15.3 New features 84
15.4 DEBUG mode 84
A Vairmer File Format 86
A.1 Name 86
A.2 Brick structure 87
A.3 Storage format 88
A.4 Patterns codification 88
A.5 Custom Vairmer files 89
A.5.1 Custom files names 90
A.5.2 Custom bricks 90
B Custom subsets 92
B.1 Pseudo-3D subsets 92
B.2 3D subsets 93
C Vairmer Atmospheric Variables 94
D Vairmer Oceanic Variables 97
E Vairmer Ice Model Variables 100
Disclaimer 102