***********************************************************************************
CelestLab - CNES Space mechanics toolbox for Scilab - Detailed Changelog
***********************************************************************************
====================================
Version 3.5.2 - June 2, 2025
====================================
---------------------------
Overview
---------------------------
CelestLab has been slightly improved in comparison with the previous version.
-> See details below.

Note that this version of CelestLab is compatible with Scilab 5.5.2 up to Scilab 2025.1.0.  
CelestLabX is also compatible with these Scilab versions (provided the correct binary version is used).  


***********************************************************************************
Detailed changelog:
***********************************************************************************

---------
Bug fixes
---------
None

--------------------------
Improved/changed functions
--------------------------
TLE:
- CL_tle_load, CL_tle_parse, CL_tle_format : added support for JSON and OMM-XML formats.

-------------
New functions
-------------
TLE:
- CL_tle_write: Generation of a file containing the TLEs. 

-------------------
New / updated demos
-------------------
None

------------------------
New / updated help pages
------------------------
None

--------------------
Data / configuration
--------------------
None

------------------------
New deprecated functions
------------------------
None

-----------------
Removed functions
-----------------
None

-------------
Miscellaneous
-------------
None

====================================
Version 3.5.1 - October 30, 2024
====================================
---------------------------
Overview
---------------------------
CelestLab has been slightly improved in comparison with the previous version.
-> See details below.

Note that this version of CelestLab is compatible with Scilab 5.5.2 up to Scilab 2024.0.0.  
CelestLabX is also compatible with these Scilab versions (provided the correct binary version is used).  


***********************************************************************************
Detailed changelog:
***********************************************************************************

---------
Bug fixes
---------
- CL_detectZero: correction of anomaly for which two output values were given.
- CL_rot_interpQuat: corrected verification of the minimal size of one of the input variables.

--------------------------
Improved/changed functions
--------------------------
None

-------------
New functions
-------------
Geometry:
- CL_gm_projLine: computation of the orthogonal projection of a point onto a straight line.

Utilities:
- CL_colormap: colormap function for backward compatibility for versions older than Scilab 2024.1.0.

-------------------
New / updated demos
-------------------
None

------------------------
New / updated help pages
------------------------
None
--------------------
Data / configuration
--------------------
- Update of International Geomagnetic Reference Field (IGRF) model data with new version 13.

------------------------
New deprecated functions
------------------------
None

-----------------
Removed functions
-----------------
None

-------------
Miscellaneous
-------------
None

====================================
Version 3.5.0 - February 07, 2024
====================================
---------------------------
Overview
---------------------------
CelestLab has been slightly improved in comparison with the previous version.
-> See details below.

Note that this version of CelestLab is compatible with Scilab 5.5.2 up to Scilab 2024.0.0.  
CelestLabX is also compatible with these Scilab versions (provided the correct binary version is used).  


***********************************************************************************
Detailed changelog:
***********************************************************************************

---------
Bug fixes
---------
- CL_fsolveb: the function did not converge in some cases (fixed). 
- CL_g_legend: the legend title was not always displayed (fixed).

--------------------------
Improved/changed functions
--------------------------
CL_locationInfo: the data used have been regenerated. A new quantity is available: "sea_ratio".
CL_plot_EarthMap: new resolution option available: medium resolution "med".

-------------
New functions
-------------
Geometry:
- CL_gm_circumCircle: computation of the circle passing through three points.

Maneuvers:
- CL_man_dvHohmannRotP: computation of Hohmann-like 2-maneuver orbital transfer with plane rotation.

Models:
New interfaces for the management of JPL ephemerides (DE405 and more):
- CL_ephDE_getPVA
- CL_ephDE_getTDB
- CL_ephDE_setPath
- CL_ephDE_load
- CL_ephDE_loadT

Utilities:
- CL_scilabVersion: function returning the version of Scilab as a number. 

-------------------
New / updated demos
-------------------
New demos:
- Drifts_due_to_J2_-_relative 
- Cost_of_AOL_drift_rate_change
- Low_thrust_effect_-_sma_inc_-_circular
- Cost_of_RAAN_change
- Cost_of_AOL_change
- Cost_of_Hohmann_transfer_with_plane_rot
- Cost_of_Hohmann_transfer_-_relative

Updated demos: 
- Bielliptic_versus_Hohmann
- Cost_of_RAAN_drift_rate_change

------------------------
New / updated help pages
------------------------

--------------------
Data / configuration
--------------------
- Update of data for Earth map outlines and land ratio information.
- [CelestLabX] Improvement of the management of the path to STELA in the configuration file to reduce risks of inconsistency. 

------------------------
New deprecated functions
------------------------
Models: 
- CL_eph_de405
- CL_eph_de405Load
- CL_eph_de405LoadT

-----------------
Removed functions
-----------------
None

-------------
Miscellaneous
-------------


====================================
Version 3.4.2 - April 04, 2023
====================================
---------------------------
Overview
---------------------------
CelestLab has only been slightly improved in comparison with the previous version.
-> See details below.

Note that this version of CelestLab is compatible with Scilab 5.5.2 up to Scilab 2023.0.0.  
CelestLabX is also compatible with these Scilab versions (provided the correct binary version is used).  


***********************************************************************************
Detailed changelog:
***********************************************************************************

------------------------------
Adaptation for Scilab 2023.0.0 
------------------------------
- Patch in function CL_stat due to a bug in the "cov" function. 

--------------------------
Improved/changed functions
--------------------------
- Minor change in CL_kp_apsConvert: ^ replaced by .^ in conversion (vp, vinf) -> (sma, ecc). Limited or no impact. 

-------------------
New / updated demos
-------------------
- Solar_array_efficiency,  Solar_array_efficiency_function_of_time (Orbit_properties): Correction of  anomaly: eclipses were not always correctly taken into account. 
- Interplanetary_transfers_-_Tisserand_graph.sce: new plot option added: ra/rp. 


====================================
Version 3.4.1 - January 17, 2022
====================================

---------------------------
Overview
---------------------------
CelestLab has been slightly improved in comparison with the previous version.
-> See details below.

Note that this version of CelestLab is compatible with Scilab 5.5.2 up to Scilab 6.1.1.  
CelestLabX is also compatible with these Scilab versions (provided the correct binary version is used).  


***********************************************************************************
Detailed changelog:
***********************************************************************************

----------
Bugs fixes
----------
- CL_ex_getInfo: Correction of an anomaly preventing the computation for vectorized inputs for models different from "eckhech".
- (Julian to calendar dates - CL__dat_jd2cal) : in some (rare) cases accuracy was lost, which caused a one-day error in the transformation from Julian to calendar representation. 
- CL_cov2cor: correction of a small anomaly when the covariance matrix contained zeros in the diagonal (which resulted in Nan values in the correlation matrix). 
- CL_gm_visiParams: if the angle from the satellite was more than 90 degrés, results were inconsistent. Now results are Nan in this case. 

--------------------------
Improved/changed functions
--------------------------

-------------
New functions
-------------
- CL_op_frozenOrbitDerCir: Computation of derivatives for frozen orbits. Equivalent to previously existing "CL_op_frozenOrbitDer", but adapted to "circular" orbital elements. 
- CL_fileparts: same as fileparts but with a behaviour intended to be closer to what existed in previous Scilab versions (ignoring file separator at end of string). 

-------------------
New / updated demos
-------------------
geoid: 3D problem due to "colorbar" has been fixed.  
 
------------
New features  
------------
- Compatibility with Scilab 6.1.1.


------------------------
New / updated help pages
------------------------
- New page about effect of atmospheric drag. 

--------------------
Data / configuration
--------------------
None

------------------------
New deprecated functions
------------------------
None

-----------------
Removed functions
-----------------
None

--------------------
Miscellaneous
--------------------
- General coding style improvements.
- correction of documentation (typos...) 


====================================
Version 3.4.0 - August 4, 2020
====================================

----------
Bugs fixes
----------
- CL_adjustState: Correction of an anomaly with method 'lsq': weights were not accounted for.
- CL_co_car2sph: Empty inputs are now supported and empty outputs are then returned.
- CL_co_sph2car: Empty inputs are now supported and empty outputs are then returned.
- CL_op_repeat2smaInc: Correction of erroneous outputs in the case of vectorized inputs when SSO do not exist.
- CL_rot_interpQuat: Added test for empty arrays.
- Patches for several Scilab bugs: #15967, #16340, graphical bugs, etc.
- Small correction in fsolveb: the status was sometimes 0 (OK) whereas the algorithm had not converged. 

