Ayuda para la librería de funciones de acceso a datos del TJ-II

    El conjunto de funciones que aparecen a continuación, permiten acceder a la base de datos del TJ-II desde programas de usuario. Proporcionan una doble funcionalidad, tanto la recuperación de información como la integración de nuevos datos. Cualquier función se llama de la misma manera y con los mismos parámetros, independientemente del entorno, pero con la sintaxis propia del lenguaje de programación utilizado.

Tipos de datos

    La información de partida para la interpretación física de los fenómenos que tienen lugar en el seno del plasma del dispositivo TJ-II, está organizada en señales. Dichas señales pueden ser datos procedentes directamente de diagnósticos o resultados de códigos de análisis. Cada señal se identifica con un nombre que tiene validez global para toda la base de datos. El nombre debe comenzar necesariamente por una letra mayúscula y admite un máximo de 23 caracteres. Excepto el inicial, los demás pueden ser alfanuméricos o el símbolo "_".

    El desarrollo operativo de la base de datos del TJ-II requiere de una organización determinada de las señales. En primer lugar están clasificadas en función de la posibilidad de modificación de la información. En este sentido, existen tres tipos de datos, datos brutos, datos procesados y datos temporales, cuyas definiciones aparecen a continuación.

Datos brutos

Se entiende por tales a aquellas informaciones de especial relevancia por su significado experimental. Son señales que una vez integradas en la base de datos no pueden eliminarse ni modificarse. Dichas señales deben estar previamente declaradas en la base de datos para poder incorporarse.

Datos procesados

Las señales definidas bajo esta calificación admiten tantas modificaciones como sean necesarias, con la particularidad de que únicamente se almacena y gestiona la última versión de las mismas. Igual que las anteriores, requieren de una declaración explícita. Para que su identificación sea inmediata sin tener que recurrir a listas organizadas, el criterio impuesto ha sido que el último (y sólo el último) carácter del nombre de la señal debe ser "_".

Datos temporales

Son señales que son reconocidas por la base de datos durante un período de tiempo limitado. Trancurrido dicho intervalo temporal (programable en todo momento), tales datos son eliminados. Estas señales no requieren declaración previa, aunque una vez definidas tienen validez global hasta su eliminación.  Pueden definirse tantas señales de éstas como sean necesarias, pero no pueden modificarse ni borrarse por parte de los usuarios. Se identifican porque sus dos últimos caracteres del nombre son "_".

    La organización interna de la base de datos del TJ-II trata con una segunda clasificación de las señales, con aplicabilidad a los tres grupos mencionados con anterioridad. Esta ordenación está basada en criterios prácticos, poniendo de relieve las diferentes maneras en que un diagnóstico o un código de análisis puede traducir sus resultados. Así pues, es posible hablar de varias familias de datos: evolución temporal, perfiles, contornos bidimensionales, superficies tridimensionales, imágenes y, en general, cualquier clase de información necesaria para la interpretación científica de resultados. Actualmente, únicamente ha hecho falta incluir datos de evolución temporal y perfiles.

Entornos

Entorno

Lenguaje

Sentencia de compilación

AlphaServer 8400  C cc -o nombre nombre.c -lRpcC
FORTRAN f77 -o nombre nombre.f -lRpcC
CRAY J90  C cc -o nombre nombre.c -lRpcC
FORTRAN cf77 -o nombre nombre.f -lRpcC
Estaciones DEC Sala de Control  C cc -o nombre nombre.c -lRpcC
FORTRAN f77 -o nombre nombre.f -lRpcC
Ordenadores personales con Linux  C gcc -o nombre nombre.c -lRpcC
FORTRAN g77 -o nombre nombre.f -lRpcC
Ordenadores personales con Windows NT Server/Workstation V4.0/Windows 95/Windows 98/Windows 2000 C La sintaxis exacta depende del entorno de desarrollo utilizado (MS Visual C/C++, Watcom, Borland, etc.).

La librería a incluir se denomina tj2RpcC.lib.

Sun Solaris  C cc -o nombre nombre.c -lRpcC -lnsl
FORTRAN f77 -o nombre nombre.f -lRpcC -lnsl
Jen50
C
cc -o nombre nombre.c -lRpcC
FORTRAN f77 -o nombre nombre.f -lRpcC
g77 -o nombre nombre.f -lRpcC
Fenix (ALTIX 3000)
C
cc -o nombre nombre.c -lRpcC
FORTRAN g77 -o nombre nombre.f -lRpcC
PPC Darwin
C
cc -o nombre nombre.c -lRpcC
FORTRAN g77 -o nombre nombre.f -lRpcC

    Las funciones se encuentran agrupadas en una única librería y pueden llamarse indistintintamente desde programas C o FORTRAN. La única salvedad a tener en cuenta es que desde C, el nombre de la función debe terminar necesariamente con el caracter "_". Los entornos de aplicación con sus correspondientes sentencias de compilación son:

 

