Acerca de File Exchange

File Exchange permite buscar y compartir aplicaciones personalizadas, clases, ejemplos de código, controladores, funciones, modelos de Simulink, scripts y vídeos. Con File Exchange puede:

El uso de File Exchange está sujeto a las Condiciones de uso de MATLAB Central.


Publicación de archivos

Puede publicar archivos de hasta 250 MB. Para publicar un archivo, inicie sesión en su perfil de comunidad. Si no tiene un perfil, deberá crear uno. En la página de su cuenta, haga clic en “Publicar” para cargar un archivo desde un equipo o conectarse a un repositorio de GitHub.

Conexión a repositorios de GitHub

La conexión entre File Exchange y GitHub permite que colaboradores desarrollen proyectos de software en un único entorno sin necesidad de cargar archivos en ambos sitios. Quienes colaboran obtienen todos los beneficios del desarrollo colectivo en GitHub, al tiempo que los integrantes de la comunidad tienen acceso a la última versión de los proyectos, tanto desde File Exchange como GitHub. Los integrantes de la comunidad que descargan archivos conectados a GitHub son responsables de validar el contenido y las licencias de esos archivos.

Cuando se conecta a un repositorio de GitHub, File Exchange almacena el contenido del repositorio en los servidores de MathWorks para que esté disponible en File Exchange y Add-On Explorer. Los archivos almacenados en los servidores de MathWorks son de solo lectura y se actualizan automáticamente para reflejar los cambios en GitHub. Almacenar el contenido del repositorio permite que MathWorks brinde funcionalidades útiles, como mostrar vistas previas de código de MATLAB.

Para conectar un repositorio a GitHub, seleccione una de las siguientes opciones:

  • GitHub Releases: La forma recomendada de conectarse es mediante los lanzamientos de GitHub. Cuando el repositorio esté listo para su distribución, haga clic en Releases (lanzamientos) para empaquetar el código. La publicación en File Exchange se actualiza automáticamente cuando cree una nueva versión en GitHub

    Cuando cree una versión en GitHub:

  •     - Si empaqueta el código en forma de toolbox, adjunte la toolbox (archivo .mltbx) a la versión. File Exchange proporcionará la toolbox como descarga. Si no adjunta un archivo .mltbx a la versión, File Exchange utilizará el recurso de versión zip.
  •     - Siga estos consejos para etiquetar las versiones:
  • - Introduzca una versión con el formato mayor.menor.parche.extensión (el parche y la extensión son opcionales).
  • - Los segmentos de número de versión deben tener menos de seis dígitos.
  • - No se admiten etiquetas alfanuméricas (por ejemplo, 2-beta).
  • - Cuando adjunte un archivo mltbx a la versión, use el mismo número de versión de paquete que el número de versión de GitHub.
  •     - Consulte la documentación de GitHub para obtener más información sobre GitHub Releases.
  • Rama predeterminada: Con este método, File Exchange utiliza la rama predeterminada del repositorio (por lo general "main" o "master") para mostrar vistas previas de archivos y proporcionar el paquete para descargar. Los cambios que se confirman en la rama predeterminada están disponibles al cabo de 24 horas. Dependiendo del proceso de desarrollo, si la rama predeterminada se encuentra disponible en File Exchange, el código que obtengan los usuarios podría ser inestable. Recomendamos utilizar las versiones de GitHub para distribuir código estable.
  • Si utiliza Git LFS, empaquete el código en forma de toolbox y adjunte el archivo mltbx a la versión de GitHub de su repositorio. No se admite Git LFS para conexiones de rama predeterminada en File Exchange.

Cómo facilitar la búsqueda y uso de archivos

  • Asegúrese de que los títulos y las descripciones sean claros, concisos y descriptivos.
  • Revise la legibilidad y la ortografía de sus publicaciones.
  • Utilice etiquetas que faciliten las búsquedas. Consulte creación de etiquetas.
  • Al agregar imágenes, asegúrese de que tengan el mismo nombre de archivo y residan en el mismo directorio que el código.
  • Manifieste su agradecimiento por los archivos que le inspiraron a publicar su creación. Los agradecimientos aparecen en la página de su archivo y en la página del archivo reconocido.