--------------------------
Improved/changed functions
--------------------------
- CL_dat_cal2str: ISO 8601 format compatibility added.
- CL_dat_str2cal: ISO 8601 format compatibility added.
- CL_ex_getInfo: Added properties for some models.
- CL_quantile: Now accepts matrix inputs.
- CL_tle_load: Improved identification of data lines as only those starting with 1 or 2 and of length equal to 69 are actual data lines.
- CL_mod_geomagField: Validity extended to 1 January 2030.
- CL_intervSelectIn: Added output argument to retrieve indices of elements belonging to at least one interval.
- CL_rot_interpQuat: Added margins for extrapolation outside of the input time interval range (preventing having no results if inputs times do not march exactly).

-------------
New functions
-------------
- CL_addM: Matrix addition (with automatic size ajustment).
- CL_g_getFigureHandle: Retrieve figure handle.
- CL_intervFromCond: Determination of intervals from vector of booleans.
- CL_kp_apsConvert: Conversion of apsides properties. This function replaces specific ones now deprecated (CL_op_rarp2ae, CL_op_rpvp2ae, etc).
- CL_op_eccVector3d: Computation of eccentricity vector.
- CL_man_dvIncSmaCirc: Coupled semi-major axis/inclination maneuvers for circular orbits.
- CL_man_vLambert: replaces / extends CL_man_lambert. 


-------------------
New / updated demos
-------------------
- Two new demos 'N-body - choreographies' and 'N-body - simulation' in 'Astro stuff'.
- Updated 'Restricted 3-body problem' display to be isometric.
- Updated 'Geomagnetic field'
- Moon option added in demo 'Swing-by - planetary' in 'Interplanetary'.

 
------------
New features  
------------
- Compatibility with Scilab 6.1.0.


------------------------
New / updated help pages
------------------------
- 'Natural Relative Motion' and 'Orbital Elements' are now 2 separate pages.
- Correction of erroneous mu ratio in an example in 'Numerical Integration'.
- 'Frame transformation' updated.
- Improvement of several functions help pages (CL_cw_Mmatrix, CL_dat_cal2cjd, CL_ex_getInfo, CL_interpLagrange, CL_mod_atmMSIS00, CL_rot_quatSlerp, CL_stela_area...) 


--------------------
Data / configuration
--------------------
- Validity of geomagnetic model extended to 1 January 2030.


------------------------
New deprecated functions
------------------------
- CL_op_rarp2ae: Replaced by CL_kp_apsConvert.
- CL_op_rava2ae: Replaced by CL_kp_apsConvert.
- CL_op_rpvinf2ae: Replaced by CL_kp_apsConvert.
- CL_op_rpvp2ae: Replaced by CL_kp_apsConvert.
- CL_man_lambert: Replaced by CL_man_vLambert. 
 
-----------------
Removed functions
-----------------
None


--------------------
Miscellaneous
--------------------
- General coding style improvements.
 
 
====================================
Version 3.3.1 - May 22, 2019
====================================

---------------------------
Overview
---------------------------
CelestLab has been slightly improved in comparison with the previous version.
-> See details below.

Note that this version of CelestLab is compatible with Scilab 5.5.x up to Scilab 6.0.2.  
CelestLabX is also compatible with these Scilab versions.  


***********************************************************************************
Detailed changelog:
***********************************************************************************

----------
Bugs fixes
----------
- CL_locationInfo: some points were out of [0, 1] interval because of interpolation
- CL_op_orbGapLofMat: consistency check on the number of inputs was erroneous (expected number was 4 instead of 3)
- CL_adjustState: wrong error message


--------------------------
Improved/changed functions
--------------------------
- CL_g_stdaxes: title size is also applied to Z axis now
- CL_cor2cov: computation optimization

Other changes:
- CelestLabX : STELA jar file updated. It is now generated from an external Java project


-------------
New functions
-------------
- CL_ip_flybyOrbits: arrival or departure orbits knowing inclination (hyperbolic orbits)
- CL_plot_rects: plots filled rectangles - CelestLab version of xrects Scilab function
- CL_setdiff: CelestLab version of setdiff function (to deal with Scilab 6.0.2 bug) 
NB: this function may disappear in the future! 
- CL_dat_cal2cjd2: conversion of calendar date to 2 dimension dates (see new features for more details about 2 dimension dates)
- CL_dat_offset: offset between 2 dates
- CL_dat_shift: shift a date

 
-------------------
New / updated demos
-------------------
- Interplanetary/Escape_or_insertion_-_hyperbolic_trajectory: escape or insertion on hyperbolic orbits
- Interplanetary/Swing-by_-_variation_of_absolute_velocity: variation of absolute velocity due to a swing-by
- Astro_stuff/Solar_system_2: new option 2D/3D

 
------------
New features  
------------
- dates (cjd) can now be defined as a 2 dimension array [day, fraction of day]
The following functions have been modified: CL_dat_cjd2cal, CL_dat_convert, CL_dat_scaleConvert
(but there should not be any impact for the user) 
NB: most CelestLab function are not yet compatible with this new date format.  


-------------------------------------
New / updated help pages ("cookbook") 
-------------------------------------
- B-plane calculations
- Interplanetary cruise: simplification thanks to new function CL_ip_flybyOrbits

 
--------------------
Data / configuration
--------------------
None


------------------------
New deprecated functions
------------------------
None

 
-----------------
Removed functions
-----------------
None


--------------------
Miscellaneous
--------------------
- "macros" sub-directory names have been shortened (example: Trajectory_maneuvers --> TrajMan)
- New convention for the description of optional arguments in help pages. See "Introduction -> Usage and conventions -> Functions".


====================================
Version 3.3.0 - October 29, 2018
====================================

---------------------------
Overview
---------------------------
CelestLab has been improved in comparison with the previous version.
-> See details below.

Note that this version of CelestLab is compatible with Scilab 5.5.x and Scilab 6.0.x.  
CelestLabX is also compatible with these Scilab versions.  


***********************************************************************************
Detailed changelog:
***********************************************************************************

----------
Bugs fixes
----------
- CL_detectZero: Multiple intervals in input were not always correctly managed -> fixed
- CL_unitVector: An error occurred with hypermatrices -> fixed
- CL_tle_load: TLE description was not correctly initialized -> fixed
- CL_dat_convert: was not working when type_in = type_out -> fixed


--------------------------
Improved/changed functions
--------------------------
- CL_rot_defRot1Ax, CL_rot_defRot2Ax: Correction to accept empty input vectors 
- CL_dat_scaleConvert: TDB time scale added 
- CL_dat_convert: The computation is now (slightly) more precise
- CL_tle_new: Default international designator updated (was "000" and now is "   ")
- CL_fo_gravityLoad: Slight improvement
- CL_tle_evalAvgElem: Detection of NaN values before call to "lsq" added 
- CL_stela_params: "ref_frame" parameter changed to "appAcc_refFrame" (but ref_frame still accepted))
- CL_stela_params: New argument "enabled_forces" added to enable or disable all forces
- CL_stela_getConst: Earth tides coefficient added in STELA data structure
- CL_dat_cal2str: new argument "nd": Number of digits for the fractional seconds
- CL_path: New optional arguments: maxdepth and smode and ftype (see CL_path help page for more information)
- CL_ex_inverse: More tolerant (if the expected precision is not reached, a warning is raised)
- CL_mod_IAUBodyAngles: UAI transformations updated: celestial bodies orientation data are now defined in configuration files


Other changes:
- Various changes made for compatibility with Scilab6 (such as replacement of lstsize, nanmax, nanmin, ...)
- Standard frame names like ICRF, GCRF... are now accepted in addition to ICRS, GCRS... 


