@@ -756,7 +756,8 @@ def available_auxiliaries(self):
756756 return self ._available ["auxiliaries" ]
757757
758758 def available_observatories (
759- self , collection = None , start_time = None , end_time = None , details = False
759+ self , collection , start_time = None , end_time = None ,
760+ details = False
760761 ):
761762 """Get list of available observatories from server.
762763
@@ -780,8 +781,9 @@ def available_observatories(
780781 )
781782
782783 Args:
783- collection (str): collection name (e.g. `"SW_OPER_AUX_OBSM2_"`)
784- custom_model (str): as with set_products
784+ collection (str): OBS collection name, e.g. "SW_OPER_AUX_OBSM2_"
785+ start_time (datetime / ISO_8601 string)
786+ end_time (datetime / ISO_8601 string)
785787 details (bool): returns DataFrame if True
786788
787789 Returns:
@@ -822,6 +824,7 @@ def _csv_to_df(csv_data):
822824 else :
823825 start_time , end_time = None , None
824826
827+ self ._detect_AUX_OBS ([collection ])
825828 response = _request_get_observatories (collection , start_time , end_time )
826829 df = _csv_to_df (response )
827830 if details :
@@ -838,20 +841,20 @@ def _detect_AUX_OBS(self, collections):
838841 # Output notification for each of aux_type
839842 for aux_type in ["AUX_OBSH" , "AUX_OBSM" , "AUX_OBSS" ]:
840843 if aux_type in collection_types_requested :
841- tqdm .write (
842- dedent (
843- f"""
844+ output_text = dedent (f"""
844845 Accessing INTERMAGNET and/or WDC data
845846 Check usage terms at { DATA_CITATIONS .get (aux_type )}
846- """
847- )
848- )
847+ """ )
848+ if aux_type == "AUX_OBSH" :
849+ output_text += "WARNING: AUX_OBSH is not yet public"
850+ tqdm .write (output_text )
849851
850- def set_collection (self , * args ):
852+ def set_collection (self , * args , verbose = True ):
851853 """Set the collection(s) to use.
852854
853855 Args:
854856 (str): one or several from .available_collections()
857+ verbose (bool): Notify if special data terms
855858
856859 """
857860 collections = [* args ]
@@ -867,7 +870,8 @@ def set_collection(self, *args):
867870 "Check available with SwarmRequest().available_collections()"
868871 .format (collection )
869872 )
870- self ._detect_AUX_OBS (collections )
873+ if verbose :
874+ self ._detect_AUX_OBS (collections )
871875 self ._collection_list = collections
872876 self ._request_inputs .set_collections (collections )
873877 return self
0 commit comments