New station file structure. Doc with all antennas

app.py

@@ -55,7 +55,8 @@ current_directory = path.dirname(path.realpath(__file__))
 # iers.IERS.iers_table = iers.IERS_A.open(iers.IERS_A_URL)
 # iers.Conf.iers_auto_url.set('ftp://cddis.gsfc.nasa.gov/pub/products/iers/finals2000A.all')
 
-all_antennas = fx.get_stations_from_file(f"{current_directory}/data/station_location.txt")
+# all_antennas = fx.get_stations_from_file(f"{current_directory}/data/station_location.txt")
+all_antennas = fx.get_stations_from_configfile(f"{current_directory}/data/stations_catalog.inp")
 sorted_networks = {'EVN': 'EVN: European VLBI Network', 'eMERLIN': 'eMERLIN (out-stations)',
                    'VLBA': 'VLBA: Very Long Baseline Array',
                    'LBA': 'LBA: Australian Long Baseline Array',
@@ -85,8 +86,8 @@ for a_array in default_arrays:
         assert a_station in all_antennas.keys()
 
 doc_files = {'About this tool': '/doc/doc-contact.md',
-             'Technical background': '/doc/doc-estimations.md',
-             'About the antennas': '/doc/doc-antennas.md'}
+             'About the antennas': '/doc/doc-antennas.md',
+             'Technical background': '/doc/doc-estimations.md'}
 
 # Initial values
 target_source = observation.Source('1h2m3s +50d40m30s', 'Source')
@@ -128,6 +129,34 @@ def tooltip(message, idname, trigger='?', placement='right', **kwargs):
                         # className='tooltip-class', #innerClassName='tooltip-class-inner',
                         **kwargs)]
 