-------------
New functions
-------------
- CL_csl_defWalker: Definition of a Walker constellation
- CL_g_ticks: Creation of a Scilab "ticks" structure (enable hiding Scilab internal structure)
- CL_mod_aeroPanelCoef: Aerodynamic coefficients for a flat plate (free molecular flow)
- CL_mod_aeroPanelAlpha: Accommodation coefficient (Cook theory)
- CL_mod_aeroPanelCoefV: Aerodynamic coefficients for a flat plate (free molecular flow)
- CL_fo_aeroAcc: Acceleration due to aerodynamic force
- CL_man_lowThrustApsKep: Effect of continuous low thrust on Keplerian orbital elements 
- CL_intervSearch: Returns intervals containing values
- CL_mod_atmMSIS00: MSIS2000 atmospheric model (also added in CelestLabX)
- CL_adjustState: Adjustment of initial state vector (least squares) 

 
---------
New demos
---------
- Orbit_properties/Inclination_and_MLTAN_-_near_SSO_-_1: Natural evolution of inclination 
- Orbit_properties/Inclination_and_MLTAN_-_near_SSO_-_2; Natural evolution of inclination
- Geometry/Optimal_lighting_yaw_steering: Illustration of "yaw steering" (solar arrays pointed to the Sun)
- Visibility/Ground_station_pointing_error_-_acquisition: Ground stations pointing errors
- Models/MSIS2000_density_-_local_time: MSIS2000 - effect of local time 
- Models/MSIS2000_density_-_orbit_path: MSIS2000 - atmospheric along an orbit path 
- Models/MSIS2000_density_-_statistics: MSIS2000 - effect of various parameters  
- Models/MSIS2000_density_-_time: MSIS2000 - effect of date/time  
- Maneuvers/Maintenance_of_RAAN_or_MLTAN_-_SSO: Maintenance window for RAAN or MLTAN (SSO) 
- Maneuvers/Maintenance_of_MLTAN_-_SSO_-_simulation: Maintenance of MLTAN - simulation with STELA 

 
---------
New features  
---------
- New demo menu "Help/Find a demo (keywords) ...": find a demo containing specific keywords
- New demo menu "Help/Find a demo (CelestLab function calls) ...": find a demo using a specific CelestLab function


---------
New help pages ("cookbook") 
---------
- Comparison of orbit propagation models  
- Basic orbit determination (orbit fitting) 
- Handling time scales

 
--------------------
Data / configuration
--------------------
- STELA is now embedded in CelestLabX. This avoids having to call CLx_stela_register to use STELA
- Data files compatible with Scilab 6 added (".sod" files with HDF5 format). Old ".dat" files kept for now
- EGM96 potential file "egm96_maxdeg80.scd" is now the default => changes in some constants (J2, ...) 
- Leap second in 2017 added to "time_data.scd"
- TLE example file ("tle_examples.txt") moved from data/misc to data/misc/examples/TLE
- IERS data processing examples added in data/misc/examples/EOP (see cookbook: "Handling time scales")
- Body orientation data have been updated (see "solar_system_data.scd"). Phobos and Deimos bodies have been added

Other points:
- "images" names in file structure has been changed to ".images" for Scilab 6 compatibility


--------------------
New deprecated functions
--------------------
None

 
-----------------
Removed functions
-----------------
None


====================================
Version 3.2.0 - September 12, 2016
====================================
CelestLab has been improved in comparison with the previous version.
-> See details below.

Note that this version of CelestLab is compatible with Scilab 6.0.0-beta2. 
However, CelestLabX is not yet compatible with Scilab 6, which means that
some features would not be available in Scilab 6. 


***********************************************************************************
Detailed changelog:
***********************************************************************************

----------
Bugs fixed
----------
- CL_gm_eclipse: wrong bounds were used for the argument of latitude (upper bound) 

- CL_rot_matrix2quat: there was a vectorization error (which impacted the computation of the quaternion derivatives)  

- CL_man_lambert: a "division by 0" could occur in some particular cases. Checking code added  

- CL_fr_convert (CL__iers_xys_block) : round() added : indices were not integers which caused anomalies in some cases 

- CL__ex_lyddane (internal function): an internal variable was not correctly initialized (vectorization problem) 

- CL__tle_load (internal function): wrong index was used in the code

Other points:
- the management of arguments default values has been improved and the associated code simplified 
(new internal function introduced: CL__dataGetEnv)


--------------------------
Improved/changed functions
--------------------------
- CL_mod_atmUS76, CL_mod_atmUS76Density: %nan is now returned if altitude is out of bounds
 
- CL_stela_convert: conversion to position/velocity removed when not necessary (more efficient)
 
- CL_tle_genEphem: change in management of time scale for a better handling of leap seconds 

- CL_path : argument "hidden" renamed as "hid", as "hidden" seems not to be allowed in Scilab 6
 
- %CLquat_e, %CLquat_i_CLquat: simplification of code

- CL_ex_propagate ...: low level functions are now deprecated (=> easier for user)  

- CL__ex_inverse: maximum number of iterations increased (50 instead of 20)

- CL_fo_albedoAcc: code added to check the sign of acceleration components (protection in case of interpolation errors)

- CL_ip_sphereInfluence: checking of arguments added

- CL_rMod: one output argument (nrev) added 

- CL_intervSelectIn: min and max bounds are now included in results. See description for details 

- CL_oe_car2cir, CL_oe_car2kep, CL_oe_cir2car, CL_oe_cir2kep, CL_oe_kep2car, CL_oe_kep2cir: jacobian is initialized only when necessary 
(to limit the size of allocated memory)  
  
- CL__detectLocExtr: maximum number of iterations increased (20 instead of 15)

- CL_fr_locOrbMat: frame name "rtn" added (same as "qsw"), angular rotation vector is now computed 
(acceleration vector has been added as an optional argument)
 
- CL_unitConvert: unit "min" (= minutes) added. Same as "mn" which was already defined 

- CL_tle_getElem, CL_tle_setElem (CL__tle_sma): there was a convergence problem is some cases (conversion of TLE into orbital elements). 
Value of tolerance parameter (defined in the function) increased

- CL_stela_extrap : reentryAltituyde was not considered due to a wrong name used in Java code

- CL_stela_extrap : new features added (features that exist in stela v3.0.0) 

- overloading operations for matrices added for Scilab 6

- CL_co_car2ell / CL_co_ell2car: improved. Did not work in some cases. Improved/extended algorithm for CL_co_car2ell 

- CL_op_repeatGroundTracks: new feature added 

- CL__3b_stabHaloNewton (internal function): convergence algorithm updated for more robustness

- CL_stela_params: new fields added in structure: solidTides_enabled and appAcc_enabled. But these 2 parameters are optional so that old code still works. 
 
- %CLquat_e,%CLquat_i_quat, %s_i_CLquat: code improved and simplified (Scilab 6 compatibility)
 
- %CLtle_e, %CLtle_i_CLtle: code improved and simplified (Scilab 6 compatibility)

Other changes:
- Many demos have been updated in order to be compatible with Scilab 6.0.0-beta1


-------------
New functions
-------------
Models:
- CL_eph_de405LoadT
- CL_mod_atmRefract
- CL_fo_srpPanelAcc

Orbit properties:
- CL_op_incdotSsoCirc

Trajectory maneuvers:
- CL_ex_mean2osc
- CL_ex_osc2mean
- CL_ex_getInfo

Utils:
- %s_m_s
- %s_t


---------
New / modified demos
---------
Objects in TLE file (TLE)
Orbit lifetime
Visibility parameters 2
Calendar of celestial body phases (extends Calendar of Moon phases)
Sphere of influence
Altitudes : 2nd derivative of altitude added

 
--------------------
Data / configuration
--------------------
-  Configuration file for CelestLab / CelestLabX: automatically updated when more recent versions exist 
in the respective home directories. 
  
- leap second in 2015 added to "time_data.scd"
  
- CelestLab menu improved / extended: possibility to convert binary files for Scilab6 (HDF5 format) 
 
- CelestLabX is now compatible with Stela 3.0. New features are made available in CelestLab - see documentation for details) 


-------------
Documentation
-------------
- The documentation of CelestLab has been updated with new contents and corrected (details not given here)


--------------------
Deprecated functions
--------------------
CL_ex_eckHech => use CL_ex_propagate
CL_ex_eckHechInfos => use CL_ex_getInfo
CL_ex_lyddane => use CL_ex_propagate
CL_ex_lyddaneInfos => use CL_ex_getInfo
CL_ex_lyddaneLp => use CL_ex_propagate
CL_ex_lyddaneMan => use CL_ex_propagateMan
CL_ex_meanEckHech => use CL_ex_osc2mean
CL_ex_meanElem => use CL_ex_osc2mean
CL_ex_meanLydanne => use CL_ex_osc2mean
CL_ex_meanLydanneLp => use CL_ex_osc2mean
CL_dat_utc2tai => use CL_dat_scaleConvert
CL_dat_tai2utc => use CL_dat_scaleConvert
CL_dat_tcb2tdb => use CL_dat_scaleConvert
CL_dat_tdb2tcb => use CL_dat_scaleConvert