Uso compartido de un sitio web que contenga su código de MATLAB

Si utiliza la opción “Link to an External Website” al realizar una contribución a File Exchange, puede compartir un sitio web que contenga un proyecto relacionado con MATLAB. Con esta opción:

  • La página de detalles de su publicación contiene el enlace a su sitio web.
  • Los integrantes de la comunidad pueden compartir comentarios sobre el proyecto en la página de detalles.
  • El código del sitio web no se puede descargar directamente desde File Exchange.

Información sobre licencias

Las licencias asignan los derechos de autor y de usuario del código disponible en File Exchange. En las licencias se detalla el uso del código y se abordan preguntas comunes sobre los derechos de modificación, distribución y uso comercial.

La licencia BSD es la única licencia compatible con el código publicado directamente en File Exchange y se agrega automáticamente al contenido de la comunidad de usuarios que se publica directamente en File Exchange cuando utiliza la opción Upload Files. Si utiliza las opciones Connect to GitHub o Link to an External Website, se permiten otros tipos de licencia para las contribuciones a la comunidad de usuarios. Algunas publicaciones realizadas por el personal de MathWorks, tales como paquetes de soporte de hardware, pueden estar sujetas a la licencia MathWorks Limited License. Las publicaciones de File Exchange bajo licencia contienen el enlace Ver licencia. Para más información, consulte la página de preguntas frecuentes sobre las licencias de File Exchange.

Instrucciones para citar su trabajo

Crear instrucciones ayuda a integrantes de la comunidad a citarlo correctamente cuando utilicen su trabajo en investigaciones u tareas derivadas. Tal vez desee que otras personas citen su página de detalles de File Exchange, un artículo de investigación que haya escrito, un grupo al que pertenezca o alguna combinación de artefactos.

Las nuevas entradas de File Exchange se crean con instrucciones para citar predeterminadas, que se pueden eliminar. Además, puede:

  • Especificar instrucciones para citar utilizando texto personalizado
  • Especificar un identificador de objeto digital (DOI), que debe generar en otro lugar, como se explica en DOI.org
  • Crear varias instrucciones para citar

Búsqueda de archivos

File Exchange ofrece una extensa biblioteca de archivos online. Para encontrar archivos, puede:

  • Explorar un tipo de contenido asignado
  • Realizar búsquedas
  • Ajustar la precisión de las búsquedas con directivas 

Cuando encuentre un archivo, puede abrirlo para ver los detalles, agregar etiquetas, evaluaciones y comentarios, o bien descargarlo.

Búsqueda de archivos

Búsqueda de archivos relacionados con cálculo numérico. Observe las distintas categorías y filtros a la izquierda.

Exploración de distintos tipos de contenido

File Exchange asigna tipos de contenido a los archivos en función de la información en la publicación.

Tipo de contenido asignado Extensión del archivo Criterios de publicación

App

.mlappinstall

-

Controlador

.mdd

-

Ejemplo

.m

Archivo .html del subdirectorio /html con el mismo nombre que el archivo .m de MATLAB

Función

.m

Llamada a función

Modelo de Simulink

.mdl

-

Vídeo

.avi, .mp4, .wmv, .mpg, .mov, .swf, .mpeg

-

 

Consejo: Si publica un archivo y aparece el mensaje Preview image not found en lugar de una imagen de vista previa, agregue una imagen con el mismo nombre de archivo que el código en el mismo directorio, y File Exchange mostrará la imagen junto con el archivo. Ejemplo: Si tiene un archivo llamado “foo.mdl” y agrega una captura de pantalla llamada foo.gif, los usuarios verán la captura de pantalla del modelo de Simulink en lugar de este mensaje.