Funciones

adcbit    adcsim    addp     addt    addtc     addtcf    dimenp    dimens     ertxt    fecha     getq     lastshot     lectc     lectur    leep     listas    nums     numshots     paramn    params    setq     shotlist     sigtype    

adcbit

Función que calcula el número óptimo de bits para la conversion A/D de una señal. El cálculo se realiza en base a obtener el mismo error de cuantificación que en canales de medida (e < 0.7 mV).

Uso en programas FORTRAN

external adcbit

integer adcbit

integer ierr, nbits, ns, status

real sampl(N)

status = adcbit(ns, sampl, nbits, ierr)

Uso en programas C

int adcbit_(int *, float *, int *, int *)

int ierr, nbits, ns, status

float sampl[N]

status = adcbit_(&ns, sampl, &nbits, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ns

Entrada. Numero de muestras.

sampl

Entrada. Muestras de señal (V). Variable dimensionada por lo menos a ns.

nbits

Salida. Bits óptimos de resolución en función de las características de la señal (nbits <= 30).

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos     Entornos de aplicación    Índice de funciones

adcsim

Función que simula la conversion A/D de una señal.

Uso en programas FORTRAN

external adcsim

integer adcsim

integer adccod(N), ierr, nbits, ncod0v, ns, status

real sampl(N), vpp

status = adcsim(ns, nbits, sampl, adccod, ncod0v, vpp, ierr)

Uso en programas C

int adcsim_(int *, int *, float *, int *, int *, float *, int *)

int adccod[N], ierr, nbits, ncod0v, ns, status

float sampl[N], vpp

status = adcsim_(&ns, &nbits, sampl, adccod, &ncod0v, &vpp, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ns

Entrada. Numero de muestras.

nbits

Entrada/Salida. Bits de resolución de la conversión. Si a la entrada es distinto de cero, ese valor es el que se utiliza para convertir, siempre y cuando esté dentro del rango de precisión del ordenador. Si es negativo, nulo o incompatible con el rango de precisión, la función determina la resolución (nbits <= 30), manteniendo un error de cuantificación inferior a 0.7 mV.

sampl

Entrada. Muestras de señal (V). Variable dimensionada por lo menos a ns.

adccod

Salida. Códigos digitales resultantes de la conversión. Variable dimensionada por lo menos a ns.

ncod0v

Salida. Código digital correspondiente a una amplitud de 0 V.

vpp

Salida. Tensión p-p de la señal.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos     Entornos de aplicación    Índice de funciones

addp

Función que permite añadir una señal de tipo perfil a la base de datos del TJ-II.

Uso en programas FORTRAN

external addp

character*16 prmtos(N)

character*32 senal, unidx, unidy

integer addp

integer ierr, log10t, magnx, magny, ndat(M), ndes, np, npar, nper, status, t(M)

real factx, facty, r(L, M), values(N), y(L, M)

status = addp(ndes, senal, nper, ndat, log10t, t, np, r, y, factx, unidx, magnx, facty, unidy, magny, npar, prmtos, values, ierr)

Uso en programas C

int addp_(int *, char *, int *, int *, int *, int *, int *, float *, float *, float *, char *, int *, float *, char *, int *, int *, char *, float *, int *)

char prmtos[16*N], senal[32], unidx[32], unidy[32]

int ierr, log10t, magnx, magny, ndat[M], ndes, np, npar, nper, status, t[M]

float factx, facty, r[M][L], values[N], y[M][L]

status = addp_(&ndes, senal, &nper, ndat, &log10t, t, &np, r, y, &factx, unidx, &magnx, &facty, unidy, &magny, &npar, prmtos, values, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal. La mínima dimensión que debe tener esta variable son 24 bytes.

nper

Entrada/Salida. Número total de perfiles. De momento, solamente 1.

ndat

Entrada. Número de puntos de cada perfil. Variable dimensionada por lo menos a nper.

log10t

Entrada. Exponente de una base decimal para proporcionar la unidad de medida de los tiempos. Si log10t vale 0, los tiempos de la variable t van en segundos. Si vale -3, los tiempos van en ms. Si -6, entonces en microsegundos, etc.

t

Entrada. Tiempos. Variable dimensionada por lo menos a nper. Representa el instante de tiempo asociado a cada perfil. Los tiempos diferentes de 0 deben estar comprendidos en el intervalo

1 dps <= abs(t*10**log10t) < 9*10**5 s.

Si se encuentran valores inferiores a la décima del ps, la rutina redondea a 0.

np

Entrada. Primera dimensión de los arrays r e y tal y como se declaran en el programa de llamada. Representa el máximo número de puntos de un perfil (np >= MAX(ndat)).

r

Entrada. Coordenada radial. Array bidimensional con dimensiones

r(np, nd) (FORTRAN), nd >= nper

r[nd][np] (C), nd >= nper

y

Entrada. Puntos del perfil. Array bidimensional con dimensiones

y(np, nd) (FORTRAN), nd >= nper

y[nd][np] (C), nd >= nper

factx

Entrada. Factor multiplicativo en abcisas para representar la señal.

unidx

Entrada. Unidad de medida en abcisas.

magnx

Entrada/Salida. La función siempre retorna 0.

facty

Entrada. Factor multiplicativo en ordenadas para representar la señal.

unidy

Entrada. Unidad de medida en ordenadas.

magny

Entrada/Salida. La función siempre retorna 0.

npar

Entrada. Número de parámetros de la señal.

prmtos

Entrada. Lista de parámetros. Si npar es cero, esta variable no se usa, pero debe estar presente. Cada parámetro ha de tener 16 bytes.

values

Entrada. Valores asociados a cada parámetro. Si npar es cero, esta variable no se usa, pero debe estar presente.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos    Entornos de aplicación         Índice de funciones

addt

Función que permite añadir una señal de evolución temporal a la base de datos del TJ-II.

Uso en programas FORTRAN

external addt

character*16 prmtos(N)

character*32 senal, unidad

integer addt

integer ierr, log10t, mtrigg, nbits, ndat, ndes, npar, status, t(M)

real dcval, factor, values(N), y(M)

status = addt(ndes, senal, ndat, log10t, t, y, dcval, nbits, mtrigg, factor, unidad, npar, prmtos, values, ierr)

Uso en programas C

int addt_(int *, char *, int *, int *, int *, float *, float *, int *, int *, float *, char *, int *, char *, float *, int *)

char prmtos[16*N], senal[32], unidad[32]

int ierr, log10t, mtrigg, nbits, ndat, ndes, npar, status, t[M]

float dcval, factor, values[N], y[M]

status = addt_(&ndes, senal, &ndat, &log10t, t, y, &dcval, &nbits, &mtrigg, &factor, unidad, &npar, prmtos, values, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal. La mínima dimensión que debe tener esta variable son 24 bytes.

ndat

Entrada. Número total de datos.

log10t

Entrada. Exponente de una base decimal para proporcionar la unidad de medida de los tiempos. Si log10t vale 0, los tiempos de la variable t van en segundos. Si vale -3, los tiempos van en ms. Si -6, entonces en microsegundos, etc.

t

Entrada. Tiempos. Variable dimensionada por lo menos a ndat. Los tiempos han de estar ordenados en forma estrictamente creciente. Los tiempos diferentes de 0 deben estar comprendidos en el intervalo

1 dps <= abs(t*10**log10t) < 9*10**5 s.

Si se encuentran valores inferiores a la décima del ps, la rutina redondea a 0.

y

Entrada. Amplitudes (V). Variable dimensionada por lo menos a ndat.

dcval

Entrada. Componente contínua lejos de la descarga (V).

nbits

Entrada/Salida. A la entrada contiene el numero de bits pretendidos para la conversión digital (necesariamente menor que 30). Si este número no es compatible con la máxima resolución del ordenador, la función determinará el número óptimo de bits. Si el valor a la entrada es negativo o nulo, se calcula el número de bits necesarios para mantener el error de cuantificación inferior a 0.7 mV y compatible con la máxima resolución posible. A la salida, este parámetro devuelve el número de bits realmente utilizados.

mtrigg

Entrada. Número de muestra en que se recibió el "trigger".

factor

Entrada. Factor multiplicativo para representar la señal.

unidad

Entrada. Unidad de medida.

npar

Entrada. Número de parámetros de la señal.

prmtos

Entrada. Lista de parámetros. Si npar es cero, esta variable no se usa, pero debe estar presente. Cada parámetro ha de tener 16 bytes.

values

Entrada. Valores asociados a cada parámetro. Si npar es cero, esta variable no se usa, pero debe estar presente.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

addtc

Función que permite añadir una señal de evolución temporal a la base de datos del TJ-II. Esta función recibe directamente los códigos digitales de las muestras.

Uso en programas FORTRAN

external addtc

character*16 prmtos(N)

character*32 senal, unidad

integer addtc

integer coddig(M), dccod, ierr, log10t, mtrigg, nbits, ndat, ndes, npar, status, t(M)

real factor, values(N), vmin, vpp

status = addtc(ndes, senal, ndat, log10t, t, coddig, vpp, vmin, dccod, nbits, mtrigg, factor, unidad, npar, prmtos, values, ierr)

Uso en programas C

int addtc_(int *, char *, int *, int *, int *, int *, float *, float *, int *, int *, int *, float *, char *, int *, char *, float *, int *)

char prmtos[16*N], senal[32], unidad[32]

int coddig[M], dccod, ierr, log10t, mtrigg, nbits, ndat, ndes, npar, status, t[M]

float factor, values[N], vmin, vpp

status = addtc_(&ndes, senal, &ndat, &log10t, t, coddig, &vpp, &vmin, &dccod, &nbits, &mtrigg, &factor, unidad, &npar, prmtos, values, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal. La mínima dimensión que debe tener esta variable son 24 bytes.

ndat

Entrada. Número total de datos.

log10t

Entrada. Exponente de una base decimal para proporcionar la unidad de medida de los tiempos. Si log10t vale 0, los tiempos de la variable t van en segundos. Si vale -3, los tiempos van en ms. Si -6, entonces en microsegundos, etc.

t

Entrada. Tiempos. Variable dimensionada por lo menos a ndat. Los tiempos han de estar ordenados en forma estrictamente creciente. Los tiempos diferentes de 0 deben estar comprendidos en el intervalo

1 dps <= abs(t*10**log10t) < 9*10**5 s.

Si se encuentran valores inferiores a la décima del ps, la rutina redondea a 0.

coddig

Entrada. Códigos digitales de la amplitud. Variable dimensionada por lo menos a ndat.

vpp

Entrada. Amplitud pico-pico (V) del rango dinámico del adc.

vmin

Entrada. Nivel inferior (V) del rango dinámico del conversor analógico/digital.

dccod

Entrada. Código digital correspondiente a la componente contínua lejos de la descarga.

nbits

Entrada. Número de bits de la conversión digital. El máximo valor posible es 30.

mtrigg

Entrada. Número de muestra en que se recibió el "trigger".

factor

Entrada. Factor multiplicativo para representar la señal.

unidad

Entrada. Unidad de medida.

npar

Entrada. Numero de parámetros de la señal.

prmtos

Entrada. Lista de parámetros. Si npar es cero, esta variable no se usa, pero debe estar presente. Cada parámetro ha de tener 16 bytes.

values

Entrada. Valores asociados a cada parámetro. Si npar es cero, esta variable no se usa, pero debe estar presente.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones


addtcf

Función que permite añadir una señal de evolución temporal a la base de datos del TJ-II. Esta función recibe directamente los códigos digitales de las muestras. La diferencia entre esta función y la función addtc es que en esta no es necesario porporcionar un vector de tiempos, sólo se pasan el tiempo incial, periodo de muestreo y número de muestras en cada ventana de digitalización. Con esto se ahorra tráfico de red y la función es más rápida que addtc.

Uso en programas FORTRAN

external addtcf

character*16 prmtos(N)

character*32 senal, unidad

integer addtcf

integer coddig(M), dccod, ierr, log10t, mtrigg, nbits, ndat, ndes, npar, status, nvent, mv(M), per(M), tini(M)

real factor, values(N), vmin, vpp

status = addtcf(ndes, senal, ndat, nvent, coddig, mv, per, tini,  log10t, vpp, vmin, dccod, nbits, mtrigg, factor, unidad, npar, prmtos, values, ierr)

Uso en programas C

int addtcf_(int *, char *, int *, int *, int *, int *, float *, float *, int *, int *, int *, float *, char *, int *, char *, float *, int *)

char prmtos[16*N], senal[32], unidad[32]

int coddig[M], dccod, ierr, log10t, mtrigg, nbits, ndat, ndes, npar, status, nvent, mv[M], per[M], tini[M]

float factor, values[N], vmin, vpp

status = addtcf_(&ndes, senal, &ndat, &nvent,  coddig, mv, per, tini, &log10t, &vpp, &vmin, &dccod, &nbits, &mtrigg, &factor, unidad, &npar, prmtos, values, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal. La mínima dimensión que debe tener esta variable son 24 bytes.

ndat

Entrada. Número total de datos.

nvent

Entrada. Número de ventanas de muestreo en la señal.

coddig

Entrada. Códigos digitales de la amplitud. Variable dimensionada por lo menos a ndat.

mv

Entrada. Número de muestras en cada ventana de digitalización.

per

Entrada. Periodo de muestreo en cada ventana de digitalización.

tini

Entrada. Tiempo inicial en cada ventana de digitalización.

log10t

Entrada. Exponente de una base decimal para proporcionar la unidad de medida de los tiempos. Si log10t vale 0, los tiempos de la variable t van en segundos. Si vale -3, los tiempos van en ms. Si -6, entonces en microsegundos, etc.

vpp

Entrada. Amplitud pico-pico (V) del rango dinámico del adc.

vmin

Entrada. Nivel inferior (V) del rango dinámico del conversor analógico/digital.

dccod

Entrada. Código digital correspondiente a la componente contínua lejos de la descarga.

nbits

Entrada. Número de bits de la conversión digital. El máximo valor posible es 30.

mtrigg

Entrada. Número de muestra en que se recibió el "trigger".

factor

Entrada. Factor multiplicativo para representar la señal.

unidad

Entrada. Unidad de medida.

npar

Entrada. Numero de parámetros de la señal.

prmtos

Entrada. Lista de parámetros. Si npar es cero, esta variable no se usa, pero debe estar presente. Cada parámetro ha de tener 16 bytes.

values

Entrada. Valores asociados a cada parámetro. Si npar es cero, esta variable no se usa, pero debe estar presente.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

dimenp

Función que devuelve el número de perfiles almacenados y el numero de puntos de cada uno de ellos para una señal de tipo perfil en una descarga determinada.

Uso en programas FORTRAN

external dimenp

integer dimenp

character*32 senal

integer ierr, ndes, nperf, npunt, status

status = dimenp(ndes, senal, nperf, npunt, ierr)

Uso en programas C

int dimenp_(int *, char *, int *, int *, int *)

char senal[32]

int ierr, ndes, nperf, npunt, status

status = dimenp_(&ndes, senal, &nperf, &npunt, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal a buscar. La mínima dimensión que debe tener esta variable son 24 bytes.

nperf

Salida. Número de perfiles almacenados para esta señal en la descarga dada.

npunt

Salida. Máximo número de puntos en un perfil.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Ejemplos

FORTRAN    C

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

dimens

Función que devuelve el número de muestras adquiridas y el número de ventanas de digitalización para una señal que representa evolución temporal.

Uso en programas FORTRAN

external dimens

integer dimens

character*32 senal

integer ierr, ndat, ndes, nvent, status

status = dimens(ndes, senal, ndat, nvent, ierr)

Uso en programas C

int dimens_(int *, char *, int *, int *, int *)

char senal[32]

int ierr, ndat, ndes, nvent, status

status = dimens_(&ndes, senal, &ndat, &nvent, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal a buscar. La mínima dimensión que debe tener esta variable son 24 bytes.

ndat

Salida. Número total de datos.

nvent

Salida. Número de ventanas de muestreo.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Ejemplos

FORTRAN    C

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

ertxt

Función que escribe en el dispositivo de salida estándar los mensajes de error producidos en las funciones de acceso a datos del TJ-II. El valor de retorno de la función siempre es 0.

Uso en programas FORTRAN

external ertxt

integer ertxt

integer ncode, status

status = ertxt(ncode)

Uso en programas C

int ertxt_(int *)

int ncode, status

status = ertxt_(&ncode)

Valores de retorno

status = 0

Único valor de retorno.

Argumentos

ncode

Entrada. Código de error devuelto por alguna de las funciones de la librería de acceso a datos.

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

fecha

Función que retorna la fecha y la hora en que se produjo una descarga.

Uso en programas FORTRAN

external fecha

integer fecha

integer ierr, mes, mm, nagno, ndes, ndia, nhh, status

status = fecha(ndes, ndia, mes, nagno, nhh, mm, ierr)

Uso en programas C

int fecha_(int *, int *, int *, int *, int *, int *, int *)

int ierr, mes, mm, nagno, ndes, ndia, nhh, status

status = fecha_(&ndes, &ndia, &mes, &nagno, &nhh, &mm, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

ndia

Salida. Día.

mes

Salida. Mes.

nagno

Salida. Año.

nhh

Salida. Hora en formato de 24 h.

mm

Salida. Minutos.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Ejemplos

FORTRAN    C

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

getq

Función que retorna la calificación de los datos de una señal para una descarga dada.

Uso en programas FORTRAN

external getq

integer getq

character*32 senal

integer ierr, indice, ndes, status

status = getq(ndes, senal, indice, ierr)

Uso en programas C

int getq_(int *, char *, int *, int *)

char senal[32]

int ierr, indice, ndes, status

status = getq_(&ndes, senal, &indice, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal a buscar. La mínima dimensión que debe tener esta variable son 24 bytes.

indice

Salida. Categoría de los datos:

0: Sin clasificar.

1: Datos validados.

2: No usar.

3: Usar con reservas.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Ejemplos

FORTRAN

Volver a:    Tipos de datos    Entorno de aplicación   Índice de funciones



lastshot

Función que devuelve la última descarga almacenada en l aba se de datos de TJ-II.

Uso en programas FORTRAN

external lastshot

integer ndes

status = lastshot(ndes,  ierr)

Uso en programas C

int lastshot_(int *, int *);

int ndes;

status = lastshot_(&ndes, &ierr);

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función (ierr).

Argumentos

ndes

Salida. Número de la última descarga almacenada.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones



lectc

Función que devuelve los códigos digitales de una señal que representa evolución temporal. La diferencia con lectur() estriba en que ahora las variables y, offset, ymax e ymin son de tipo entero en lugar de reales.

Uso en programas FORTRAN

external lectc

integer lectc

character*32 senal, unidad

integer code0, ierr, mv(N), nbits, ndat, ndes, ndimv, ndimx, ndimy, nvent, offset, status, y(M), ymax, ymin

real factor, per(N), tini(N), vpp, x(M)

status = lectc(ndes, senal, ndimx, ndimy, ndimv, x, y, ndat, nvent, mv, per, tini, nbits, offset, ymax, ymin, factor, vpp, code0, unidad, ierr)

Uso en programas C

int lectc_(int *, char *, int *, int *,int *, float *, int *, int *, int *, int *, float *, float *, int *, int *, int *, int *, float *,float *, int *, char *, int *)

char senal[32], unidad[32]

int code0, ierr, mv[N], nbits, ndat, ndes, ndimv, ndimx, ndimy, nvent, offset, status, y[M], ymax, ymin

float factor, per[N], tini[N], vpp, x[M]

status = lectc_(&ndes, senal, &ndimx, &ndimy, &ndimv, x, y, &ndat, &nvent, mv, per, tini, &nbits, &offset, &ymax, &ymin, &factor, &vpp, &code0, unidad, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal a buscar. La mínima dimensión que debe tener esta variable son 24 bytes.

ndimx

Entrada. Dimensión exacta de la variable x tal y como se la declaró en el programa principal.

ndimy

Entrada. Dimensión exacta de la variable y tal y como se la declaró en el programa principal.

ndimv

Entrada. Dimensión exacta de las variables mv, per y tini tal y como fueron declaradas en el programa principal.

x

Salida. Tiempo (ms).

y

Salida. Códigos digitales de las muestras.

ndat

Salida. Número total de datos (ndat <= ndimx, ndat <= ndimy).

nvent

Salida. Número de ventanas de muestreo (nvent <= ndimv).

mv

Salida. Número de muestras en cada ventana de digitalización.

per

Salida. Período de muestreo (ms) en cada ventana.

tini

Salida. Instante del primer dato (ms) en cada ventana.

nbits

Salida. Bits de resolución en la conversión A/D.

offset

Salida. Código digital correspondiente a la componente contínua lejos de la descarga.

ymax

Salida. Máximo valor de amplitud (código digital).

ymin

Salida. Mínimo valor de amplitud (código digital).

factor

Salida. Factor multiplicativo para representar la señal.

vpp

Salida. Tensión p-p del ADC (V).

code0

Salida. Código digital correspondiente a 0 V.

unidad

Salida. Unidad de medida.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

lectur

Función que devuelve la información almacenada de una señal que representa evolución temporal.

Uso en programas FORTRAN

external lectur

integer lectur

character*32 senal, unidad

integer code0, ierr, mv(N), nbits, ndat, ndes, ndimv, ndimx, ndimy, nvent, status

real factor, offset, per(N), tini(N), vpp, x(M), y(M), ymax, ymin

status = lectur(ndes, senal, ndimx, ndimy, ndimv, x, y, ndat, nvent, mv, per, tini, nbits, offset, ymax, ymin, factor, vpp, code0, unidad, ierr)

Uso en programas C

int lectur_(int *, char *, int *, int *,int *, float *, float*, int *, int *, int *, float *, float *, int *, float *, float *,float *, float *,float *, int *, char *, int *)

char senal[32], unidad[32]

int code0, ierr, mv[N], nbits, ndat, ndes, ndimv, ndimx, ndimy, nvent, status

float factor, offset, per[N], tini[N], vpp, x[M], y[M], ymax, ymin

status = lectur_(&ndes, senal, &ndimx, &ndimy, &ndimv, x, y, &ndat, &nvent, mv, per, tini, &nbits, &offset, &ymax, &ymin, &factor, &vpp, &code0, unidad, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal a buscar. La mínima dimensión que debe tener esta variable son 24 bytes.

ndimx

Entrada. Dimensión exacta de la variable x tal y como se la declaró en el programa principal.

ndimy

Entrada. Dimensión exacta de la variable y tal y como se la declaró en el programa principal.

ndimv

Entrada. Dimensión exacta de las variables mv, per y tini tal y como fueron declaradas en el programa principal.

x

Salida. Tiempo (ms).

y

Salida. Amplitud (V).

ndat

Salida. Número total de datos (ndat <= ndimx, ndat <= ndimy).

nvent

Salida. Número de ventanas de muestreo (nvent <= ndimv).

mv

Salida. Número de muestras en cada ventana de digitalización.

per

Salida. Período de muestreo (ms) en cada ventana.

tini

Salida. Instante del primer dato (ms) en cada ventana.

nbits

Salida. Bits de resolución en la conversión A/D.

offset

Salida. Componente contínua lejos de la descarga (V).

ymax

Salida. Máximo valor de amplitud (V).

ymin

Salida. Mínimo valor de amplitud (V).

factor

Salida. Factor multiplicativo para representar la señal.

vpp

Salida. Tensión p-p del ADC (V).

code0

Salida. Código digital correspondiente a 0 V.

unidad

Salida. Unidad de medida.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Ejemplos

FORTRAN

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

leep

Función que devuelve la información almacenada para una señal de tipo perfil.

Uso en programas FORTRAN

external leep

integer leep

character*32 senal, unidx, unidy

integer ierr, magnx, magny, ndes, ndim1, ndim2, nperf, npunt(N), status

real factx, facty, r(M, N), t(N), y(M, N)

status = leep(ndes, senal, ndim1, ndim2, r, y, nperf, npunt, t, factx, unidx, magnx, facty, unidy, magny, ierr)

Uso en programas C

int leep_(int *, char *, int *, int *, float *, float *, int *, int *, float *, float *, char *, int *, float *f, char *, int *, int *)

char senal[32], unidx[32], unidy[32]

int ierr, magnx, magny, ndes, ndim1, ndim2, nperf, npunt[N], status

float factx, facty, r[N][M], t[N], y[N][M]

status = leep_(&ndes, senal, &ndim1, &ndim2, r, y, &nperf, npunt, t, &factx, unidx, &magnx, &facty, unidy, &magny, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal a buscar. La mínima dimensión que debe tener esta variable son 24 bytes.

ndim1

Entrada. Máximo número de puntos por perfil. Este valor debe coincidir con la dimensión exacta declarada en el programa de llamada.

ndim2

Entrada. Máximo número de perfiles. Este valor debe coincidir con la dimensión exacta declarada en el programa de llamada.

r

Salida. Abcisas de los perfiles. Variable bidimensional cuya declaración exacta en el programa de llamada debe ser:

r(ndim1, ndim2) (FORTRAN)

r[ndim2][ndim1] (C)

y

Salida. Ordenadas de los perfiles. Variable bidimensional cuya declaración exacta en el programa de llamada debe ser:

y(ndim1, ndim2) (FORTRAN)

y[ndim2][ndim1] (C)

nperf

Salida. Número de perfiles almacenados para esta señal en la descarga dada (nperf <= ndim2).

npunt

Salida. Variable dimensionada al menos a ndim2, que contiene el número de puntos de cada perfil almacenado.

t

Salida. Variable dimensionada al menos a ndim2, que contiene los instantes de tiempo (ms) asociados a cada perfil almacenado.

factx

Salida. Factor multiplicativo en abcisas para representar la señal.

unidx

Salida. Unidad de medida en abcisas.

magnx

Salida. Variable necesaria que la función retorna con valor 0.

facty

Salida. Factor multiplicativo en abcisas para representar la señal.

unidy

Salida. Unidad de medida en abcisas.

magny

Salida. Variable necesaria que la función retorna con valor 0.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Ejemplos

FORTRAN

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

listas

Función que devuelve el número y los nombres de las señales adquiridas en una descarga.

Uso en programas FORTRAN

external listas

integer listas

character*24 lista(N)

integer ierr, ndes, ndim, nsr, status

status = listas(ndes, ndim, nsr, lista, ierr)

Uso en programas C

int listas_(int *, int *, int *, char *, int *)

char lista[24*N]

int ierr, ndes, ndim, nsr, status

status = listas_(&ndes, &ndim, &nsr, lista, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

ndim

Entrada. Número de elementos de 24 bytes en la variable lista tal y como se la declaró en el programa principal.

nsr

Salida. Número real de señales existentes. Si nsr <= ndim, la variable lista contiene los nombres de nsr señales. Si nsr > ndim, en lista aparecerán las ndim primeras señales de la descarga.

lista

Salida. Variable de caracteres en donde se devuelven los nombres de las señales. Para cada señal debe haber NECESARIAMENTE 24 bytes.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Ejemplos

FORTRAN

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

nums

Función que devuelve el número de señales adquiridas en una descarga.

Uso en programas FORTRAN

external nums

integer nums

integer ierr, ndes, nsen, status

status = nums(ndes, nsen, ierr)

Uso en programas C

int nums_(int *, int *, int *)

int ierr, ndes, nsen, status

status = nums_(&ndes, &nsen, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

nsen

Salida. Número de señales existentes.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Ejemplos

FORTRAN

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones




numshots

Función que devuelve el número de descargas almacenadas en la base de datos de TJ-II para una fecha dada.

Uso en programas FORTRAN

external numshots

integer anio, mes, dia, nshots, ierr

status = numshots( anio, mes, dia, nshots,  ierr)

Uso en programas C

int lastshot_(int *, int *, int *, int *, int *);

int anio, mes, dia, nshots, ierr;

status = lastshot_(&anio, &mes, &dia, &nshots, &ierr);

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función (ierr).

Argumentos

anio

Entrada. Año.

mes

Entrada
. Mes

dia

Entrada
. Día.

nshots

Salida.
Número de descargas almacenadas para la fecha dada.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

paramn

Función que devuelve el número de parámetros de usuario definidos en una descarga para una señal.

Uso en programas FORTRAN

external paramn

integer paramn

character*32 senal

integer ierr, ndes, np, status

status = paramn(ndes, senal, np, ierr)

Uso en programas C

int paramn_(int *, char *, int *, int *)

char senal[32]

int ierr, ndes, np, status

status = paramn_(&ndes, senal, &np, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal a buscar. La mínima dimensión que debe tener esta variable son 24 bytes.

np

Salida. Número total de parámetros.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Ejemplos

FORTRAN

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

params

Función que devuelve los parámetros de usuario definidos en una descarga para una señal.

Uso en programas FORTRAN

external params

integer params

character*16 prmtos(N)

character*32 senal

integer ierr, ndes, ndimp, ndimvl, np, status

real values(N)

status = params(ndes, senal, ndimp, ndimvl, prmtos, values, np, ierr)

Uso en programas C

int params_(int *, char *, int *, int *, char *,

float *, int *, int *)

char prmtos[16*N], senal[32]

int ierr, ndes, ndimp, ndimvl, np, status

float values[N]

status = params_(&ndes, senal, &ndimp, &ndimvl, prmtos, values, &np, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal a buscar. La mínima dimensión que debe tener esta variable son 24 bytes.

ndimp

Entrada. Número de elementos de 16 bytes en la variable prmtos tal y como se la declaró en el programa principal.

ndimvl

Entrada. Dimensión exacta de la variable values tal y como se la declaró en el programa principal.

prmtos

Salida. Lista de parámetros. Para cada parámetro debe haber NECESARIAMENTE 16 bytes.

values

Salida. Valores asociados a cada parámetro.

np

Salida. Número total de parámetros (np <= ndimp, np <= ndimvl).

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Ejemplos

FORTRAN

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

setq

Función que califica los datos de una señal para una descarga dada.

Uso en programas FORTRAN

external setq

integer setq

character*32 senal

integer ierr, indice, ndes, status

status = setq(ndes, senal, indice, ierr)

Uso en programas C

int setq_(int *, char *, int *, int *)

char senal[32]

int ierr, indice, ndes, status

status = setq_(&ndes, senal, &indice, &ierr)

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función.

Argumentos

ndes

Entrada. Número de descarga.

senal

Entrada. Nombre de la señal a buscar. La mínima dimensión que debe tener esta variable son 24 bytes.

indice

Entrada. Categoría de los datos:

0: Sin clasificar.

1: Datos validados.

2: No usar.

3: Usar con reservas.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones




shotlist

Función que devuelve la lista de descargas almacenadas en la base de datos de TJ-II para una fecha dada.

Uso en programas FORTRAN

external shotlist

integer anio, mes, dia, ndim,  nshots, ierr

integer shots(ndim)

status = shotlist( anio, mes, dia, ndim, nshots,  shots, ierr)

Uso en programas C

int shotlist_(int *, int *, int *, int *, int *, int *, int *);

int anio, mes, dia, ndim,  nshots, ierr;

int shots[ndim];

status = shotlist_(&anio, &mes, &dia, &ndim, &nshots, shots, &ierr);

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función (ierr).

Argumentos

anio

Entrada. Año.

mes

Entrada
. Mes

dia

Entrada
. Día.

ndim

Entrada.
Dimension del vector en el que se recibira la lista de descargas (shots). Ha de ser menor o igual que la dimension del vector declarada en el programa que llama a la función.

nshots

Salida.
Número de descargas almacenadas para la fecha dada.

shots

Salida.
Vector de descargas. Al retorno de la función este vector contendrá los números de las descargas almacenadas en la base de datos para la fecha dada.

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones

sigtype

Función que devuelve el tipo de seņal

Uso en programas FORTRAN

external sigtype

integer status,   tipo,  ierr

character*32 senal

status = sigtype( senal, tipo, ierr)

Uso en programas C

int sigtype(, char *, int *, int *);

int status, tipo, ierr;

char senal[32];

status = sigtype_( senal, &tipo, &ierr);

Valores de retorno

status = 0

Retorno normal.

status = - 1

Error. La causa viene codificada en el último argumento de la función (ierr).

Argumentos

senal

Entrada. Senal

tipo

Salida. Tipo de la seņal ( 0 = seņal temporal, 1 = perfil).

ierr

Salida. Código de error. Vale 0 si el retorno de la función es 0.

Volver a:    Tipos de datos    Entornos de aplicación   Índice de funciones