-----------------
Removed functions
-----------------
None



====================================
Version 3.1.0 - April 14, 2015			  
====================================
CelestLab has been improved/extended in comparison with previous version. 
-> See details below. 

One major change with respect to the previous version is that CelestLab now comes in 2 parts: 
- CelestLab: the original module that contains all the public interfaces and documentation
- CelestLabX: an additional module that extends CelestLab. It contains low-level
functions that are called by CelestLab.
CelestLab may be used without CelestLabX being installed, but then a few features will 
not be available. 


***********************************************************************************
Detailed changelog:
***********************************************************************************

----------
Bugs fixed  
----------
- CL_rot_defRot2Ax:  Index error in certain cases. The order of solutions was sometimes wrong 
- CL_oe_kep2cir: Size of Jacobian Matrix was not correctly initialized
- CL_sortMat: did not work when the sorting vector was a scalar
- CL_cw_lambert: correction of arguments names 
- CL_fr_bodyConvertMat: correction in code (wrong variable name)
- CL_evalPoly: correction of argument name (coeff)
- CL_gm_eclipseCheck: anomaly corrected (wrong field name used) 
- CL_ip_insertionDv: there was a division by 0 for a circular target orbit

Other corrections: 
- Correction in "cookbook":  CL_fr_convPosVel was wrongly used instead of CL_rot_pvConvert
- Corrections/adaptation of demo tool: the window disappeared due to a change in Scilab (figure "visible" attribute)


--------------------------
Improved/changed functions
--------------------------
- CL_oe_convert: now supports any type of orbital elements 
- CL_dat_str2cal: now correctly handles [] as input parameter
- CL_gm_eclipseCheck: new outputs added: characteristic angles defining umbra or penumbra 
- CL_defParam: input parameter "dim" can now be an interval [min, max] 
- CL_op_searchRepeatOrbits: [] is now returned when no solution is found 
- CL_3b_environment, CL_3b_halo, CL_3b_lissajous, CL_3b_manifold: improved and simpler code 
  (numerical results are slightly different from previous version)
- CL_cor2cov, CL_cov2cor: code has been improved
- CL_co_car2ell, CL_co_ell2car: improved %nan processing (for vectors and jacobian matrix)  
- CL_kp_E2M, CL_kp_E2v, CL_kp_M2E, CL_kp_M2v, CL_kp_v2E, CL_kp_v2M: %nan is now returned if eccentricity is 1 
- CL_cw_lambert: "acc" input parameter is now vectorized
- CL_ex_propagate, CL_ex_meanElem : extended to all types of orbital elements
- CL_ex_propagate : "J2sec" model improved (no conversion between orbital elements takes place)
- CL_ex_kepler, CL_ex_secularJ2 : transition matrix is now optionally computed 
- CL_dot, CL_cross, CL_dMult : extended : now work for matrices and hypermatrices
- CL_sphHarmVal, CL_sphHarmAcc: vectorization extended to a few arguments
- CL_g_legend: adapted so that it work with any Scilab version 
- CL_stat: "mvvacov" replaced by "cov"
- CL_intervUnion: algorithms has been simplified
- CL_sortMat : interface simplified for a simple sort (vector) 
- CL_covDraw is now in the "math" section
- CL_locationInfo is now in the "models" section


-------------
New functions
-------------
Math: 
CL_detectZero, CL_detectSign
CL_intervLinspace, CL_intervSelectIn
CL_lagrangeFitPoly

Orbit properties: 
CL_kp_anomConvert, CL_kp_anomConvertCir
CL_op_orbGapLof, CL_op_orbGapLofMat
CL_op_latSwath

Trajectory and maneuvers: 
CL_man_dvIncSma, CL_man_dvSmaT, CL_man_dvSmaEccv
CL_stela_extrap, CL_stela_deriv, CL_stela_params, CL_stela_convert, CL_stela_getConst
CL_stela_area, CL_stela_objLoad 
CL_tle_evalAvgElem, CL_tle_format, CL_tle_genEphem, CL_tle_getBalCoef, CL_tle_getConst, CL_tle_getElem, 
CL_tle_load, CL_tle_new, CL_tle_parse, CL_tle_set, CL_tle_setElem, CL_tle_update

Geometry and events: 
CL_ev_eclipse, CL_ev_stationVisibility 
CL_gm_intersectCoplanOrb

Interplanetary: 
CL_ip_flybyParams, CL_ip_flybyVectors
CL_3b_manifold (replaces CL_3b_manifolds) 

Coordinates and frames: 
CL_rot_contQuat

Models: 
CL_fo_solidTidesAcc, CL_fo_solidTidesPot, CL_fo_albedoAcc

Utilities: 
CL_isAlmostEqual
CL_plot_swath


---------
New demos
---------
Calendar_of_Moon_phases
Celestial_body_observation_planner
Compensation_of_atmospheric_drag
Deorbit_cost_-_circular_1
Deorbit_cost_-_circular_2
Deorbit_cost_-_elliptical
Drifts_due_to_J2_-_RAAN_or_MLTAN
Eclipse_duration_-_evolution_over_time
Eclipses_of_Sun_and_Moon
Gravity_effects_on_GEO
Ground_station_pointing_error
Interplanetary_transfers_-_Tisserand_graph
Intersection_of_coplanar_orbits
Plot_trajectory (TLE)
Prediction_of_visible_passes (TLE)
Restricted_3-body_problem
Solar_array_efficiency
Solar_array_efficiency_2
Solar_array_efficiency_function_of_time
Space_time_coverage
Swing-by_-_generic
Swing-by_-_planetary


--------------------
Data / configuration 
--------------------
- Explicit values for the WGS84 ellipsoid have been added to "physical_data.scd"
- EIGEN-GL04s potential data added (file: "eigen_gl04s.scd"). It is not explicitly used in CelestLab. 
- Albedo and Love coefficients: added in "physical_data.scd"
- Three body problem related data: added to "solar_system_data.scd"
- Configuration file extended (configuration parameters for STELA or TLEs) 
- Configuration parameter names are now uppercase, but backward compatibility is assured. 


-------------
Documentation
-------------
- The documentation of CelestLab has been updated with new contents: 
  STELA, Two Line Elements, Jacobian matrices...
- New cookbook sections have been added: Interplanetary cruise, Jacobian and covariance matrices
- Orbital elements section has been extended
- New topics added in the Flight Dynamics Conventions section: Frames, Jacobian matrices, Units... 


--------------------
Deprecated functions
--------------------
CL_3b_manifolds => use CL_3b_manifold
CL_ev_visibilityEph, CL_ev_visibilityExtr => use CL_ev_stationVisibility (more powerful)
CL_gm_sphericDist => use CL_co_sph2car + CL_vectAngle
CL_kp_M2Ecir => use CL_kp_anomConvertCir
CL_dsp_covCoord, CL_dsp_kepCovPropa => use CL_ex_kepler (transition matrix) + orbital elements conversions


-----------------
Removed functions
-----------------
CL_oe_*** ("***" including "equin" or "cireq") => use CL_oe_convert instead. 



====================================
Version 3.0.0 - March 27, 2013			  
====================================

Overview of CelestLab 3.0.0
---------------------------
This version includes major improvements and a few changes. 
It is therefore not fully compatible with CelestLab 2.4.2, but only little changes
are necessary to make old scripts work. 


Among the new features: 
- Many new reference frames (IERS 2010 conventions)
- New models for the ephemerides of solar system main bodies (MEEUS, VSOP87, ELP, DE405)
- Force + potential functions including for the full gravity model up to degree/order 70 
  (potential defined by spherical harmonics)
- Extended definition of orbital elements (now 2 new types for equinoctial elements)
- IAU planetary angles (orientation of equator and prime meridian)
- New propagation model based on Lyddane (mean elements include secular and long period perturbation effects)
- Many new utility functions: Gauss for all orbital element types, conversion of time scales, etc... 
- Magnetic field added (IGRF model).. 