+def antenna_card(station):
+    """Generates a card showing the basic information for the given station
+    """
+    s = lambda st : st[::-1].replace(' ,',' dna ',1)[::-1]
+    card = dbc.Card([
+        dbc.CardImg(src=app.get_asset_url(f"ant-{station.name.replace(' ','_').lower()}.jpg"),
+                    top=True, className='card-img'),
+        dbc.CardBody([
+            html.H4(station.name, className='card-title'),
+            html.H6(station.fullname if station.fullname != station.name else '',
+                    className='card-title2'),
+            html.H6(station.country, className='card-subtitle'),
+            # html.P(f"🇦 Participates in {station.all_networks}.\n"
+            dcc.Markdown(f"Listed for the {s(station.all_networks)}.\n" if \
+                          station.all_networks != '' else '', className='card-text'),
+            dcc.Markdown("Can observe at "
+                         f"{', '.join([i.replace('cm', '') for i in station.bands])} cm.",
+                         className='card-text')
+            ])
+        ], className='card-antenna')
+    return card
+
+def antenna_cards():
+    cards = dbc.Row([antenna_card(s) for s in all_antennas],
+            className='row justify-content-center')
+    return cards
+
+
 
 def create_accordion_card(title, text, id, is_open=True):
     """Given a title (header) and a text (which can be either text, a dcc/html object),
@@ -153,9 +182,14 @@ def get_doc_text():
                 i0 = parsed_text.index('{src:')
                 i1 = i0 + parsed_text[i0:].index('}')
                 filename = parsed_text[i0+5:i1]
-                parsed_text = parsed_text.replace( parsed_text[i0:i1+1], app.get_asset_url(filename) )
-
-            temp += [create_accordion_card(a_topic, dcc.Markdown(parsed_text), id=str(i))]
+                parsed_text = parsed_text.replace( parsed_text[i0:i1+1],
+                                                   app.get_asset_url(filename) )
+
+            if a_topic == 'About the antennas':
+                temp += [create_accordion_card(a_topic,
+                    [dcc.Markdown(parsed_text), antenna_cards()], id=str(i))]
+            else:
+                temp += [create_accordion_card(a_topic, dcc.Markdown(parsed_text), id=str(i))]
 
     return html.Div(temp, className='col-12 accordion')
 

assets/style.css

@@ -3563,6 +3563,53 @@ img[alt=equation2] {
     margin-bottom: 1rem;
 }
 
+
+
+.card.card-antenna {
+    background-color: white !important;
+    min-width: 12rem;
+    max-width: 12rem;
+    font-size: 0.8rem;
+    border: 1px solid #a01d26 !important;
+    /* text-align: left; */
+    /* text-color: #a01d26; */
+    /* border: none; */
+    /* outline: none; */
+    /* border: 1px solid #CCCCCC; */
+    margin: 8px;
+}
+
+.card.card-antenna .card-img {
+    min-height: 40%;
+    height: 40%;
+    min-width: 100%;
+    overflow: hidden;
+}
+.card.card-antenna .card-title {
+    font-size: 1rem;
+    margin-bottom: 0.3rem;
+}
+
+.card.card-antenna .card-title2 {
+    font-size: 0.9rem;
+}
+
+.card.card-antenna .card-subtitle {
+    color: #CCCCCC;
+    font-size: 0.8rem;
+    margin-bottom: 0.5rem;
+}
+
+.card.card-antenna .card-body {
+    padding: 0.9rem;
+}
+
+.card.card-antenna .card-body p {
+    margin-top: 0px;
+    margin-bottom: 0px;
+}
+
+
 /* .accordion button:after { */
 /*   content: '\02795'; /* Unicode character for "plus" sign (+) */ */
 /*   font-size: 13px; */

data/station_location.txt

@@ -1,73 +0,0 @@
-station         code     network x               y              z        SEFD-92 SEFD-49 SEFD-30 SEFD-21 SEFD-18 SEFD-13 SEFD-6 SEFD-5 SEFD-3.6 SEFD-1.3 SEFD-0.7 SEFD-0.3 SEFD-0.1
-Badary          Bd       EVN -838201.0685    3865751.5652   4987670.8885    -1       -1       -1       330      330      330      200     -1      200       710       -1    -1  -1
-Effelsberg      Ef       EVN 4033947.2616    486990.7943    4900431.0017    600      600      65       20       19       300      20      25      20        70        200    -1  -1
-Brewster        Br       VLBA -2112065.2062   -3705356.5048  4726813.6759    2742     2744     -1       289      314      347      210     278     327       543       640   -1  -1
-Fort_Davis      Fd       VLBA -1324009.3266   -5332181.9547  3231962.3949    2742     2744     -1       289      314      347      210     278     327       543       640   -1  -1
-Green_Bank      Gb       VLBA 882589.4102     -4924872.3416  3943729.4062    35       24       13       10       10       12       13      13      15        20        30   -1  -1
-Hartebeesthoek  Hh       EVN 5085442.7637    2668263.7913   -2768696.7523   -1       -1       -1       -1       430      410      650     700     630       1800      -1   -1  -1
-Hancock         Hn       VLBA 1446374.8658    -4447939.6774  4322306.1838    2742     2744     -1       289      314      347      210     278     327       543       640   -1  -1
-Hobart          Ho       LBA -3950237.3590   2522347.6804   -4311561.8790   -1       -1       -1       470      470      650      640     640     560       1200      1800   -1  -1
-Kitt_Peak       Kp       VLBA -1995678.8571   -5037317.7049  3357328.0174    2742     2744     -1       289      314      347      210     278     327       543       640   -1  -1
-Kunming         Km       EVN -1281152.8362   5640864.3586   2682653.4434    -1       -1       -1       -1       -1       350      17      17      480       -1        -1     -1  -1
-Los_Alamos      La       VLBA -1449752.5839   -4975298.5757  3709123.8459    2742     2744     -1       289      314      347      210     278     327       543       640   -1  -1
-Medicina        Mc       EVN 4461369.6954    919597.1240    4449559.3812    -1       -1       -1       490      700      400      170     840     320       700       -1     -1  -1
-Metsahovi       Mh       EVN 2892584.8489    1311715.5980   5512640.1545    -1       -1       -1       -1       -1       4500     -1      -1      3200      2608      4500   -1  -1
-Mauna_Kea       Mk       VLBA -5464075.1874   -2495248.1168  2148297.3643    2742     2744     -1       289      314      347      210     278     327       543       640   -1  -1
-North_Liberty   Nl       VLBA -130872.4987    -4762317.0925  4226851.0014    2742     2744     -1       289      314      347      210     278     327       543       640  -1  -1
-Noto            Nt       EVN 4934562.8407    1321201.5428   3806484.7336    -1       -1       -1       820      784      770      260     1100    770       800       900  -1  -1
-Onsala          On       EVN 3370965.8787    711466.1978    5349664.2006    -1       -1       900      350      350      1110     480     850     785       1200      1310   -1  -1
-OVRO            Ov       VLBA -2409150.4018   -4478573.1180  3838617.3385    2742     2744     -1       289      314      347      210     278     327       543       640   -1  -1
-Parkes          Pa       LBA -4554232.4864   2816758.8662   -3454035.0137   -1       -1       -1       40       40       30       110     110     43        370       810   -1  -1
-Pie_Town        Pt       VLBA -1640953.9383   -5014816.0237  3575411.7916    2742     2744     -1       289      314      347      210     278     327       543       640   -1  -1
-Sardinia        Sr       EVN 4865183.5420    791922.2550    4035136.0240    -1       -1       -1       67       67       -1       -1      50      -1        138       -1     -1  -1
-St._Croix       Sc       VLBA 2607848.6379    -5488069.5358  1932739.7326    2742     2744     -1       289      314      347      210     278     327       543       640  -1  -1
-Tianma          T6       EVN -2826708.6030   4679237.0770   3274667.5510    -1       -1       -1       39000    39000    46       26      26      48        70        120   -1  -1
-Shanghai        Sh       EVN -2831687.4273   4675733.4681   3275327.4971    -1       -1       -1       -1       670      800      720     1500    800       -1        -1   -1  -1
-Urumqi          Ur       EVN 228310.2129     4631922.7656   4367064.0638    -1       -1       -1       300      300      560      250     -1      350       850       -1   -1  -1
-Yebes           Ys       EVN 4848761.8027    -261484.1746   4123085.0529    -1       -1       -1       -1       -1       1400     160     160     200       200       480   -1  -1
-Zelenchukskaya  Zc       EVN 3451207.5353    3060375.4139   4391915.0384    -1       -1       -1       300      300      330      400     -1      200       710       -1   -1  -1
-JVLA_1          VLA      VLBA -1601185.4286   -5041977.1754  3554875.6231    3900     -1       -1       420      420      370      310     310     250       350       560  -1  -1
-JVLA_27         Y27      VLBA -1601185.4286   -5041977.1754  3554875.6231    167      -1       -1       17.9     17.9     15.8     13.2    13.2    10.7      15        23.9  -1  -1
-Robledo_70      Ro7      EVN 4849336.6927    -360488.7857   4114748.8272    -1       -1       -1       -1       35       20       -1      -1      18        83        -1    -1  -1
-Robledo_34      Ro3      EVN 4849336.6927    -360488.7857   4114748.8272    -1       -1       -1       -1       -1       150      -1      -1      106       -1        -1  -1  -1
-Arecibo         Ar       Other 2390486.9000    -5564731.4400  1994720.4500    12       -1       3        3.5      3        3        5       5       6         -1        -1  -1  -1
-Irbene          Ir       EVN 3183649.314     1276902.989    5359264.710     -1       -1       -1       -1       3600     -1       430     480     1300      -1        -1   -1  -1
-Jodrell_Bank    Jb2      EVN 3822846.7600    -153802.2800   5086285.9000    -1       -1       -1       350      320      -1       320     300     -1        910       -1   -1  -1
-Lovell          Jb1      EVN 3822626.0400    -154105.6500   5086486.0400    132      83       -1       36       65       -1       80      -1      -1        -1        -1   -1  -1
-Torun           Tr       EVN 3638558.5100    1221969.7200   5077036.7600    -1       -1       2000     250      300      -1       220     650     -1        500       -1   -1  -1
-Westerbork      Wb       EVN 3828767.2647    442446.1739    5064921.5700    2100     -1       1680     420      560      840      1680    1600    1680      -1        -1   -1  -1
-ATCA            ATCA     LBA -4751639.85972  2791700.35670  -3200491.11339  -1       -1       -1       68       68       106      70      70      86        106       180  -1  -1
-Svetloe         Sv       EVN 2730173.6723    1562442.7934   5529969.1413    -1       -1       -1       360      360      330      250     -1      200       710       -1  -1  -1
-Tidbinbilla-70  Td       LBA -4460895.2445   2682361.5103   -3674747.5813   -1       -1       -1       -1       23       16       -1      -1      25        -1        60  -1  -1
-Warkworth       Ww       LBA -5115324.4279   477843.2969    -3767192.8344    -1      -1       -1      3400     -1        -1      -1      3800     -1      -1         -1    -1  -1
-Katherine       Ka       LBA -4147354.6913  4581542.3772    -1573303.1565   -1      -1       -1       5000     -1        -1      -1      4000     -1      -1         -1    -1  -1
-Yarragadee      Ya       LBA -2388896.1890  5043350.0019    -3078590.8037   -1      -1       -1       4000     -1        -1      -1      3500     -1      -1         -1    -1  -1
-Cambridge       Cm       eMERLIN 3920356.1500    2542.0200   5014284.4200  -1      -1       -1       200      175      -1       175     225     -1        720       -1    -1  -1
-Darnhall        Da       eMERLIN 3829087.8990 -169568.9550   5081082.3460  -1      -1       -1       450      450       -1      325     325     -1        720       -1    -1  -1
-Defford         De       eMERLIN 3923442.5660 -146914.3300   5009755.1250  -1      -1       -1       350      350       -1     1000    1600     -1        720       -1    -1  -1
-Knockin         Kn       eMERLIN 3860084.8980 -202105.0390   5056568.8480  -1      -1       -1       425      400       -1      325     325     -1        720       -1    -1  -1
-Pickmere        Pi       eMERLIN 3817549.9560 -163031.1410   5089896.6540  -1      -1       -1       400      450       -1      325     325     -1        720       -1   -1  -1
-Ceduna          Cd       LBA -3753442.7457   3912709.7530   -3348067.6095   -1       -1       -1       1000     1000     400      450     550     600       750       2500  -1  -1
-Mopra           Mo       LBA -4682769.05850  2802619.04217  -3291759.33837  -1       -1       -1       240      240      530      350     350     430       1300      675  -1  -1
-Yonsei          Ky       KVN -3042280.9035   4045902.6564   3867374.3087    -1       -1       -1       -1       -1       -1       -1      -1      -1        1288      1919  -1  -1
-Ulsan           Ku       KVN -3287268.5430   4023450.1448   3687379.9675    -1       -1       -1       -1       -1       -1       -1      -1      -1        1288      1919  -1  -1
-Tamna           Kt       KVN -3171731.5532   4292678.5258   3481038.7679    -1       -1       -1       -1       -1       -1       -1      -1      -1        1288      1919  -1  -1
-ASKAP           ASKAP    Other -2556743.707    5097440.315    -2847749.657    -1       -1       -1       6000     6000     -1       -1      -1      3500      -1        -1  -1  -1
-Wettzell        Wz       EVN 4075627.6441    931774.2773    4801552.3784    -1       -1       -1       -1       -1       1250     -1      -1      750       -1        -1    -1  -1
-SKA1_MID        SKA      Other -2556743.707    5097440.315    -2847749.657    -1       -1       -1       3        3        -1       -1      -1      -1        -1        -1  -1  -1
-Kuntunse        Nk       Other 6346273.5210    -33779.7127    634844.9454     -1       -1       -1       -1       -1       -1       1200    -1      -1        -1        -1  -1  -1
-Dwingeloo       Dw       Other 3839348.9730    430403.5100    5057990.0990    -1       -1       -1    6000      -1         -1       -1    -1      -1        -1        -1  -1  -1
-FAST            Fa       Other -1668526.98 5506738.85 2744897.69  8        -1      2        1.95     1.95      -1        -1       -1     -1       -1         -1  -1  -1
-Matera          Ma       Other 4641938.4489   1393003.3339    4133325.7916  -1        -1     -1        -1       -1      1000      -1       -1     1000      -1         -1  -1  -1
-Alesund         Ny       Other 1202462.5055    252734.5174    6237766.2210  -1        -1     -1       -1         -1      850     -1       -1      1255     -1          -1  -1  -1
-Pico_Veleta     Pv       Other 5088967.9000   301681.6000      3825015.8000 -1        -1     -1       -1       -1         -1    -1        -1      -1      -1        -1   640  1160
-P._de_Bure      PdB      Other 4524000.430   468042.140  4460309.760      -1          -1     -1        -1      -1         -1    -1        -1       -1      -1      -1    450  4299
-GMRT            GMRT     Other 1656988.9135   5797576.2281   2073756.22   55         59     53        47      -1         -1      -1       -1      -1     -1       -1    -1   -1
-ALMA            ALMA     Other 2225061.164 -5440057.370 -2481681.151         -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1      75    85
-LMT             LMT      Other -768715.632 -5988507.072  2063354.852        -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1  1714  3536
-SMA             SMA      Other  -1828790.81 -5054428.74 3427884.59          -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1  2374
-JCMT            JCMT     Other -5464559.08 -2492999.13 2150638.19 -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1  3842
-SMT             SMT      Other -1828790.81 -5054428.74 3427884.59 -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1  9057 
-APEX            APEX     Other 2225213.22 -5441629.65 2478102.85   -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1  4977
-South_Pole_T.   SPT      Other  0.0 0.0 -6359552.31424518       -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1    -1  7497
-

doc/doc-antennas.md

@@ -16,6 +16,11 @@ In the case of ALMA we consider the participation of all 37 telescopes that can
 
 
 
+#### Brief summary from all antennas
+
+A brief summary of all antennas can be shown in the following. Note that all images have been obtained from [Wikimedia Commons](https://commons.wikimedia.org/wiki/Main_Page).
+
+
 
 
 

doc/notes.md

@@ -39,13 +39,17 @@ Layout:
 Station
     - observer : Observer
     - name : str
+	- fullname : str
+	- country : str
+	- all_networks : str
     - codename : str
     - network : str
     - location : EarthLocation
     - bands : list
     - sefds : dict
     - min_elevation
-    + __init__(name, codename, location, freqs_sefds, min_elevation=20)
+    + __init__(name, codename, location, freqs_sefds, min_elevation=20, fullname=None,
+all_networks=None, country=None)
     + elevation(obs_times, target) --> ndarray
     + is_visible(obs_times, target) --> ndarray of bool?
     + has_band(band) --> bool

src/functions.py

@@ -1,6 +1,7 @@
 """Different functions that are required to operate the program
 """
 
+import configparser
 from astropy import coordinates as coord
 from astropy import units as u
 from astropy.io import ascii
@@ -89,6 +90,47 @@ def get_stations_from_file(filename='data/station_location.txt'):
     return networks
 
 
+def get_stations_from_configfile(filename='data/stations_catalog.inp'):
+    """Retrieves the information concerning all stations available in the 'filename'
+    file. Creates a Stations object containing the stations and the information on it.
+    The file must have a format readable by the Python ConfigParser.
+    Each section will be named with the name of the station, and then it must have
+    the following keys:
+    station - full name of the station.
+    code - codename for the station (typically two letters).
+    network - main network to which it belongs to.
+    possible_networks - all networks the station can participate in (including 'network')
+    country - country where the station is located.
+    position = x, y, z (in meters). Geoposition of the station.
+    min_elevation (in degrees) - minimum elevation the station can observe.
+    SEFD_**  - SEFD of the station at the **cm band. If a given band is not present,
+                it is assumed that the station cannot observe it.
+    [optional]
+    img - a path to an image of the station.
+    link - a url linking to the station page/related information.
+    """
+    config = configparser.ConfigParser()
+    config.read(filename)
+    networks = stations.Stations('network', [])
+    for stationname in config.sections():
+        temp = [float(i.strip()) for i in config[stationname]['position'].split(',')]
+        a_loc = coord.EarthLocation(temp[0]*u.m, temp[1]*u.m, temp[2]*u.m)
+        # Getting the SEFD values for the bands
+        min_elev = float(config[stationname]['min_elevation'])*u.deg
+        sefds = {}
+        for akey in config[stationname].keys():
+            if 'SEFD_' in akey.upper():
+                sefds[f"{akey.upper().replace('SEFD_', '').strip()}cm"] = \
+                                    float(config[stationname][akey])
+        new_station = stations.SelectedStation(stationname, config[stationname]['code'],
+                config[stationname]['network'], a_loc, sefds, min_elev,
+                config[stationname]['station'], config[stationname]['possible_networks'],
+                config[stationname]['country'])
+        networks.add(new_station)
+
+    return networks
+
+
 def stations_with_band(networks, band, output_network_name=None):
     """For a given collection of networks or Stations, returns a Stations object
     including all stations that can observe at the given band.