Imagen de vista previa no encontrada

Información sobre licencias

Las licencias asignan los derechos de autor y de usuario del código disponible en File Exchange. En las licencias se detalla cómo se puede utilizar el archivo y se abordan preguntas frecuentes acerca de los derechos de modificación, distribución y uso comercial.

La licencia BSD es la única licencia compatible con el código publicado directamente en File Exchange y se agrega automáticamente al contenido de la comunidad de usuarios que se publica directamente en File Exchange cuando utiliza la opción Upload Files. Si utiliza las opciones Connect to GitHub o Link to an External Website, se permiten otros tipos de licencia para las contribuciones a la comunidad de usuarios. Algunas publicaciones realizadas por el personal de MathWorks, tales como paquetes de soporte de hardware, pueden estar sujetas a la licencia MathWorks Limited License. Las publicaciones de File Exchange bajo licencia contienen el enlace Ver licencia. Para más información, consulte la página de preguntas frecuentes sobre las licencias de File Exchange.


Búsqueda de archivos con directivas

Las directivas de búsqueda ayudan a encontrar archivos en File Exchange. Puede especificar directivas de búsqueda en el cuadro de búsqueda.

Resultado de la búsqueda Directiva Ejemplos

Autor con este nombre

author:

author:stuart
author:"Stuart McGarrity"

Autor con una media de evaluación de archivo de 1 a 5

authoraverage:

authoraverage:5

Integrante de la comunidad con el nombre de esta empresa/organización en su perfil público

organization:

organization:mathworks

Tipo de contenido

type:

type:function

Número de identificación del archivo, que aparece en la parte superior de la página File Details

id:

id:21832

Licencia que incluye esta cadena

license:

license:bsd

Evaluación media de los integrantes de la comunidad con este número

rating:

rating:5

Etiquetas con este nombre aplicada a las publicaciones

tag:

tag:statistics
tag:"image processing"

Búsqueda de archivos con tipo de cita DOI o personalizada

citation_type:

citation_type:doi

citation_type:custom

Uso de directivas

  • Para buscar frases de varias palabras, enciérrelas entre comillas; por ejemplo, author:"Helen Chen".
  • Para limitar los resultados de búsqueda, utilice combinaciones de directivas en la misma búsqueda. Asegúrese de incluir un espacio entre cada directiva. File Exchange buscará todos los archivos que coincidan con todas las directivas especificadas.
  • Para buscar más de un valor para la misma directiva, especifique una directiva para cada valor. Por ejemplo, la sintaxis tag:graphics tag:vector busca todos los archivos etiquetados a la vez con graphics y vector.
  • Para excluir archivos de los resultados de búsqueda, inserte un signo menos (-) antes de la sintaxis de la directiva. Por ejemplo, la sintaxis -tag:game excluye todos los archivos que tengan la etiqueta game.

Etiquetado de archivos

Las etiquetas proporcionan información de marcador para ayudar a encontrar o recuperar archivos de interés. Con las etiquetas, puede explorar los archivos publicados utilizando las palabras clave asignadas. Los integrantes de la comunidad que tengan perfiles pueden etiquetar cualquier archivo. Todas las etiquetas son públicas y todos pueden verlas.

Desde su perfil, puede ver las etiquetas que haya aplicado a los archivos. Dentro de un archivo, se pueden ver las etiquetas aplicadas por todos los integrantes de la comunidad. Cuando asigna etiquetas, otros integrantes de la comunidad pueden ver información sobre sus intereses, lo que facilita la colaboración y el intercambio de ideas. 

Puede agregar etiquetas cuando publica nuevos archivos o ve los ya existentes. Use comas para separar varias etiquetas y comillas para etiquetas que consten de varias palabras.

