application Chouette -

Transcription

1 CHOUETTE Maintenance, accompagnement et recette de logiciels pour les échanges de données multimodales application Chouette - Format d'échange de courses V25 Auteurs : Relecteurs Michel ETIENNE (CityWay) Patrick GENDRE (CEREMA), Jean SENG (AFIMB) Novembre 2014 Résumé : CHOUETTE est un logiciel libre développé à l'initiative du ministère français chargé des transports (et du développement durable), dans le but de faciliter l'échange de données d'offre (théorique) de transport collectif (TC), en s'appuyant pour cela sur la norme NFP 99506, dite Neptune, qui spécifie un profil d'échange XML Les utilisateurs visés sont les collectivités locales Autorités Organisatrices de Transport (AOT), les exploitants des réseaux TC,et leurs prestataires (bureaux d'étude ou société de services) D'autres utilisateurs potentiels sont néanmoins identifiés : services de l'état, éditeurs de logiciels, opérateurs de services d'information, chercheurs Le présent document décrit le format d'échange de courses Agence française pour l'information multimodale et la billettique

2 Informations sur ce document : Organisme commanditaire : AFIMB Titre : Format d'échange de courses Organismes auteurs CITYWAY CEREMA DT Med Rédacteurs Michel ETIENNE Participants Patrick GENDRE Jean SENG Maitre d'ouvrage AFIMB Mots clés : information multimodale, application Chouette, courses, Excel Diffusion : publique (licence Creative Commons CC-by-nd ) Nombre de pages : 8 pages Date Novembre 2014 Confidentialité : Non Bibliographie : Oui Historique des versions / révisions : Version Date d application Description des changements Auteur 25 24/11/14 Première version Michel Etienne

3 Table des matières 1Introduction4 2Modèle de données4 3Prérequis5 4Généralités du format5 5courses_ncsv6 6Calendrierscsv8

4 1 INTRODUCTION Ce document présente le format d'import massif de courses et le résultat dans Chouette Ce format spécifique au logiciel Chouette nécessite des étapes préalables dans Chouette avant de pouvoir être utilisé 2 MODÈLE DE DONNÉES Le modèle de données fait intervenir 6 objets de la base Chouette : les arrêts physiques (de type Point d'embarquement ou Quai) les lignes de transport les séquences d'arrêt (succession d'arrêts pouvant être desservis par un ensemble de courses dans un même sens les missions (sous-ensemble des séquences d'arrêts effectivement desservis par une même course) les courses (horaires de desserte d'une mission pour un véhicule donné Les calendriers (jours d'application des courses) Les arrêts physiques sont les éléments de la topologie sur lesquels les courses «accrochent» leurs horaires En général, sur un lieu géographique donné, il y a 2 arrêts physiques correspondant au point de desserte dans chaque sens de circulation d'une ligne Un même arrêt physique peut être partagé par plusieurs lignes Les lignes de transport sont un ensemble de trajets Aller-Retour connus sous la même appellation commerciale Les séquences d'arrêts représentent la liste des arrêts potentiellement desservis dans un sens donné par un véhicule ; un même arrêt physique peut apparaître plusieurs fois dans la séquence lorsque le trajet est circulaire ou comporte des boucles Les missions représentent la liste des arrêts réellement desservis par un véhicule pour une course spécifique Les courses représentent la liste des horaires de passage d'un véhicule pour une heure de départ fixe Les calendriers représentent la liste des jours pour lesquels la course est effectuée

5 Une ligne est donc composée de une ou plusieurs séquences d'arrêts ordonnant des passages à des arrêts physiques, ces séquences sont composées d'une ou plusieurs missions utilisant tout ou partie de ces arrêts Chaque mission dispose alors de courses précisant les horaires de passage aux arrêts pour chaque véhicule en circulation 3 PRÉREQUIS Avant de pouvoir importer des courses dans la base, il est nécessaire de définir les objets périphériques associés : les arrêts, les lignes, les séquences d'arrêts, les calendriers 4 GÉNÉRALITÉS DU FORMAT Les fichiers sont au format CSV encodés en UTF-8 (voir option du format dans les paramètres EXCEL ou CALC) Le séparateur de colonnes est le point-virgule A l'export, ces fichiers sont au nombre de 2 par export : -courses d'une séquence d'arrêts : courses_ncsv (n étant l'identifiant base de la séquence d'arrêts) -calendriers disponibles dans la base : calendrierscsv A l'import, seul le fichier des courses est exploité

6 5 COURSES_NCSV Le fichier sous Excel doit prendre l'apparence suivante (non coloré), dont les colonnes mises ici en rose sont non modifiables Id course (vide si nouvelle) Information course 1 Information course 2 Information course n numéro Identifiant véhicule PMR (O(ui) N(on) vide si inconnu) TAD (O(ui) N(on) vide si inconnu) calendriers id arrêt nom arrêt 25 Arrêt 1 45 Arrêt 2 41 Arrêt n-1 56 Arrêt n Page 6/8

7 Chaque course occupe une colonne ; les cases à remplir sont : Case Description Note Id course (vide si nouvelle) Identifiant de la course exportée, ne pas modifier Si cette valeur est maintenue avec le reste de la colonne vide, l'import supprimera la course Si la case est vide, une nouvelle course sera créée numéro Numéro de course Valeur numérique positive ou nulle Identifiant véhicule Valeur libre Utilisé comme identifiant fonctionnel en relation avec la billetique PMR (O(ui) N(on) vide si inconnu) Indicateur d'accessibilité PMR TAD (O(ui) N(on) vide si inconnu) Course en TAD Oui force une course en TAD sur une ligne régulière Non force en régulier sur une ligne en TAD laisser vide dans les autres cas calendriers code calendrier1, code calendrier 2, Les codes doivent être séparés par une virgule Liste des codes des calendriers à appliquer à la course Ces codes sont définis dans le fichier calendrierscsv produit à l'export nom arrêt Non utilisé À laisser vide Arrêt x Horaire à l'arrêt de rang x de la séquence (format hh:mm) À laisser vide sur les arrêts non desservis par la course Page 7/8

8 6 CALENDRIERSCSV Ce fichier contient la définition et les codes des calendriers disponibles dans la base Colonne Description Note code Code du calendrier À utiliser pour l'associer à une course nom étiquettes Nom tel qu'il a été saisi dans Chouette Liste des étiquettes début Date de début Premier jour effectif du calendrier fin Date de fin Dernier jour effectif du calendrier Types de jour Jours de semaine actifs pour les périodes Codes abrégés sur 2 caractères Périodes Liste des périodes [début période fin période] [] Jours particuliers Listes des jours actifs hors période Liste de dates Jours exclus Liste des jours à exclure sur les périodes Liste de dates Page 8/8