Changes regarding predefined data: 
- No local variables are now created by default (except one for internal use). 
The function CL_init is still available, but it now only creates a limited set of variables. 
Internal data may be retrieved by a new function: CL_dataGet. 
There have been some changes to improve consistency and simplicity: some redundant variables have been 
removed (e.g. %CL_j2, ...) or renamed (e.g. %CL_muSun is replaced by: %CL_body.Sun.mu). 
- Some data have been updated. Gravity data (zonal terms) are now those from EGM96s gravity model. 
The default oblateness value is consistent with WGS84. 

- All date/time function arguments are now relative to a specific time scale called "TREF". 
Two new reference frames adapted to mission analysis are defined: "ECI" (nearly inertial frame) 
and "ECF" (rotating frame).  
 
- Documentation has been extended with new pages describing various topics (ephemerides, forces...). 
It also includes a section named "cookbook" where various complete examples are given. 

- Configuration features have been added for high level properties. 

- CelestLab v3.0.0 can be used with Scilab version 5.3.0 or higher. 


Summary of data changes versus 2.4.2
------------------------------------
Note that as of v3.0.0, the variables %CL_xxx must be created explicitly by CL_init(). 

1) No change: 
%CL_au, %CL_deg2rad, %CL_eqRad, %CL_j1jn, %CL_mu, %CL_obla, %CL_rad2deg

2) New Names:
%CL_rotrEarth => %CL_rotrBody
%CL_rotrEarthSun => %CL_rotrBodySun
%CL_planetC => %CL_body

3) New ways to access data:
%CL_muMoon => %CL_body.Moon.mu
%CL_muSun => %CL_body.Sun.mu
%CL_radiusMoon => %CL_body.Moon.eqRad
%CL_radiusSun => %CL_body.Sun.eqRad
%CL_earthRadius => %CL_body.Earth.eqRad

4) Removed variables because of multiple definitions:
%CL_j2, %CL_j3, ... %CL_j6
=> Now use: %CL_j1jn(2), %CL_j1jn(3), ...

5) No explicit creation: 
%CL_g0, %CL_gravCst, %CL_lightSpeed, %CL_criticalInc1, %CL_criticalInc2
=> Now Use: CL_dataGet("g0"), CL_dataGet("gravCst") ...

6) No explicit creation / new names 
%CL_TAI_UTC, %CL_epsilon
=> Now Use: CL_dataGet("%CL_TAI_UTC_DATA"), CL_dataGet("epsOrb")
(accessing these data should not be necessary)

7) Removed data 
%CL_obliquity2000
=> No equivalent data in V3.0.0 


***********************************************************************************
Detailed changelog:
***********************************************************************************

New functions
-------------
- Frame conversion functions compliant with IERS2010 conventions: 
  CL_fr_convert, CL_fr_convertMat, CL_mod_siderealTime
- Utility functions to simplify frame conversions :
  CL_rot_pvConvert, CL_rot_pvJacobian, CL_rot_compose
- Models for ephemerides computation:
  CL_eph_moon, CL_eph_sun, CL_eph_planet, CL_eph_de405
- Forces and potential: CL_fo_xxx
- Magnetic field: CL_mod_geomagField
- Gauss equations: CL_op_gauss
- Solar system bodies frames (IAU2009):
  CL_mod_IAUBodyAngles, CL_fr_bodyConvert, CL_fr_bodyConvertMat
- New orbital elements: "equin", "cireq", "pv"
  CL_oe_equin2car, CL_oe_car2equin, CL_oe_equin2kep, CL_oe_kep2equin 
  CL_oe_cireq2car, CL_oe_car2cireq, CL_oe_cireq2kep, CL_oe_kep2cireq
- Generic function to convert orbital elements: CL_oe_convert
- New analytical propagation model: CL_ex_lyddaneLp , CL_ex_meanLyddaneLp
  (the mean elements for this model include secular and long period effects.)
- Generic function for analytical propagation: CL_ex_propagate / CL_ex_meanElem
- New time scales: CL_dat_tcb2tdb, CL_dat_tdb2tcb
- Generic function to convert dates and time scales: CL_dat_convert, CL_dat_scaleConvert
- Interpolation in quaternions: CL_rot_interpQuat
- Visibility: CL_gm_stationVisiLocus, CL_gm_stationPointing
- Relative motion: CL_cw_propagate, CL_cw_propagateMan, CL_cw_lambert
- Mathematical functions: 
  CL_chebyshevEval, CL_chebyshevPoly, CL_legendrePoly, CL_quantile,
  CL_sphHarmVal, CL_sphHarmGrad, CL_fsolveb,
  CL_unMod, CL_mean, CL_interpLin
- Utility functions: 
  CL_version, CL_dataGet, CL_configGet, CL_configSet,
  CL_hms2sec, CL_sec2hms, CL_deg2sdms, CL_sdms2deg,
  CL_dat_cal2str, CL_dat_str2cal, CL_dat_now, CL_sortMat,
  CL_getEarthMap
- CL_ev_visibilityExtr in replacement of CL_ev_visibility
- CL_op_locTime in replacement of CL_op_locTimeG50
- CL_rot_angVelocity in replacement of CL_rot_angularVelocity
- Convenience function: CL_mod_atmUS76Density


Improved/changed functions
--------------------------
- CL_rot_quat2axAng: The returned angle is now in [-pi, pi]. (previously in [0,2pi])
- CL_rot_quat2matrix, CL_rot_matrix2quat: Addition argument: derivative of quaternion
- CL_inputParam, CL_defParam:  New types of input accepted: string and calendar format
- CL_unitConvert: 3 calling sequences are now accepted.     
  If units do not exist, the function returns an error (used to return [])
- CL_dat_cal2cjd: Input arguments year month day hour minute second can now be row vectors or scalar.
- CL_gm_eclipse: The argument of latitude (aol) of the end of eclipse is now always superior to 
  the aol of the beginning of eclipse.
- CL_kp_M2E: New algorithm. Faster and works better for eccentricities close to 1.
  New function is usable for any eccentricity except exactly 1.
- CL_kp_M2Ecir: Use CL_kp_M2E internally. New function is now usable for any eccentricity below 1.  
- Functions CL_oe_xxx: All functions have been recoded. Not computable terms are set to %nan (an error was returned previously)
- CL_co_car2sph, CL_co_sph2car: Argument vel_sph renamed in pos_sph_dot.
  New calling sequences available (to retrieve a 3x3 jacobian for example)
- CL_oe_car2kep, CL_oe_kep2car: Parabolic orbits not handled anymore.
  Reason: The first parameter of parabolic orbits is the semi-lactus rectum p, not the semi-major axis.
- Optional argument "zonals" has been renamed to "j1jn". Impacted functions:
  CL_op_frozenOrbit, CL_op_frozenOrbitDer, CL_ex_eckHech, CL_ex_eckHechInfos, CL_ex_meanEckHech,
  CL_ex_lyddane, CL_ex_lyddaneInfos, CL_ex_lyddaneMan, CL_ex_meanLyddane
- CL_graduate: Better results
- CL_integrate: New (more precise) methods added
- CL_interpLagrange: Additional output argument returned (values of interpolating polynomials derivatives)
- CL_lambert: Algorithm is now faster and more robust. 
- CL_path: The function can now search for files recursively in sub-directories 


New demos
---------
- Frame conversion utility
- Geoid
- Solar system 1
- Solar system 2
- Geomagnetic field


Miscellaneous
-------------
- New functionnality: CelestLab configuration (preferences).
- The CelestLab menu has been extended. 
  - New item: "Edit configuration file":
    It is now possible to edit the configuration file. 
    The structure of the configuration file has also been modified. 
  - New item: "About CelesLab"
- A CelestLab banner is displayed when CelestLab is loaded.



Bugs fixed  
----------
- CL_kp_M2E: A bug could happen when input arguments were matrices (PxN)
- CL_mod_polarMotionMatrix: the returned matrix was incorrect (wrong order for xp,yp).
- CL_ex_meanEckHech: sometimes, there was no convergence if initial argument of latitude
         was not in [0, 2*pi].
- CL_co_car2sph: problem in the vectorisation of the computation of the jacobian (/ instead of ./)
- CL_ex_lyddane: Small correction of the effect of J5 (model for the osculating elements)
- CL_ex_lyddane: Correction of a vectorization error. 


Data
----
- The way data are handled in CelestLab has been modified:
  CL_init() is now mandatory in order to create variables (%CL_xxx) in the local environment. 
  (only 13 most commonly used "constants" are loaded)
