Skip to content

Commit

Permalink
DOC: updated docstrings
Browse files Browse the repository at this point in the history
Updated the description of `mock_download_dir` in the docstrings.
  • Loading branch information
aburrell committed Nov 27, 2023
1 parent eb36c5e commit 3ccc9a2
Show file tree
Hide file tree
Showing 21 changed files with 83 additions and 53 deletions.
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/methods/ace.py
Original file line number Diff line number Diff line change
Expand Up @@ -177,8 +177,9 @@ def download(date_array, name, tag='', inst_id='', data_path='', now=None,
Current universal time, if None this is determined for each
download. (default=None)
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
4 changes: 3 additions & 1 deletion pysatSpaceWeather/instruments/methods/general.py
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,9 @@ def get_local_or_remote_text(url, mock_download_dir, filename):
url : str
Remote URL where file is located
mock_download_dir : str or NoneType
If not None, directory where file is located
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Returns
-------
Expand Down
11 changes: 6 additions & 5 deletions pysatSpaceWeather/instruments/methods/gfz.py
Original file line number Diff line number Diff line change
Expand Up @@ -80,9 +80,9 @@ def json_downloads(date_array, data_path, local_file_prefix, local_date_fmt,
If true, selects only the definitive data, otherwise also includes
nowcast data (default=False)
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
(following the local file prefix and date format) as if they were
downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date (following the local
file prefix and date format) as if they were downloaded (default=None)
Raises
------
Expand Down Expand Up @@ -188,8 +188,9 @@ def kp_ap_cp_download(platform, name, date_array, tag, inst_id, data_path,
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date (following the local
file prefix and date format) as if they were downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/methods/lasp.py
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,9 @@ def prediction_downloads(name, tag, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date (following the local
file prefix and date format) as if they were downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/methods/lisird.py
Original file line number Diff line number Diff line change
Expand Up @@ -117,8 +117,9 @@ def download(date_array, data_path, local_file_prefix, local_date_fmt,
Dict of fill values to replace with NaN by variable name or None to
leave alone (default=None)
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date (following the local
file prefix and date format) as if they were downloaded (default=None)
Raises
------
Expand Down
30 changes: 18 additions & 12 deletions pysatSpaceWeather/instruments/methods/swpc.py
Original file line number Diff line number Diff line change
Expand Up @@ -41,8 +41,9 @@ def daily_dsd_download(name, today, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down Expand Up @@ -106,8 +107,9 @@ def old_indices_dsd_download(name, date_array, data_path, local_files, today,
today : dt.datetime
Datetime for current day
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down Expand Up @@ -394,8 +396,9 @@ def solar_geomag_predictions_download(name, date_array, data_path,
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down Expand Up @@ -570,8 +573,9 @@ def geomag_forecast_download(name, date_array, data_path,
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down Expand Up @@ -697,8 +701,9 @@ def kp_ap_recent_download(name, date_array, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down Expand Up @@ -810,8 +815,9 @@ def recent_ap_f107_download(name, date_array, data_path,
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_ae.py
Original file line number Diff line number Diff line change
Expand Up @@ -153,8 +153,9 @@ def download(date_array, tag, inst_id, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_al.py
Original file line number Diff line number Diff line change
Expand Up @@ -153,8 +153,9 @@ def download(date_array, tag, inst_id, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_ap.py
Original file line number Diff line number Diff line change
Expand Up @@ -228,8 +228,9 @@ def download(date_array, tag, inst_id, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Note
----
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_apo.py
Original file line number Diff line number Diff line change
Expand Up @@ -182,8 +182,9 @@ def download(date_array, tag, inst_id, data_path, update_files=False,
update_files : bool
Re-download data for files that already exist if True (default=False)
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Note
----
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_au.py
Original file line number Diff line number Diff line change
Expand Up @@ -153,8 +153,9 @@ def download(date_array, tag, inst_id, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
6 changes: 5 additions & 1 deletion pysatSpaceWeather/instruments/sw_dst.py
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,11 @@ def download(date_array, tag, inst_id, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
as if they were downloaded
mock_download_dir : str or NoneType
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_f107.py
Original file line number Diff line number Diff line change
Expand Up @@ -375,8 +375,9 @@ def download(date_array, tag, inst_id, data_path, update_files=False,
update_files : bool
Re-download data for files that already exist if True (default=False)
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_flare.py
Original file line number Diff line number Diff line change
Expand Up @@ -327,8 +327,9 @@ def download(date_array, tag, inst_id, data_path, update_files=False,
update_files : bool
Re-download data for files that already exist if True (default=False)
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_hpo.py
Original file line number Diff line number Diff line change
Expand Up @@ -181,8 +181,9 @@ def download(date_array, tag, inst_id, data_path, update_files=False,
update_files : bool
Re-download data for files that already exist if True (default=False)
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Note
----
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_kp.py
Original file line number Diff line number Diff line change
Expand Up @@ -380,8 +380,9 @@ def download(date_array, tag, inst_id, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_mgii.py
Original file line number Diff line number Diff line change
Expand Up @@ -269,8 +269,9 @@ def download(date_array, tag, inst_id, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_polarcap.py
Original file line number Diff line number Diff line change
Expand Up @@ -166,8 +166,9 @@ def download(date_array, tag, inst_id, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_sbfield.py
Original file line number Diff line number Diff line change
Expand Up @@ -241,8 +241,9 @@ def download(date_array, tag, inst_id, data_path, update_files=False,
update_files : bool
Re-download data for files that already exist if True (default=False)
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_ssn.py
Original file line number Diff line number Diff line change
Expand Up @@ -277,8 +277,9 @@ def download(date_array, tag, inst_id, data_path, update_files=False,
update_files : bool
Re-download data for files that already exist if True (default=False)
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down
5 changes: 3 additions & 2 deletions pysatSpaceWeather/instruments/sw_stormprob.py
Original file line number Diff line number Diff line change
Expand Up @@ -167,8 +167,9 @@ def download(date_array, tag, inst_id, data_path, mock_download_dir=None):
data_path : str
Path to data directory.
mock_download_dir : str or NoneType
If not None, will process any files with the correct name and date
as if they were downloaded (default=None)
Local directory with downloaded files or None. If not None, will
process any files with the correct name and date as if they were
downloaded (default=None)
Raises
------
Expand Down

0 comments on commit 3ccc9a2

Please sign in to comment.