src/stations.py

@@ -8,7 +8,8 @@ from astroplan import Observer
 
 class Station(object):
 
-    def __init__(self, name, codename, network, location, freqs_sefds, min_elevation=20*u.deg):
+    def __init__(self, name, codename, network, location, freqs_sefds, min_elevation=20*u.deg,
+                 fullname=None, all_networks=None, country=''):
         """Initializes a station. The given name must be the name of the station that
         observes, with the typical 2-letter format used in the EVN (with exceptions).
 
@@ -27,6 +28,12 @@ class Station(object):
         - min_elevation : Quantity
             Minimum elevation that the station can observe a source. If no units
             provided, degrees are assumed. By default it 20 degrees.
+        - fullname : str [OPTIONAL]
+            Full name of the station. If not given, `name` is assumed.
+        - all_networks : str [OPTIONAL]
+            Networks where the station can participate (free style).
+        - country : str [OPTIONAL]
+            Country where the station is placed.
         """
         self.observer = Observer(name=name.replace('_', ' '), location=location)
         self._codename = codename
@@ -37,6 +44,18 @@ class Station(object):
         else:
             self._min_elev = min_elevation
 
+        if fullname is None:
+            self._fullname = name
+        else:
+            self._fullname = fullname
+
+        if all_networks is None:
+            self._all_networks = network
+        else:
+            self._all_networks = all_networks
+
+        self._country = country
+
 
     @property
     def name(self):
@@ -50,12 +69,26 @@ class Station(object):
         """
         return self._codename
 
+    @property
+    def fullname(self):
+        return self._fullname
+
     @property
     def network(self):
         """Name of the network to which the station belongs.
         """
         return self._network
 
+    @property
+    def all_networks(self):
+        """Name of all networks to which the station belongs.
+        """
+        return self._all_networks
+
+    @property
+    def country(self):
+        return self._country
+
     @property
     def location(self):
         """Location of the station in EarthLocation type.
@@ -133,10 +166,10 @@ class Station(object):
 
 class SelectedStation(Station):
     def __init__(self, name, codename, network, location, freqs_sefds, min_elevation=20*u.deg,
-                selected=True):
+                 fullname=None, all_networks=None, country='', selected=True):
         self._selected = selected
         super().__init__(name, codename, network, location, freqs_sefds,
-                                            min_elevation=min_elevation)
+                         min_elevation, fullname, all_networks, country)
 
     @property
     def selected(self):