- The rest of the data is available via the function CL_dataGet. 
  Example: muSun = CL_dataGet("body.Sun.mu")
- The directories containing data has been reorganized. (new sub-directories created)
- %CL_TAI_UTC renamed to %CL_TAI_UTC_DATA
- New time data: %CL_TAI_UTC, %CL_TT_TAI, %CL_TT_REF, %CL_UT1_TREF
- New solar radiation pressure data: %CL_totalSolarIrradiance
- Some values have been upgraded to be consitent with IAU2009 standards :
  gravitation constants of planetes+satellites (barycentre), %CL_au, %CL_gravCst
- New gravity model data: EGM96s (70x70)
- %CL_j1jn updated to EGM96s values
- %CL_j2 removed. %CL_j1jn(2) should be used instead. 
- Same for: %CL_j3, %CL_j4, %CL_j5, %CL_j6. 
- %CL_obliquity2000 removed. 
- %CL_rotrEarth and %CL_rotrEarthSun renamed into %CL_rotrBody and %CL_rotrBodySun
- %CL_rotrBody and %CL_rotrBodySun depend on the configuration setting (preferences)
  (different values if ECI=Veis or ECI=CIRS)
- %CL_planetC replaced by %CL_body
- %CL_muSun, %CL_radiusSun, %CL_muMoon, %CL_radiusMoon removed, use %CL_body.<body>.<var>.


Documentation
-------------
- The documentation of CelestLab ("Introduction" section) has been updated with lots of new 
  contents: Flight dynamics details, cookbook, etc...


Deprecated functions 
--------------------
Many deprecated functions. 
Functions become deprecated because they can be replaced by new ones, or sometimes because
they are considered as badly designed and/or not very useful. 
The deprecated functions can still be used, but be aware that they will be removed one day. 
The whole list is: 
- CL_rot_angularVelocity (use CL_rot_angVelocity)
- CL_dat_cal2jd, CL_dat_cjd2jd, CL_dat_cjd2mjd, CL_dat_jd2cal
  CL_dat_jd2cjd, CL_dat_mjd2cjd (use CL_dat_convert)
- CL_fr_G502J2000, CL_fr_G502J2000Mat, CL_fr_G502ter, CL_fr_G502terMat
  CL_fr_H0n2J2000Mat, CL_fr_J20002G50, CL_fr_J20002ter, CL_fr_ter2G50
  CL_fr_ter2J2000, CL_fr_ter2J2000Mat (use CL_fr_convert) 
- CL_oe_car2cirEqua, CL_oe_cirEqua2car, CL_oe_cirEqua2kep, CL_oe_kep2cirEqua 
  (use new orbital elements "cireq" or "equin")
- CL_mod_equinoxesEquation, CL_mod_meanObliquity, CL_mod_nutationAngles
  CL_mod_nutationArg, CL_mod_nutationMatrix, CL_mod_polarMotionMatrix
  CL_mod_precessionAngles, CL_mod_precessionMatrix, CL_mod_sidTime, 
  CL_mod_sidTimeG50
- CL_ev_visibility (use CL_ev_visibilityExtr)
- CL_gm_stationElevation (use CL_gm_stationPointing)
- CL_op_locTimeG50 (use CL_op_locTime)
- CL_mod_moonSunG50, CL_mod_planetsG50ecl 
  (use CL_eph_moon, CL_eph_sun, CL_eph_planet or CL_eph_de405)
- CL_mod_expDensity, CL_mod_expDensityDrag, CL_cw_diffDrag
- CL_fr_ter2topoN et CL_fr_topoN2ter
- CL_matSort (use CL_sortMat)
- CL_cw_twoImpulse (use CL_cw_lambert), CL_cw_impulPropa, CL_cw_contPropa, 
  CL_cw_ballisticPropa (use CL_cw_propagate)

  
====================================
Version 2.4.2 - July 27, 2012			  
====================================
- One bug fixed in CL_rot_quat2axAng (which sometimes returned a wrong rotation angle). 
- One new demo (in the "relative motion" section). 
- Improvement/adaptation of the functions: CL_rot_quat2axAng, CL_rot_axAng2quat, CL_rot_quatSlerp. 
- The CelestLab menu has been extended. 


Bugs fixed  
----------
- CL_rot_quat2axAng: the rotation angle was sometimes incorrect (for angles > 180 deg). 

Improved/changed functions
--------------------------
- CL_rot_quat2axAng, CL_rot_axAng2quat: 
  The convention for undefined axes (identity quaternion) has changed: 
  instead of returning [%nan;%nan;%nan] CL_rot_quat2axAng now returns [0;0;0]. 
  This is more consistent with the way %nan is handled in CelestLab, and also 
  with CL_rot_axAng2quat which accepted [0;0;0] as input in practice. 
  The rotation angle returned by CL_rot_quat2axAng is now in [0, pi]. 

- CL_rot_quatSlerp: code has been simplified. 
  
New demos
---------
- Enforced linear relative motion

Miscellaneous
-------------
- The CelestLab menu has been extended. It is now possible to edit the data files
that contain the values of CelestLab predefined variables. 



====================================
Version 2.4.1 - July 20, 2012			  
====================================
- A few minor changes, mostly the update of the detailed changelog 
  that was not exact. 
- 2 new demos (relative motion and Hohmann <-> continuous thrust)
- Improvement of the functions: CL_cw_Mmatrix and CL_cw_Nmatrix


Improved functions
------------------
- CL_cw_Mmatrix, CL_cw_Nmatrix 

New demos
---------
- Continuous versus Hohmann
- Keplerian relative motion



====================================
Version 2.4.0 - July 10, 2012			  
====================================
This version is a "minor" version that includes a few improvements.  
The main features (in comparison with 2.3.0) are: 
- 11 new functions:
- 7 new demos
- A few bugs fixed
- A total of 16 functions are now deprecated.  


New functions
-------------
- New maneuver functions (old maneuver functions are now deprecated)
  CL_man_applyDvKep, CL_man_dvApsidesLine, CL_man_dvBiElliptic, CL_man_dvHohmann, 
  CL_man_dvHohmannG, CL_man_dvIncRaanCirc, CL_man_dvInc, CL_man_dvSma
  => deltav (sum of  norms) is now always returned as 1st argument
  => velocity increments are in cartesian coordinates
- CL_gm_orbSphTriangle
- CL_op_equatorialSwath
- CL_integrate
- CL_home (see below)

Improved functions
------------------
- CL_rot_angles2quat, CL_rot_angles2matrix: now accepts an unlimited number of
  successive rotations (previously limited to 1,2 or 3 rotations)
- CL_plot_earthMap, CL_locationInfo: data is now stored in a binary files
 (previously stored as ASCII files). 
  The loading time is shorter and files are smaller.
- CL_unitConvert: addition of 3 news units : arcmin, arcsec, mas (=milli arcsec)
- CL_dat_utc2tai, CL_dat_tai2utc: Code rewritten. It is now more rigourous and
  faster. 
- CL_rot_angles2quat, CL_rot_axAng2quat, CL_rot_matrix2quat: empty input
  arguments are now correctly handled.
- CL_g_stdaxes: The size of the font is now proportional to the size of the
  figure by default.
- Overloading of quaternions: Implicit size operator (ex: 2:$) is now handled.
- The code of a few functions has been simplified and improved (CL_kp_xxx, 
  CL_ip_xxx, CL_op_raan2beta,...). 
- CL_op_raan2beta, CL_op_beta2raan: in some cases %nan is now returned (before:
  an error was raised).    

Bugs fixed  
----------
- CL_rot_angularVelocity: Depending on the rotation sequence, the angular
  velocity vector could be incorrect.
  The convention for the angular velocity vector returned is now clearly
  documented.
- CL_fr_J20002ter,CL_fr_ter2J2000: The velocity and jacobian computation was 
  not correct (due to the bug above). The effects were small in practice 
  (effect of precession and nutation on velocity). 
- CL_man_hohmannG: The tue anomaly of the first maneuver was sometimes erroneous.
- CL_man_inclination: The computed DV with option=0 was not always the optimal DV.
- CL_man_lambert: If the case positions are aligned, the function now returns %nan
  (before, there was a "division by zero"). 
- CL_ex_lyddaneInfos: Optional arguments were not taken into account.

