European Space Agency

Royal Belgian Institute for Aeronomy

uxidl - Interface to IDL (UNIX)

subroutine  uxidl()

status = CALL_EXTERNAL( Image, 'uxidl_', Entry [, P1, ..., Pn] )

Description

The routine uxidl() provides an interface between the primary UNILIB routines and IDL (Interactive Data Language) for Unix systems on which the CALL_EXTERNAL function is supported. This function is only available in IDL on systems supporting dynamic linking. The routine uxidl() provides a C (argc, argv) calling convention for routines of the library, the list of which is given in the table below.

• ul220 - get information on a magnetic field line segment

• ud310 - trace a magnetic drift shell

• ud315 - search the mirror point with the lowest altitude

• ud317 - trace a magnetic drift shell

• ud330 - evaluate the third invariant

• uf410 - search the geographic position of a magnetic field line

• uf420 - trace a magnetic field line segment passing through a given position

• um510 - select an internal field model

• um520 - select an external magnetic field model

• um530 - evaluate the magnetic field vector

• um535 - geocentric to geodetic transformation

• um536 - geodetic to geocentric transformation

• um539 - evaluate the magnetic field

• ut540 - compute modified Julian Day from date

• ut541 - Convert spherical coordinates to cartesian coordinates

• ut542 - convert spherical vector components to cartesian components

• ut545 - compute date from modified Julian Day

• ut546 - convert cartesian coordinates to spherical coordinates

• ut547 - convert cartesian vector components to spherical components

• ut555 - coordinate conversion

• ut556 - vector conversion

• ua610 - select an atmospheric, ionospheric and/or plasmaspheric model

• ua630 - evaluate the atmospheric densities

• ut980 - print the error messages

• ut990 - initialize the UNILIB library

• ut998 - evaluate the magnetic field vector and the normal to the field line

• ut550 - select a coordinate transformation

• ut985 - transfer a field line of the drift shell to IDL

• ut986 - pass general variables to IDL

• ut991 - print the magnetic field line

• um522 - position of the Sun

• um524 - GEO to SM transformation

• um538 - evaluate the magnetic local time

• ul240 - evaluate the Hilton’s function

• ul242 - inverse the Hilton function

• setkmflg - Set dipole Moment flag

The routine uxidl() can easily be used as a root to build a sharable object library. See “T.08 - (OLD) How to link the library in IDL/PV-WAVE ?” for additional details.

Note

The type of the argc and argv argument to UXIDL must match the size of the integer used for passing parameters to IDL and depend on the architecture (either 32bit or 64bit).

History

• The routine interface UXIDL is not part of version 2.02 and earlier of the library.

Dependencies

None

See also

• T.05 - How to pass correctly the subroutine arguments in IDL ?

• T.08 - (OLD) How to link the library in IDL/PV-WAVE ?

---

UNILIB/tags/v3.02