Creación de etiquetas

  • Cree etiquetas descriptivas y concisas.
  • Utilice la misma terminología e incluya palabras de uso común, por ejemplo, vídeos, imágenes y gráficos.
  • Etiquete elementos dignos de atención, tales como conceptos, funciones y nombres propios.
  • Es preferible usar sustantivos en lugar de verbos.
  • No utilice abreviaturas ni acrónimos, a menos que sean bien conocidos.
  • Compruebe la ortografía.

Reseñas

Puede otorgar una calificación entre una y cinco estrellas (de menor a mayor) a los archivos. Cuando evalúe archivos, agregue detalles que respalden su calificación y comparta notas con el autor y otros integrantes de la comunidad.

 

Adición de reseñas a archivos publicados.

Adición de reseñas a archivos publicados.

Adición de reseñas a archivos

  • Demuestre honestidad y consideración en sus comentarios, para con el autor del archivo y los integrantes de la comunidad.
  •  
  • Proporcione información concreta sobre lo que le gusta y lo que no le gusta.
  • Utilice ejemplos para ilustrar sus argumentos.
  • Comparta sus experiencias con otras publicaciones similares.
  • Tenga en cuenta que se eliminarán los comentarios blasfemos, vulgares u ofensivos.

Conversaciones

Intercambie preguntas, respuestas o comentarios con otros integrantes de la comunidad. Puede utilizar los comentarios para agradecer las respuestas a sus preguntas, u ofrecer comentarios útiles.

 

Adición de conversaciones a archivos publicados.

Adición de conversaciones a archivos publicados.

Consejos para conversaciones fructíferas

  • Comience una conversación para aclarar dudas, respuestas o comentarios.
  • Escriba comentarios pertinentes y breves.
  • Demuestre honestidad y consideración en todas las respuestas para con todos los colaboradores.
  • Tenga en cuenta que se eliminarán las respuestas blasfemas, vulgares u ofensivas.

Obtención de reconocimiento

File Exchange determina qué archivos son más populares en función del mayor número de descargas en los últimos 30 días. Cuanto más populares sean sus archivos, más reconocimiento obtendrá por parte de los integrantes de la comunidad.

Recuento de descargas

Para reflejar con precisión las descargas realizadas por los usuarios, File Exchange cuenta varias descargas desde la misma dirección IP como una sola descarga.


Obtención de insignias

Puede obtener insignias participando en File Exchange. Todas las insignias que obtenga aparecerán en su página de perfil de comunidad.

Estos son algunos ejemplos de insignias que puede obtener:

  • Primera publicación
  • Primera reseña
  • Preferencia del editor
  • Mejor descarga personal
  • … y muchas más

Consulte la página de insignias para ver qué tipo de insignias puede obtener.


Fórjese una reputación

Como recompensa por contribuir y participar activamente en File Exchange, puede obtener puntos. La cantidad de puntos depende de las acciones que realice. Cuantos más puntos, mayor reputación.

Si... Puntos otorgados

Su publicación aparece en el blog "Pick of the Week"

+50 puntos

Su publicación obtiene una insignia anual

+50 puntos

Su publicación recibe una evaluación de 5 estrellas

+5 puntos

Su publicación recibe una evaluación de 4 estrellas

+4 puntos

Su publicación se descarga 10 veces

+1 punto si la publicación no se ha actualizado en los últimos 3 meses

+2 puntos si la publicación se ha actualizado en los últimos 3 meses

Consulte la tabla clasificatoria para comprobar quién tiene la mejor reputación.


Preguntas y comentarios

Si tiene preguntas o comentarios relacionados específicamente con File Exchange, utilice este foro de comentarios. Seleccione "MATLAB Central" como categoría. Las preguntas y los comentarios que tengan relación con la funcionalidad de una determinada publicación en File Exchange se pueden abordar a través de comentarios o conversaciones dentro de la misma publicación.

Obtenga respuestas a preguntas sobre MATLAB y Simulink de integrantes expertos de la comunidad en MATLAB Answers. Si necesita ayuda adicional con licencias u otros productos y servicios de MathWorks, comuníquese con el servicio de asistencia.