Interface changes
-----------------
- CL_fr_ter2topoN,CL_fr_topoN2ter: argument "obl" replaced by "obla". but obl
  is still possible. 
- The argument "conv" in a few frame conversion functions has been replaced by
 "conv_iers", because
  conv is a reserved keywork in scilab 5.4. But this has little impact as only
  one option is possible in practice. 

Data
----
- Most recent leap second added in TAI_UTC.scd file. From July 1st 2012, 0h:
  TAI-UTC = 35 seconds. 
  NB: Two functions (CL_dat_utc2tai and CL_dat_tai2utc) use these data. See also
  CL_init(). 
  
New demos
---------
- Sun elevation on Earth
- Satellite local time
- Solar zenith angle 1
- Solar zenith angle 2
- Cost of inclination change - circular
- Cost of inclination change - elliptical 1
- Cost of inclination change - elliptical 2

Documentation
-------------
- Some functions from the "Utilities" folder have been moved to a new folder: 
  "Math". 
- The CelestLab overview help page now contains links to external pages about 
  CelestLab. 

Deprecated functions 
(will generate a warning message in CelestLab v3.x,
 and will be permanently deleted in CelestLab v4.0)
--------------------
- CL_man_applyDv, CL_man_apsidesLine, CL_man_biElliptic, CL_man_hohmann, 
  CL_man_hohmannG, CL_man_incRaanCirc, CL_man_inclination, CL_man_sma
  (use new maneuver functions instead)
- CL_gm_lat2loctime, CL_gm_locSolTime (use CL_gm_orbSphTriangle instead)
- CL_gm_equatorialSwath, CL_gm_equatorialOverlap (use CL_op_equatorialSwath
  instead)
- CL_colNorm, CL_colMult (use CL_norm and CL_dMult instead)
- CL_rot_eul2quat, CL_rot_quat2eul (use CL_rot_angles2quat and CL_rot_quat2angles
  instead)

Internals
---------
- All the internal global variables have been replaced by one unique variable
  (structure): %CL__PRIV. 
  NB: %CL__PRIV is a "private" variable, supposed to be accessed by CelestLab
  functions only. 
- The variable %CL_home has been removed. It has been replaced by a new function:
  CL_home(). 



====================================
Version 2.3.0 - January 31, 2012			  
====================================
- 10 new functions: 
- A few bug fixed (one major in CL_fr_locOrbMat) 
- A few functions improved 


New functions
-------------
- CL_gm_inters3dLineEllips, CL_gm_inters3dConeSa.
- CL_op_shortPeriodsJ2Circ.
- CL_ex_eckHechInfos, CL_ex_lyddaneInfos.
- CL_oe_cir2kep, CL_oe_kep2cir.
- CL_interpLagrange, CL_ev_visibilityEph.
- CL_intervDiff.
 
 
Improved functions
------------------
- CL_rot_quat2axAng: now has a better accuracy for quaternions almost equal to identity.
- CL_matSort: now accepts [] as input argument.
- CL_intervUnion: intervals of zero length are now deleted.
- CL_ex_eckHech: initial version did not allow for perfectly frozen orbits.
                 (oscillation of second order of magnitude of 4.e-7 on mean ex)
                 A correction of 4.e-7 on mean ex has been applied. 
				 Note that the present version is not the "standard" version. 
- Quaternions: q*a and q/a  now work if: 
                1) a = scalar and dim(q) = whatever
                2) a = row vector and dim(q) = 1
- CL_op_frozenOrbitDer : now returns %nan for dpom/dt if the result is undefined (ecc = 0 or inc = 0 or pi)
- CL_g_legend : now has a similar interface as scilab function "legend" (1st argument = axes or array of handles)
- CL_g_select : now accept an arry of handles as first argument
- CL_plot_earthMap, CL_plot_ephem: now more efficient (only one call to "plot")
- Help pages about orbital elements and description of jacobians improved.


Bugs fixed  
----------
- CL_fr_locOrbMat: The matrix was not always correct.  
- CL_rot_matrix2quat: conversion of a matrix close to identity could sometimes fail.
- CL_gm_stationElevation: numerical accuracy improved.
- CL_intervInters: code simplified and now safer. 
- CL_intervInv: Documentation updated (it was not correct). The function now doesn't return intervals of zero length or outside range.
- CL_g_tag, CL_g_select: now works with more types of objects, including uimenu.
- CL_oe_car2kep: Correction in the case of a zero inclination (elliptical orbits). The right ascension of the ascending node was incorrectly initialized. Now it is set to 0. 
- Compilation of the help files was failing on Linux (case sensitivity). 



====================================
Version 2.2.0 - July 27, 2011
====================================
- 9 new functions: 
- 7 new demos
- Several functions improved (performance, simplicity of code)
- A few bugs fixed
- 2 deprecated functions


New functions
-------------
- CL_gm_reflectionPtSph, CL_gm_eclipse, CL_gm_eclipseCheck.
- CL_rot_angles2quat, CL_rot_matrix2angles, CL_rot_quat2angles, CL_rot_defRot1ax, CL_rot_defRot2ax.
- CL_locationInfo.
 
 
Improved functions
------------------
- CL_op_frozenOrbit: algorithm simplified and performance improved.
- Quaternions: rewrite of all overloading functions. Operations : q1 <op> q2, with 
  op = +, -, *, /, etc... work even if the arguments don't have the same size 
  (i.e. one of the argument has size 1). Nearly all operations work with empty 
  quaternions.  
- CL_plot_earthMap: addition of a higher resolution map, and possibility to use elliptical or spherical coordinates.
- CL_gm_betaEclipse: now handles elliptical orbits.
- CL_rot_defRotVec: algorithm simplified and performance improved.
- CL_rot_defFrameVec: can now return a matrix or a quaternion.
  Warning: CL_rot_defFrameVec(u, n1) is now forbidden. Use CL_rot_defFrameVec(u,u,n1,n1) instead.
- CL_3b_environment: added Sun-Jupiter.
- CL_op_rarp2ae, CL_op_rpvp2ae, CL_op_rava2ae, CL_op_rpvinf2ae: better arguments handling
  

New demos
-------------
- Sun and Moon Directions.
- Moon phases.
- Cost of RAAN drift rate change.
- Sun glint.
- Drifts due to J2.
- Image of vector by 2 rotations.
- Cost of perigee/apogee altitude change.


Bugs fixed  
----------
- CL_op_repeat2smaInc: function could sometimes return an error (instead of %nan) when there was no solution.
- CL_rot_quat2eul, CL_rot_eul2quat: erroneous results (fixed). These functions are now deprecated. Use CL_rot_quat2angles, CL_rot_angles2quat.
- CL_op_frozenOrbitDer: erroneous results (fixed).
- CL_rot_angularVelocity: a bug could occur if the user had modified the format.
- CL_op_frozenOrbit: eccentricity could be negative in some cases.


Deprecated functions 
--------------------
- CL_rot_quat2eul
- CL_rot_eul2quat



====================================
Version 2.1.1 - January 6, 2011				  
====================================
- Correction of 2 demos
- 1 (minor) bug fixed

Changes
-------
- Corrections of 2 demos (Ground_stations_visibility.sce and Repeating_ground_tracks_2.sce)
  that did not work when CelestLab was loaded via ATOMS 
  (some CelestLab data were not initialized) 
- Minor bug fixed in CL_op_repeat2smaInc: test on eccentricity did not assume vectors



====================================
Version 2.1.0 - December 22, 2010
====================================
Changes:
- 4 New functions
- A few bugs fixed
- Several functions improved (performance, simplicity of code)
- Celestlab predefined data are now loaded from files (see CL_init) 


New functions
-------------
- CL_path
- CL_dMult (CL_colMult is now deprecated, use CL_dMult)
- CL_rot_defRotVec
- CL_rot_defFrameVec


Functions improved 
------------------
- CL_ex_meanEckHeck, CL_ex_meanLyddane: simplified code, improved accuracy.
- CL_ex_lyddane, CL_ex_eckHech, CL_ex_secularJ2: output angles are now "continuous" (no modulo 2*%pi anymore).
- CL_init : now uses external files found in <CelestLab installation Directory>/data/utils. 
  It is now easier for users to see and redefine constants, update TUC-TAI...
