"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "share/gretl_cli_fnref.es" between
gretl-2020a.tar.xz and gretl-2020b.tar.xz

About: gretl (Gnu Regression, Econometrics and Time-series Library) is a cross-platform statistical package mainly for econometric analysis.

gretl_cli_fnref.es  (gretl-2020a.tar.xz):gretl_cli_fnref.es  (gretl-2020b.tar.xz)
skipping to change at line 1856 skipping to change at line 1856
hace. En este último caso, se añade el mensaje de fallo de la biblioteca hace. En este último caso, se añade el mensaje de fallo de la biblioteca
'curl' al 'bundle', con el identificador "errmsg". Ten en cuenta, sin 'curl' al 'bundle', con el identificador "errmsg". Ten en cuenta, sin
embargo, que "éxito" en este sentido no significa necesariamente que embargo, que "éxito" en este sentido no significa necesariamente que
obtienes los datos que deseabas; en realidad significa tan solo que se obtienes los datos que deseabas; en realidad significa tan solo que se
recibió alguna respuesta del servidor. Debes comprobar el contenido del recibió alguna respuesta del servidor. Debes comprobar el contenido del
"buffer" de salida (que de hecho puede ser un mensaje tal como "Página no "buffer" de salida (que de hecho puede ser un mensaje tal como "Página no
encontrada"). encontrada").
Aquí tenemos un ejemplo de cómo utilizar esta función: para bajar algunos Aquí tenemos un ejemplo de cómo utilizar esta función: para bajar algunos
datos de la web de la US Bureau of Labor Statistics, que requiere el envío datos de la web de la US Bureau of Labor Statistics, que requiere el envío
de una consulta JSON. Observa el uso de para insertar comillas en los datos de una consulta JSON. Observa el uso de "sprintf" para insertar comillas en
POST. los datos POST.
bundle req bundle req
req.URL = "http://api.bls.gov/publicAPI/v1/timeseries/data/" req.URL = "http://api.bls.gov/publicAPI/v1/timeseries/data/"
req.include = 1 req.include = 1
req.header = "Content-Type: application/json" req.header = "Content-Type: application/json"
string s = sprintf("{\"seriesid\":[\"LEU0254555900\"]}") string s = sprintf("{\"seriesid\":[\"LEU0254555900\"]}")
req.postdata = s req.postdata = s
err = curl(&req) err = curl(&req)
if err == 0 if err == 0
s = req.output s = req.output
skipping to change at line 2286 skipping to change at line 2286
Para la inversa de esta función consulta "isodate", y también "juldate" Para la inversa de esta función consulta "isodate", y también "juldate"
(para el calendario Juliano). (para el calendario Juliano).
# errmsg # errmsg
Resultado: cadena Resultado: cadena
Argumento: errno (entero) Argumento: errno (entero)
Devuelve una cadena de texto con el mensaje de fallo de Gretl asociada a Devuelve una cadena de texto con el mensaje de fallo de Gretl asociada a
errno, que debe ser un número entero. Consulta también "$error". errno, que debe ser un número entero. Consulta también "$error".
# errorif
Resultado: escalar
Argumentos: condicion (booleano)
mensaje (cadena)
Esta función solo se aplica en el contexto de una función definida por el
usuario. Si la condicion se valora como no nula, ello implica que la
ejecución de la función vigente finalice con la presentación de un
mensaje condicionado a que se produzca un fallo; entonces el argumento
mensaje se presentará como parte del mensaje de fallo que se muestra al
llamar a la función.
El valor que se devuelve con esta función (1) es simplemente nominal.
# exists # exists
Resultado: entero Resultado: entero
Argumento: nombre (cadena) Argumento: nombre (cadena)
Devuelve un escalar no nulo si nombre es el nombre que identifica un objeto Devuelve un escalar no nulo si nombre es el nombre que identifica un objeto
que ya se definió, sea un escalar, una serie, una matriz, una lista, una que ya se definió, sea un escalar, una serie, una matriz, una lista, una
cadena de texto, un 'bundle' o un 'array'. En otro caso devuelve 0. Consulta cadena de texto, un 'bundle' o un 'array'. En otro caso devuelve 0. Consulta
también "typeof". también "typeof".
# exp # exp
skipping to change at line 2656 skipping to change at line 2670
Devuelve una serie con la diferencia fraccionaria de orden d de la serie y. Devuelve una serie con la diferencia fraccionaria de orden d de la serie y.
Observa que, en teoría, la diferenciación fraccionaria supone un filtro Observa que, en teoría, la diferenciación fraccionaria supone un filtro
infinitamente largo. Los valores de y_t anteriores a la muestra, en la infinitamente largo. Los valores de y_t anteriores a la muestra, en la
práctica se asume que son iguales a cero. práctica se asume que son iguales a cero.
Puedes utilizar valores negativos para d, y en ese caso la función realiza Puedes utilizar valores negativos para d, y en ese caso la función realiza
la integración fraccionaria. la integración fraccionaria.
# funcerr
Resultado: escalar
Argumento: mensaje (cadena, opcional)
Esta función solo es aplicable en el contexto de una función definida por
el usuario. Implica que la ejecución de la función vigente acabe con la
presentación de un mensaje condicionado a que se produzca un fallo.
Si indicas el argumento mensaje (opcional), este se va a presentar como
parte del mensaje de fallo que se muestra al llamar a la función. Esto
proporciona a los redactores de funciones, la oportunidad de indicar un
mensaje de fallo más específico del que se podría mostrar de otro modo.
El valor que se devuelve con esta función es simplemente nominal, pues al
invocarla se crea inevitablemente una condición de fallo.
# fzero # fzero
Resultado: escalar Resultado: escalar
Argumentos: fcall (llamada a función) Argumentos: fcall (llamada a función)
inicio (escalar o vector, opcional) inicio (escalar o vector, opcional)
toler (escalar, opcional) toler (escalar, opcional)
Trata de encontrar una raíz simple de una función continua f (normalmente Trata de encontrar una raíz simple de una función continua f (normalmente
no lineal) -- es decir, un valor de la variable escalar x que hace que f(x) no lineal) -- es decir, un valor de la variable escalar x que hace que f(x)
= 0. El argumento fcall debe proporcionar una llamada a la función en = 0. El argumento fcall debe proporcionar una llamada a la función en
cuestión. fcall puede incluir un número arbitrario de argumentos, pero el cuestión. fcall puede incluir un número arbitrario de argumentos, pero el
skipping to change at line 3664 skipping to change at line 3662
Argumentos: buf (cadena) Argumentos: buf (cadena)
ruta (cadena, opcional) ruta (cadena, opcional)
Como argumento buf deberás utilizar un buffer JSON, tal como puede Como argumento buf deberás utilizar un buffer JSON, tal como puede
recuperarse de un sitio web adecuado mediante la función "curl". La recuperarse de un sitio web adecuado mediante la función "curl". La
especificación y el efecto del argumento opcional ruta se describe más especificación y el efecto del argumento opcional ruta se describe más
abajo. abajo.
Lo que se devuelve es un 'bundle' cuya estructura básicamente refleja la de Lo que se devuelve es un 'bundle' cuya estructura básicamente refleja la de
la entrada: los objetos JSON se convierten en 'bundles' de Gretl, y los la entrada: los objetos JSON se convierten en 'bundles' de Gretl, y los
'arrays' JSON se convierten en 'arrays' de Gretl, cada uno de ellos 'arrays' JSON se convierten en 'arrays' de Gretl; cada uno de ellos puede
conteniendo cadenas de texto o 'bundles'. Los nodos de "valor" JSON se contener cadenas de texto, 'bundles' o 'arrays'. Los nodos de "valor" JSON
convierten en componentes de 'bundles' o elementos de 'arrays'; en el se convierten en componentes de 'bundles' o elementos de 'arrays'; en el
último caso, los valores numéricos se convierten en cadenas de texto último caso, los valores numéricos se convierten en cadenas de texto
utilizando sprintf. Ten en cuenta que, dado que no puedes anidar los utilizando sprintf. Ten en cuenta que, aunque la especificación JSON
'arrays' de Gretl, el argumento que acepta esta función es un poco más permite 'arrays' de tipo mixto, estos no se poden manejar mediante jsongetb
restrictivo que la especificación JSON, pues esta admite anidar los puesto que los 'arrays' de Gretl deben ser de tipo único.
'arrays'.
Puedes usar el argumento ruta para limitar los elementos JSON incluidos en Puedes usar el argumento ruta para limitar los elementos JSON incluidos en
el 'bundle' que se devuelve. Ten en cuenta que esto no es un "JsonPath" tal el 'bundle' que se devuelve. Ten en cuenta que esto no es un "JsonPath" tal
como se describe en la ayuda para "jsonget"; esto es una sencilla como se describe en la ayuda para "jsonget"; esto es una sencilla
composición sujeta a la siguiente especificación: composición sujeta a la siguiente especificación:
ruta es una formación de elementos separados por una barra, donde esta ruta es una formación de elementos separados por una barra, donde esta
barra ("/") indica el desplazamiento a un nivel "más bajo" en el árbol barra ("/") indica el desplazamiento a un nivel "más bajo" en el árbol
JSON representado por buf. Se permite una barra inicial pero no es JSON representado por buf. Se permite una barra inicial pero no es
necesaria, pues implícitamente la ruta siempre comienza en la raíz. No necesaria, pues implícitamente la ruta siempre comienza en la raíz. No
skipping to change at line 4477 skipping to change at line 4474
Por defecto, las estimaciones se obtienen por medio de la descomposición de Por defecto, las estimaciones se obtienen por medio de la descomposición de
Cholesky, con un último recurso a la descomposición QR si las columnas de Cholesky, con un último recurso a la descomposición QR si las columnas de
X tienen alto grado de multicolinealidad. Puedes forzar el uso de la X tienen alto grado de multicolinealidad. Puedes forzar el uso de la
descomposición SVD mediante la instrucción set svd on. descomposición SVD mediante la instrucción set svd on.
Ver también "mpols", "mrls". Ver también "mpols", "mrls".
# monthlen # monthlen
Resultado: entero Resultado: entero
Argumentos: mes (entero) Argumentos: mes (escalar o serie)
año (entero) año (escalar o serie)
duracsemana (entero) duracsemana (entero)
Devuelve un número entero que expresa cuantos días (relevantes) tiene un Devuelve un número entero que expresa cuantos días (relevantes) tiene un
mes de un año (en el proléptico calendario Gregoriano), especificados en mes de un año (en el proléptico calendario Gregoriano), especificados en
los dos primeros argumentos y considerando la duración de semana indicada los dos primeros argumentos y considerando la duración de semana indicada
por duracsemana. Este debe ser igual a 5, 6 o 7 (indicando el valor 6 que no por duracsemana. Este debe ser igual a 5, 6 o 7 (indicando el valor 6 que no
se cuentan los domingos, y 5 que no se cuentan ni los sábados ni los se cuentan los domingos, y 5 que no se cuentan ni los sábados ni los
domingos). domingos).
Por ejemplo, si tienes abierto un conjunto de datos mensuales, la expresión
series wd = monthlen($obsminor, $obsmajor, 5)
devolverá una serie que va contener el número de días laborables de cada
uno de los meses de la muestra.
# movavg # movavg
Resultado: serie Resultado: serie
Argumentos: x (serie) Argumentos: x (serie)
p (escalar) p (escalar)
control (entero, opcional) control (entero, opcional)
y0 (escalar, opcional) y0 (escalar, opcional)
Devuelve una serie que es una media móvil de x y, dependiendo del valor del Devuelve una serie que es una media móvil de x y, dependiendo del valor del
parámetro p, resultará una media móvil simple o ponderada parámetro p, resultará una media móvil simple o ponderada
exponencialmente. exponencialmente.
skipping to change at line 4957 skipping to change at line 4961
terceros, pero no es recomendable cuando se pretende leer el archivo con terceros, pero no es recomendable cuando se pretende leer el archivo con
los elementos de la matriz mediante Gretl. los elementos de la matriz mediante Gretl.
Ten en cuenta que, si vas a leer el archivo con la matriz utilizando otro Ten en cuenta que, si vas a leer el archivo con la matriz utilizando otro
software ajeno, no resulta aconsejable que utilices las opciones gzip ni software ajeno, no resulta aconsejable que utilices las opciones gzip ni
binario. Pero si lo quieres para que lo lea Gretl, estos dos formatos binario. Pero si lo quieres para que lo lea Gretl, estos dos formatos
alternativos permiten ahorrar espacio; y con el formato binario logras una alternativos permiten ahorrar espacio; y con el formato binario logras una
lectura más rápida de matrices grandes. El formato gzip no es recomendable lectura más rápida de matrices grandes. El formato gzip no es recomendable
para matrices muy grandes porque la descompresión puede ser bastante lenta. para matrices muy grandes porque la descompresión puede ser bastante lenta.
Ver también "mread". Ver también "mread". Para escribir una matriz en un archivo, como conjunto
de datos, consulta "store".
# mxtab # mxtab
Resultado: matriz Resultado: matriz
Argumentos: x (serie o vector) Argumentos: x (serie o vector)
y (serie o vector) y (serie o vector)
Devuelve una matriz que incluye la tabulación cruzada de los valores Devuelve una matriz que incluye la tabulación cruzada de los valores
contenidos en x (por filas) e y (por columnas). Los dos argumentos de esta contenidos en x (por filas) e y (por columnas). Los dos argumentos de esta
función deben ser del mismo tipo (ambas series o ambos vectores columna) y, función deben ser del mismo tipo (ambas series o ambos vectores columna) y,
a causa de la utilización típica de esta función, se asume que contiene a causa de la utilización típica de esta función, se asume que contiene
skipping to change at line 6856 skipping to change at line 6861
Argumentos: s (cadena) Argumentos: s (cadena)
hallada (cadena) hallada (cadena)
substit (cadena) substit (cadena)
Devuelve una cadena de texto con una copia de s en la que se substituyó Devuelve una cadena de texto con una copia de s en la que se substituyó
toda la cadena hallada por substit. Consulta también "regsub" para otras toda la cadena hallada por substit. Consulta también "regsub" para otras
substituciones más complejas mediante expresiones regulares. substituciones más complejas mediante expresiones regulares.
Ejemplo: Ejemplo:
string s1 = "Hola, Gretl!" string s1 = "Hola, Gretl!"
string s2 = strsub(s1, "Gretl", "Hansl") string s2 = strsub(s1, "Gretl", "Hansl")
print s2 print s2
# strvals # strvals
Resultado: array de cadenas Resultado: array de cadenas
Argumento: y (serie) Argumentos: y (serie)
submuestra (booleano, opcional)
Cuando la serie y se compone de cadenas de texto que expresan valores, esta Cuando la serie y se compone de cadenas de texto que expresan valores, esta
función devuelve un 'array' que contiene todos esos valores, ordenados función devuelve por defecto un 'array' que contiene todos esos valores
numéricamente comenzando por el 1. Cuando y no se compone de cadenas de (con independencia del rango muestral que esté vigente), ordenados
texto que expresan valores, se devuelve un 'array' de cadenas de texto numéricamente comenzando por el 1. Si está vigente una submuestra del
vacías. Ver también "stringify". conjunto de datos, puedes proporcionar un valor no nulo para el segundo
argumento (opcional) y obtener así un 'array' que contenga solo las cadenas
de texto presentes en la submuestra.
Cuando y no se compone de cadenas de texto que expresan valores, se devuelve
un 'array' de cadenas de texto vacías. Ver también "stringify".
# substr # substr
Resultado: cadena Resultado: cadena
Argumentos: s (cadena) Argumentos: s (cadena)
inicio (entero) inicio (entero)
fin (entero) fin (entero)
Devuelve una subcadena del argumento s, empezando en el carácter indicado Devuelve una subcadena del argumento s, empezando en el carácter indicado
por el entero positivo de inicio, y finalizando en el indicado por el de por el entero positivo de inicio, y finalizando en el indicado por el de
fin, ambos incluidos. fin, ambos incluidos.
Por ejemplo, el código de abajo Por ejemplo, el código de abajo
string s1 = "Hola, Gretl!" string s1 = "Hola, Gretl!"
string s2 = substr(s1, 7, 11) string s2 = substr(s1, 7, 11)
string s3 = substr("Hola, Gretl!", 7, 11)
print s2 print s2
print s3
proporciona: proporciona:
? print s2 ? print s2
Gretl Gretl
? print s3
Gretl
Debes darte cuenta de que, en algunos casos, podrías estar deseando Debes darte cuenta de que, en algunos casos, podrías estar deseando
intercambiar claridad por concisión, y utilizar operadores de reducción e intercambiar claridad por concisión, y utilizar operadores de reducción e
incremento, como en incremento, como en
string s1 = "Hola, Gretl!" string s1 = "Hola, Gretl!"
string s2 = s1[7:11] string s2 = s1[7:11]
string s3 = s1 + 6 string s3 = s1 + 6
print s2 print s2
print s3 print s3
 End of changes. 14 change blocks. 
38 lines changed or deleted 45 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)