La extensión de la interfaz de programación de aplicaciones (API) de Aimsun Next puede implementarse mediante un script de Python. Este script de Python es un archivo ASCII (con extensión: “.py“), que puede editarse en cualquier editor de texto. Este script de Python se proporciona con el software Aimsun Next en la carpeta Aimsun_Next_installation_folder (haz clic con el botón derecho del ratón en el acceso directo de Aimsun Next > Selecciona “Abrir ubicación del archivo”).
- Copia-pega el archivo py de Aimsun_Next_installation_folder/programming/Aimsun Next API/python/samples/Micro OR Meso/sample.py en el directorio de trabajo (se recomienda colocarlo en el mismo directorio que el archivo ANG para que Aimsun Next pueda reconocer automáticamente las rutas relativas si se mueve a un directorio diferente.
- Copia-pega el archivo py de Aimsun_Next_installation_folder/programming/Aimsun Next API/python/private/Micro OR Meso/AAPI.py en el mismo directorio donde se encuentra el archivo sample.py.
- Puedes guardar el archivo de script de Python (py) con el nombre que prefieras. Guarda el archivo sample.py como archivo de reserva por si necesitas codificar otra API.
- Abre el archivo de script de Python renombrado. En la parte superior, se importa el módulo AAPI para permitir la interpretación de la función de C++ a Python. Este módulo funciona como interfaz entre el script de Python y Aimsun Next (intérprete con código y bibliotecas de Python). El módulo API de Aimsun Next Microscopic tiene siete funciones de alto nivel que se comunican entre el módulo API y el modelo de simulación: AAPILoad(), AAPIInit(), AAPISimulationReady(), AAPIManage(…), AAPIPostManage(…), AAPIFinish(), AAPIUnLoad(). También tiene ocho funciones adicionales que se llaman cuando se producen determinados eventos: AAPIEnterVehicle(…), AAPIExitVehicle(…), AAPIEnterVehicleSection(…), AAPIExitVehicleSection(…), AAPIPreRouteChoiceCalculation(…), AAPIVehicleStartParking(…), AAPIEnterPedestrian(…), AAPIExitPedestrian(…). Para más información sobre la API mesoscópica Aimsun Next, visita: Aimsun Next Manual > Aimsun Next API > Architecture > Simulation Management.
- Encuentra una lista completa de funciones documentadas en el Manual Aimsun Next para gestionar los planes de control, para aplicar cambios en las simulaciones microscópicas o mesoscópicas. Accede al Aimsun Next Manual > Aimsun Next API > Manage Control Plans/Microscopic Simulation/Mesoscopic Simulation. También encontrarás una instrucción paso a paso de cómo construir una API, así como explorar los ejemplos de API.
- Comienza a codificar –
- Para probar el estado de la codificación, carga la API en el Aimsun A continuación, abre un Escenario Dinámico
- Accede a la pestaña APIs de Aimsun Next
- Añade la py en las APIs de Aimsun Next y selecciónala.
- Pulsa OK y luego haz clic con el botón derecho del ratón en el Replication > Run Animated Simulation (for microscopic simulation). Ahora observa los mensajes impresos de tu código en la ventana de registro (para activar la ventana de registro, ve a Main Menu > Window > Windows > Log (o).