- Demo "Repeating ground tracks 2": option for sun-synchronous orbits.
- Demo "exponential density" and "US76 density": improved.
- CL_vectAngle: now uses asin (with cross product) when vectors are almost aligned. Improves accuracy.
- CL_dot, CL_vectAngle: now handle cases where the input arguments are (3xN) and (3x1).
- Overloading of hypermatrices (%hm_*): simpler code and improved performance.
- CL_fr_ter2topoN, CL_fr_topoN2ter: simpler code. Now handle cases where one input is (3xN) 
  and the other input is (3x1). If position or velocity are not provided, corresponding outputs are now [].
- CL_rot_axAng2quat: If the angle is 0 and the axis is %nan, the output quaternion is identity (instead of %nan).
  If the angle is not 0 and the axis is %nan: the output quaternion is %nan.
- CL_mod_US76: small correction of code and efficiency significantly improved.
- CL_fr_*, CL_oe_*: performance of jacobian calculation significantly improved.    
         

Bugs fixed  
----------
- Demos Halo manifold and Halo orbits: option for prograde and retrogade are now 1 and 0 respectively 
 (instead of 2 and 1)
- CL_op_locTimeG50: "tlt" and "mlt" replaced by "tsa" and "msa" (but still recognized for compatibility)
- CL_vectAngle, CL_stumpC, CL_stumpS: did not properly propagate %nan 
- CL_mod_moonSunG50 : did not properly handle the argument names "moon" and "sun"
- CL_fr_ter2G50, CL_fr_ter2G50: there was a problem when velocity was not provided
- CL_ex_lyddaneMan: an output date was incorrectly set to 0
- CL_ex_lyddane: when using this function with vectors and e > 0.05, the output semi-major axis 
  was incorrect (error ~20m)
- CL_colMult, CL_cross: did not correctly handle []
- CL_op_driftJ2: dM/de was incorrect 
- CL_mod_expDensity: percentile 33 gave incorrect results
- CL_op_rarp2ae: mu removed from inputs because it is not used in this function
- CL_ev_visibility: fixed example. Problem when dealing with long simulation and/or small time steps.  
- CL_rot_quat2eul: problem that gave incorrect results for angles > %pi
- CL_plot_*: used to set immediate_drawing to "on" thus erasing user's preference.
- CL_fr_topoNMat: documentation about input arguments
- CL_gm_eclipseCir: sizes of input arguments were not correctly tested



==================================
Version 2.0.1 - June 3, 2010				  
==================================
- Handling of global variables in CelestLab. 
  You can now set for example %CL_mu=3.8e14 in the console and that variable 
  will be used consistently throughout CelestLab, 
  whereas you used to have to modify the global variable to do that.
- Several bugs fixed
- New demo : Visibility / Accessibility at equator


- CL_ev_visibility : Bug fixed. Now returns [] when no visibility is found. 
- CL_ev_visibility : Keplerian propagation added : 'kep', in order for this function to be useable for hyperbolic orbits.
- CL_oe_car2kep and CL_oe_kep2car : Improvements to code in order to correctly handle low eccentricities and low inclinations. In particular the accuracy has improved for low eccentricity orbits. 
- CL_man_lambert : Perfomance dramatically improved. (~40 times faster)
- CL_stumpC : CL_stumpC(0) now correctly returns 1/2.
- New demos : demos/Visibility/Accessibility_at_equator.sce
- CL_ex_lydanne, CL_kp_M2E and CL_kp_M2Ecir : Now use less memory.



==================================
Version 2.0.0 - March 22, 2010
==================================
NB: Some interfaces have been improved. Therefore, this version is not fully 
compatible with the previous one.
Changes:
- A few anomalies corrected
- Several functions added
- Several new demos (with enhancements)
- Various improvements to documentation
- Improved error handling in several functions
- Improved performance and code of several functions simplified 
- A few functions removed (should be replaced by new improved functions in the future) 
- A few functions/constants/arguments renamed (for library consistency)
- Some interfaces modified


Removed functions 
-----------------
- Events functions (CL_ev_xxx) removed. They will be replaced by new functions in the next version.
- CL_gm_sunZenithAngle removed. Might be replaced by a new function in the next version.
- CL_fr_teme2J2000Mat removed.


New functions 
-------------
- CL_ip_sphereInfluence
- CL_ip_escapeDv
- CL_ip_insertionDv
- CL_fr_locOrbMat
- CL_rot_quat2axAng
- Graphic functions : CL_g_xxx
- CL_graduate
- CL_autoLevels
- CL_defParam
- CL_inputParam
- CL_unitConvert
- CL_norm


Renamed functions/constants/arguments 
-------------------------------------
- CL_op_locTime --> CL_op_locTimeG50 because the frame is necessarily Gamma50 (Veis)
- %CL_omSun --> %CL_rotrEarthSun
- Pluton --> Pluto
- %CL_planetC.xxx.R --> %CL_planetC.xxx.eqRad
- %CL_planetC.xxx now contain an extra field : mu
- %CL_planetC.earth characteristics are now equal to %CL_eqRad, %CL_mu and %CL_obla.
- %CL_UA --> %CL_au
- Optional arguments : om_earth --> rotr_pla and om_sun --> rotr_pla_sun
- CL_man_lambert : R1, R2 --> pos1, pos2 ; sense --> direction ; dt --> delta_t
- CL_dsp_covCoord : means1,means2 --> param1,param2 and coord --> conv1to2
- CL_M2Egene --> CL_M2Ecir
- CL_co_car2ell and CL_co_ell2car : obl --> obla
- CL_colGcd --> CL_gcd
- CL_gm_visibility --> CL_ev_visibility


Modified outputs 
----------------
- CL_gm_stationElevation : result is now NxM instead of MxN
- CL_gm_sphericDist : result is now the angle instead of the distance
- CL_kp_characteristics : result is now a structure (instead of a tlist). 
                          Some fields names have changed but old names are still recognized.
- CL_ex_kepler : Date is not in the output anymore.
                 Mean anomaly is not between 0 and 2*%pi anymore (no modulo). 
- CL_rot_rotVect : The output vector is now the rotated vector (and not the coordinates
                 of the same vector in the rotated frame). 
- CL_3b_halo and CL_3b_lissajous : Date is not in the output anymore.


Reworked interface 
------------------
- CL_dsp_kepCovPropa (See documentation for details)
- CL_gm_eclipseCir (See documentation for details)
- CL_op_loctimeG50 and CL_gm_visiParams : can now have several outputs, "all" returns a structure.
- CL_3b_manifold: Dates of the Halo or Lissajous orbit now have to be given as inputs.


Improved functions 
------------------
- CL_plot_ephem and CL_plot_earthMap : better handling of view area. Additional optional arguments
- CL_dat_xxx : rewritten algorithms. These functions are now valid for ... 
- CL_gm_stationElevation : improved performance.
- CL_op_M2E and CL_op_M2Egene (now renamed CL_M2Ecir) : rewritten algorithms. Faster convergence.
- CL_colMult,CL_colNorm,CL_unitVector and CL_vectAngle : improved performance.
- CL_ex_lyddaneMan : Simplified algorithm


Bugs fixed  
----------
- %CL_TAI_TUC was not up to date
- bug in CL_mod_nutationMatrix
- Intervals functions (CL_interv xxx) now correctly handle empty arrays []
- CL_rMod now correctly handles empty arrays []
- CL_op_searchRepeatOrbits and CL_op_repeat2smaInc : improved convergence (it could cause bugs)
- Functions CL_dat_xxx : correction of bugs 
- CL_rot_quatSlerp : was not valid for vectors
- CL_M2E and CL_M2Egene : didnt work in some cases.
- bug in CL_plot_ephem
- CL_fr_G502J2000, CL_fr_G502ter and all the combinations : correction of bugs when using optionnal arguments.
- Removed useless optional arguments ut1,xp,yp from CL_fr_G502J2000, CL_fr_G502J2000Mat, CL_fr_J2000G50
- CL_man_incRaanCirc : didnt work for vectors
- bug in CL_man_biElliptic



==================================
Version 1.0.1 - December 18, 2009				  
==================================
Changes:
- Improvement of demos
- Correction of CL_gm_equatorialOverlap.sci
- Correction of CL_gm_equatorialSwath.sci
 (vectors [1,n] instead of [n,1])
- About page (explanations on constants)
	
  

==================================
Version 1.0.0 - December 17, 2009				  
==================================
First version. 



